按已完成、即将进行或进行中状态列出拍卖球员

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

按必填的 status 获取拍卖球员列表:completed 表示拍卖结果,包括已成交、流拍、保留和 RTM;upcoming 表示尚未上拍的球员;live 表示当前拍卖状态及编辑推荐。配置的 status 为 completed,tournament 为 ipl,year 为字符串 2026,currency 为 INR。可选筛选条件有 cap(Capped 或 Uncapped)、countryId、role(Batter、Bowler、Allrounder 或 WK-Batter)和 teamId。排序可使用响应中提供的排序 ID(sort),也可使用同一排序选项中的 sortField 搭配 sortDirection(ASC 或 DESC)。获取第一页时请不要设置 timestamp;翻到下一页时,把上一页最后一位球员的 updatedTime 作为数字型 timestamp 参数传入。文档未说明 timestamp 的单位,也没有页大小参数。被截断且未经验证的文档示例包含带 seoTitle 和 webURL 的 appIndex,以及 auctionPlayersList 数组。可见的球员字段有 playerId、playerName、playerImageId、role、country、countryId、cappedStatus、season、auctionStatus、auctionPrice、basePrice、playsFor、playsForTeam、teamImageId、totalEarnings、updatedTime、id,以及文本数组 playerIntro。摘录中部分条目还含有 editorPickLabel、isEditorPick、isPlayerOverseas、twitterArticleId 和 videoAnalysisId,这些字段并不一定对所有条目都存在。参数文档还提到 filters、filter.team、sortFilter.sort[].id 以及带 value1/value2 的 sort.options,作为输入取值的发现来源。已保存的探测记录中没有观察到该接口的实际响应,被截断的示例也无法确认列表是否完整、各个 status 下的响应结构,或实时更新的频率。

API 功能

三种拍卖状态视图 completed 查看拍卖结果,upcoming 查看等待上拍的球员,live 查看当前拍卖状态以及文档所述的编辑推荐信息。
按资历与角色缩小范围 用 Capped 或 Uncapped,加上文档列出的角色之一(Batter、Bowler、Allrounder 或 WK-Batter),快速筛出球员名单。
从响应中获取国家与球队筛选值 countryId 和 teamId 应取自文档所述的响应筛选元数据,不要假定存在一套固定通用的国家或球队标识。
两种配对的排序方式 可选择文档给出的排序 ID,或把响应选项中的 value1 与 value2 分别用作 sortField 和 sortDirection;两种方式同时提供时的优先级未作说明。
基于末位球员的续取参数 首页不要传 timestamp,续取时使用上一页最后一位球员的 updatedTime,并保持所选状态和届次不变,而不是自行编造页码。
支持货币格式的结果浏览 浏览 IPL 或 WPL 某一届名单时,可设置 currency 来控制价格显示格式;默认是 INR,USD 和 GBP 为文档给出的示例。

在线 API 演示

GET /api/project/cricbuzz-cricket/auction-list-players

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/auction-list-players?key=<API_KEY>&status=completed&currency=INR&tournament=ipl&year=2026'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

球员列表中的 completed、upcoming 和 live 分别是什么意思?

completed 请求拍卖结果,包括已成交、流拍、保留和 RTM 结果;upcoming 请求尚未上拍的球员;live 请求当前拍卖状态及编辑推荐。已保存的探测响应没有验证这些视图当前的内容或更新频率。

可以使用哪些角色和资历筛选条件?

cap 接受 Capped 或 Uncapped;role 接受 Batter、Bowler、Allrounder 或 WK-Batter。两者都是可选的字符串型查询参数,不传即表示不设置对应的筛选。

countryId 和 teamId 的筛选值应从哪里获取?

参数文档指出,countryId 对应响应中的 filters,teamId 对应响应中的 filter.team。文档以 countryId 4 代表澳大利亚、teamId 58 代表 CSK 作为示例,但这些并不是完整的标识列表。

该如何选择排序方式?

可将 sort 设为 sortFilter.sort[].id 中记录的排序 ID;也可以把 sortField 设为某个 sort.options 条目的 value1,并把 sortDirection 设为同一条目的 value2(ASC 或 DESC)。如果两种方式同时发送,文档没有说明优先级。

如何请求拍卖球员列表的下一页?

获取第一页时让 timestamp 留空;续取时,把上一页最后一位球员的 updatedTime 作为 timestamp 传入。timestamp 的声明类型是数字,但其时间单位和页大小均未记录,也没有页码输入。

tournament、year 和 currency 会如何影响这份列表?

tournament 用于选择 ipl 或 wpl,year 是字符串形式的拍卖年份,currency 控制文档所述的价格显示格式。配置的默认值为 ipl、2026 和 INR。可通过拍卖赛季接口查看可用届次。INR、USD 和 GBP 是货币示例;按文档说明,未知的货币值会省略货币符号。

编辑推荐和视频相关字段对每位球员都一定存在吗?

不一定。被截断的源示例只在部分条目中包含 editorPickLabel、isEditorPick、twitterArticleId 和 videoAnalysisId,目前没有针对该接口的探测结果确认这些字段是否可用。有了标识符,并不意味着能获得视频文件或内容使用权。

相关接口

相关指南

查看订阅方案 →