获取当前板球热门搜索球员列表,返回球员 id、姓名、所属球队名称和头像图片 ID

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

返回出现在热门搜索列表中的板球球员。该接口不需要任何参数。源文档中的 200 示例是一个对象,包含分类标签(示例中为 TRENDING SEARCHES)和 player 数组。每个球员条目包含 id(数字字符串)、name、teamName 和 faceImageId(整数)。其中的 id 就是本产品球员资料、击球统计等球员类接口所接受的 playerId。该接口没有记录过实际探测调用,因此这里描述的所有字段都来自源示例,并未经过独立验证。列表的长度、顺序和内容取决于数据覆盖情况,文档并未说明它们是固定的;示例中至少有一名球员出现了两次(同一个 id 重复出现),所以展示前请先按 id 去重。

API 功能

无需参数的热门列表 只需一次不带参数的 GET 请求就能拿到完整列表,首页组件或定时任务不用先拼查询条件,直接加载即可。
字符串 id 可直接查询 每个条目都带有 id 字符串,可以原样作为 playerId 传给球员资料和击球统计接口,一张焦点球员卡片就能一步跳转到更详细的数据。
每张卡片自带球队名 teamName 与球员姓名一起返回,卡片无需再发第二次请求就能显示所属球队,也方便在球队专题页按球队对列表分组。
球员头像图片引用 faceImageId 是整数形式的图片引用,可以传给本产品的图片接口获取头像,不必自己猜测图片地址。
带分类标签的列表 响应会返回一个分类标签(源示例中为 TRENDING SEARCHES),客户端在渲染栏目标题前可以先确认收到的是哪一类列表。
兼顾重复数据的结构 源示例中同一名球员出现了两次,多名球员还共用同一个 faceImageId,说明应当以 id 作为主键,而不是依赖图片或列表位置。

在线 API 演示

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

使用场景

常见问题

热门球员接口会返回什么?

返回一个分类标签和一个 player 数组。根据源 200 示例,每个球员包含 id(字符串)、name、teamName 和 faceImageId(整数)。该接口没有记录过实际探测调用,所以这些字段都属于源示例字段。

这个接口需要参数吗?

不需要。它是不带路径参数和查询参数的 GET 请求,因此无法筛选或翻页。如果要按球队或赛制缩小范围,需要在拿到响应后自行处理。

这个列表是人气排名或搜索量报告吗?

不是。响应里没有分数、次数或排名值,条目顺序也没有被文档说明为排名。请把它当作数据源当前重点展示的球员列表,例如用作内容选题队列。

为什么示例里同一名球员出现了两次?

源示例中同一个 id 出现了两次,说明响应里可能存在重复项。渲染列表之前请按 id 去重,也不要假设条目数量是固定的。

如何把 id 用于其他球员接口?

把 id 的值作为 playerId 传给球员资料接口或击球统计接口即可。列表以数字字符串形式返回 id,而那些接口把 playerId 声明为数字,所以原样发送这串数字就行。

能把 faceImageId 当作球员唯一标识吗?

不能。源示例中有多名不同的球员共用同一个 faceImageId,所以它标识的是图片而不是人。请用 id 作为球员主键,只在请求头像时使用 faceImageId。

热门球员栏目为空或很短怎么办?

列表取决于当前的数据覆盖情况,文档也没有给出最小条数,所以栏目要能正常处理很短的列表;如果需要查找某个具体姓名,请回退到球员搜索接口。

相关接口

相关指南

查看订阅方案 →