按姓名在指定届次中搜索拍卖球员

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

使用必填的 plrN 姓名查询参数搜索拍卖参与球员,文档示例为 Kohli。可选的 tournament(ipl 或 wpl)和字符串型 year 用于选定拍卖届次,配置的默认值为 ipl 和 2026。可用的届次取值由拍卖赛季接口给出。匹配规则、分页方式和结果完整性均未说明。未经验证的文档示例返回 auctionPlayersList,以及 auctionTitle、liveBlogId 和 appIndex。示例列表中的每个条目包含 playerId、playerName、playerImageId、country、countryId、role、cappedStatus、season、auctionStatus、auctionPrice、basePrice、playsFor、playsForTeam、teamImageId、totalEarnings、updatedTime、id,以及文本数组 playerIntro。可用返回的 playerId 继续查询拍卖球员详情。该搜索未声明 currency 参数。已保存的探测记录中没有观察到该接口的实际响应;文档示例无法证明哪些字段一定存在,也无法说明没有匹配球员时的行为。

API 功能

按姓名发现拍卖球员 提交必填的 plrN 字符串即可按姓名搜索拍卖参与球员;Kohli 只是文档示例,并不保证一定匹配到结果。
限定赛事的姓名查询 用 ipl 或 wpl 加上年份字符串限定姓名查询的范围,不要把结果当作全局球员库的搜索。
从搜索衔接到详情的标识 未经验证的 auctionPlayersList 示例包含 playerId,可把选中的结果交给独立的拍卖球员详情接口。
辅助区分同名球员的背景信息 示例结果条目带有 playerName、role、country 和 playsForTeam,客户端可在候选姓名旁展示这些背景信息。
拍卖层面的搜索元数据 源示例在候选列表之外还包含 auctionTitle 和 liveBlogId;这些字段是否一定出现,以及对应的博客资源是否存在,均未验证。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

必填的 plrN 查询参数应填什么?

plrN 是要搜索的球员姓名,以字符串形式提交,配置的示例为 Kohli。文档没有说明是否支持模糊匹配、是否区分大小写,也没有给出最短查询长度。

这个搜索会覆盖全局球员库里的所有球员吗?

它是按 tournament 和 year 划定范围的拍卖球员搜索。可选的 tournament 取值为 ipl 和 wpl,默认值为 ipl 和 2026 年。文档未说明该接口是否覆盖全局球员库。

哪个字段能把搜索结果与球员拍卖详情接口关联起来?

未经验证的响应示例在 auctionPlayersList 的每个条目中都包含 playerId。把该 ID 传给拍卖球员详情接口,并保留原来想查询的 tournament 和 year 即可。

按姓名搜索时可以选择价格货币吗?

不可以,该搜索没有声明 currency 查询参数。源示例虽然包含 auctionPrice 和 basePrice,但并未说明它们使用哪种货币。如需明确的货币输入,请改用球员详情或球员列表接口。

没有匹配的拍卖球员时,应用应该如何处理?

已保存的探测响应没有确认该搜索在无匹配时的行为。文档示例包含 auctionPlayersList,但并不保证未匹配的姓名一定返回空数组,也不保证返回特定的错误结构。

相关接口

相关指南

查看订阅方案 →