获取指定届次的球员拍卖记录

查看 板球数据 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 功能

按届次定位球员记录 将 playerId 与 tournament、year 组合使用,即可请求某位球员在所选届次的拍卖详情。
拍卖价格与结果字段 未经验证的响应示例包含 auctionStatus、auctionPrice 和 basePrice,适合搭建以拍卖结果为核心的球员视图。
逐年收入明细 文档中的 auctionEarnings 数组将每条记录与 year、auctionPrice、球队标识和 trend 关联;历史数据是否完整尚未验证。
球员与球队背景信息 源示例把 role、country、cappedStatus、isPlayerOverseas 与 playsForTeam 及图片标识放在一起,但不会返回图片文件本身。
可选的价格显示格式 通过可选的 currency 参数指定文档所述的价格格式;未知取值只会省略货币符号,并不代表新增了受支持的货币。

在线 API 演示

GET /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&currency=INR&tournament=ipl&year=2026'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

查询拍卖详情所需的 playerId 从哪里获取?

使用拍卖球员列表接口返回的 playerId 字段。playerId 是必填的数字型路径参数,文档示例为 10420。

如何选择赛事和拍卖年份?

将 tournament 设为 ipl 或 wpl,并以字符串形式传入 year。可通过拍卖赛季接口查看可用的届次取值。配置的默认值为 ipl 和 2026;并不保证每一届都有数据。

球员拍卖价格支持哪些货币值?

文档给出的示例为 INR、USD 和 GBP,默认使用 INR。未知取值按文档说明会返回不带货币符号的价格。这并不能说明汇率是否准确或是否及时。

这个查询会包含其他年份拍卖的收入吗?

未经验证的文档示例包含 auctionEarnings 数组(含 year、auctionPrice、球队和 trend 字段),以及 totalEarnings 和 earningsDisclaimer。目前没有针对该接口的探测响应能证实这些历史数据是否可用、是否完整。

球员和球队图片会以图片文件的形式返回吗?

源示例提供的是 playerImageId 和 teamImageId,auctionEarnings 内也有球队图片标识。它们只是标识符,并非内嵌的图片文件,也不保证一定能访问到图片。

相关接口

相关指南

查看订阅方案 →