按已完成、即将进行或进行中状态列出拍卖球员
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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¤cy=INR&tournament=ipl&year=2026'
查询结果
使用场景
- 分别搭建已完成结果、待拍球员池和实时拍卖三个标签页,让每种状态保持各自的含义,不要混在一起。
- 在同一届拍卖内,结合资历状态、角色、国家和球队筛选条件,生成球探或招募研究用的候选名单。
- 用返回的成交、流拍、保留和 RTM 结果填充已完成拍卖的复盘表格,同时避免把待拍球员当作最终结果展示。
- 实现拍卖表格的加载更多功能:保留最后一位返回球员的 updatedTime,并为下一次请求沿用相同的筛选与排序选择。
- 仅当返回条目确实带有文档所述的推荐字段时,才在实时拍卖名单中显示编辑推荐标注。
常见问题
球员列表中的 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,目前没有针对该接口的探测结果确认这些字段是否可用。有了标识符,并不意味着能获得视频文件或内容使用权。