按球员 ID 获取该球员相关的板球新闻

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

返回与单个球员相关的新闻列表,球员由必填的数字路径参数 `playerId` 指定(默认值 8733)。`playerId` 请取自热门球员或球员搜索接口返回的 `id` 字段。该接口不接受其他参数,因此现有资料中没有记录任何翻页游标。该接口没有记录到实际探测结果,响应说明来自一份在 4,000 字符处被截断、尚未验证的示例。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)、`lastUpdatedTime` 字符串和 `storyList` 数组。`storyList` 的每个条目要么是 `story` 对象,要么是带有 `layout`、`name`、`position` 的 `ad` 对象,因此客户端需要跳过广告位。一条新闻包含 `id`(整数)、`hline`、`seoHeadline`、`intro`、`context`(示例中为巡回赛或系列赛标签)、`storyType`、`source`、`imageId`、`pubTime`(类似时间戳的数字字符串,单位未说明)、为空的 `adsType` 与 `entitlements` 对象,以及带有 `caption`、`id`、`source` 的 `coverImage`。在正式依赖之前,请用真实响应核对确切的字段集合、返回的新闻条数,以及球员没有相关报道时的表现。

API 功能

按 playerId 获取球员专属新闻 用 playerId 路径参数发起一次 GET 请求,就能拿到与该球员相关的新闻,球员页不必再去综合资讯流里按姓名逐条匹配。
与球员页共用同一个 ID playerId 就是热门球员和球员搜索接口返回的 id 值,也是你在资料页和统计页中已在使用的标识符,所以新闻标签页不需要额外的映射。
用数字 ID 避开重名歧义 按数字 id 选择球员,可以避免文本搜索带来的歧义,因为多位球员可能同姓或使用相同的缩写。
每条新闻附带赛事背景 来源示例中每条新闻都有 hline、intro、context 和 storyType,其中 context 可以展示巡回赛或系列赛,storyType 可以展示文章类型,比如比赛专题。
新闻与广告混排的条目 示例中的 storyList 把 story 对象与带 layout、name、position 的 ad 对象交错排列。按 story 键过滤,就能得到干净的文章列表。
卡片可用的封面图引用 示例中的每条新闻都带有 imageId 和包含 caption、id、source 的 coverImage 对象,可以为每张卡片配上缩略图和图注。

在线 API 演示

GET /api/project/cricbuzz-cricket/players-get-news

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/players-get-news?key=<API_KEY>&playerId=8733'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

球员新闻接口会返回什么?

它返回某位球员的相关新闻。由于没有记录实际探测,数据结构来自一份被截断且未验证的来源示例:一个 appIndex 对象、一个 lastUpdatedTime 字符串,以及一个 storyList 数组,数组中的条目是新闻对象或广告占位。

有效的 playerId 从哪里获取?

使用热门球员或球员搜索接口返回的 id 字段。默认值 8733 只是参数说明中提供的示例 id。按 id 查询可以避免凭球员姓名去猜。

可以翻页读取该球员更早的新闻吗?

现有资料显示 playerId 是唯一参数,所以这个接口没有记录 lastId 之类的翻页游标。请自行查看响应返回了多少条新闻,不要默认它提供完整的历史存档。

为什么有些 storyList 条目没有新闻字段?

在来源示例中,有些条目是带 layout、name、position 的 ad 对象,而不是 story 对象。构建列表时请跳过它们。目前尚未通过探测确认每次响应是否都会出现广告条目。

如何读取某条新闻的全文?

这个接口只返回列表卡片:标题、导语、赛事标签、新闻类型、来源和封面图引用。把新闻的整数 id 作为 newsId 传给新闻详情接口,才能获得文章正文。

返回的新闻一定只和该球员有关吗?

接口的定位是按球员获取新闻,但现有资料没有说明新闻是如何与球员匹配的。像比赛专题这类报道可能同时提到该球员和其他人,请结合自己响应里的标题和赛事标签进行判断。

哪些响应字段已经验证过?

没有任何字段通过该接口的实际探测得到确认。这里提到的 hline、intro、context、storyType、pubTime、coverImage 等字段都来自一份在 4,000 字符处被截断的来源示例,请与你自己的响应对照核实。

球员没有相关新闻时会怎样?

覆盖情况因球员而异,所以未知的 playerId 或没有报道的球员可能返回空的或内容稀少的响应体。现有资料没有展示这种情况,请在客户端做好容错处理。

相关接口

相关指南

查看订阅方案 →