获取指定届次的球员拍卖记录
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →通过拍卖球员列表返回的数字 playerId,查询单个球员的拍卖详情。可选的 tournament 查询参数用于选择 ipl 或 wpl,year 以字符串形式指定拍卖年份,currency 用于选择价格的显示格式。文档中的默认值为 playerId 10420、tournament ipl、year 2026、currency INR。货币示例包括 INR、USD 和 GBP;文档说明,无法识别的货币值会返回不带货币符号的价格。未经验证的文档示例包含 playerId、playerName、playerImageId、country、countryId、role、cappedStatus、isPlayerOverseas、season、auctionStatus、auctionPrice、basePrice、playsFor、playsForTeam、teamImageId、totalEarnings、earningsDisclaimer 和 updatedTime。其中 playerIntro 是文本数组,auctionEarnings 是包含 year、auctionPrice、playsFor、playsForTeam、teamImageId 和 trend 字段的数组。示例中还有 id,以及带 seoTitle 和 webURL 的 appIndex。已保存的探测记录中没有观察到该接口的实际响应,这些示例字段并不能证明字段一定存在,也不能说明历史数据覆盖范围或更新频率。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/auction-get-player API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/auction-get-player?key=<API_KEY>&playerId=10420¤cy=INR&tournament=ipl&year=2026'
查询结果
使用场景
- 制作球员详情抽屉面板,在拍卖记录旁始终显示所选的 playerId、tournament、year 和 currency。
- 分别请求不同届次的拍卖数据,对比同一位球员的表现,并在每条记录上保留届次和价格格式信息。
- 根据文档中的拍卖状态、底价、球队和球员背景字段,整理面向单个球员的编辑资料卡。
- 利用 auctionEarnings 条目渲染收入历史面板,逐条展示年份和球队,并遵循返回的收入免责声明。
常见问题
查询拍卖详情所需的 playerId 从哪里获取?
使用拍卖球员列表接口返回的 playerId 字段。playerId 是必填的数字型路径参数,文档示例为 10420。
如何选择赛事和拍卖年份?
将 tournament 设为 ipl 或 wpl,并以字符串形式传入 year。可通过拍卖赛季接口查看可用的届次取值。配置的默认值为 ipl 和 2026;并不保证每一届都有数据。
球员拍卖价格支持哪些货币值?
文档给出的示例为 INR、USD 和 GBP,默认使用 INR。未知取值按文档说明会返回不带货币符号的价格。这并不能说明汇率是否准确或是否及时。
这个查询会包含其他年份拍卖的收入吗?
未经验证的文档示例包含 auctionEarnings 数组(含 year、auctionPrice、球队和 trend 字段),以及 totalEarnings 和 earningsDisclaimer。目前没有针对该接口的探测响应能证实这些历史数据是否可用、是否完整。
球员和球队图片会以图片文件的形式返回吗?
源示例提供的是 playerImageId 和 teamImageId,auctionEarnings 内也有球队图片标识。它们只是标识符,并非内嵌的图片文件,也不保证一定能访问到图片。