获取当前板球热门搜索球员列表,返回球员 id、姓名、所属球队名称和头像图片 ID
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回出现在热门搜索列表中的板球球员。该接口不需要任何参数。源文档中的 200 示例是一个对象,包含分类标签(示例中为 TRENDING SEARCHES)和 player 数组。每个球员条目包含 id(数字字符串)、name、teamName 和 faceImageId(整数)。其中的 id 就是本产品球员资料、击球统计等球员类接口所接受的 playerId。该接口没有记录过实际探测调用,因此这里描述的所有字段都来自源示例,并未经过独立验证。列表的长度、顺序和内容取决于数据覆盖情况,文档并未说明它们是固定的;示例中至少有一名球员出现了两次(同一个 id 重复出现),所以展示前请先按 id 去重。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/players-list-trending 无需参数,点击查询即可调用 API。
API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/players-list-trending?key=<API_KEY>'
查询结果
使用场景
- 搭建热门球员发现条:展示姓名、teamName 和头像,每张卡片按 id 链接到球员资料接口。
- 把列表中的球员导入编辑选题队列并保存各自的 id,让编辑可以在同一处打开每位球员的资料、击球统计和相关新闻。
- 在用户输入之前,用热门球员填充搜索框的推荐面板;当用户要找的人不在列表里时,再切换到球员搜索接口。
- 按 teamName 分组,在国家队或俱乐部专题页展示“焦点球员”板块,并将其标注为编辑精选列表而不是排名。
- 定时拉取列表,并与上一次快照比较 id,找出新上榜的球员,用于安排内容日历。
常见问题
热门球员接口会返回什么?
返回一个分类标签和一个 player 数组。根据源 200 示例,每个球员包含 id(字符串)、name、teamName 和 faceImageId(整数)。该接口没有记录过实际探测调用,所以这些字段都属于源示例字段。
这个接口需要参数吗?
不需要。它是不带路径参数和查询参数的 GET 请求,因此无法筛选或翻页。如果要按球队或赛制缩小范围,需要在拿到响应后自行处理。
这个列表是人气排名或搜索量报告吗?
不是。响应里没有分数、次数或排名值,条目顺序也没有被文档说明为排名。请把它当作数据源当前重点展示的球员列表,例如用作内容选题队列。
为什么示例里同一名球员出现了两次?
源示例中同一个 id 出现了两次,说明响应里可能存在重复项。渲染列表之前请按 id 去重,也不要假设条目数量是固定的。
如何把 id 用于其他球员接口?
把 id 的值作为 playerId 传给球员资料接口或击球统计接口即可。列表以数字字符串形式返回 id,而那些接口把 playerId 声明为数字,所以原样发送这串数字就行。
能把 faceImageId 当作球员唯一标识吗?
不能。源示例中有多名不同的球员共用同一个 faceImageId,所以它标识的是图片而不是人。请用 id 作为球员主键,只在请求头像时使用 faceImageId。
热门球员栏目为空或很短怎么办?
列表取决于当前的数据覆盖情况,文档也没有给出最小条数,所以栏目要能正常处理很短的列表;如果需要查找某个具体姓名,请回退到球员搜索接口。