按话题 ID 获取板球最新新闻列表,支持 lastId 翻页
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回归在某一编辑话题下的最新板球新闻。必填的数字型路径参数 `topicId`(默认 349)取自新闻话题接口返回的 `id` 值。可选的数字型查询参数 `lastId` 是翻页游标:留空即加载第一页,若要加载下一页,则传入本接口上一页最后一条新闻的 `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`。示例中,已列出新闻的 entitlements 带有 `name` 和 `type`,有时还有 `teamId` 数组或 `seriesId`,新闻本身也带有 `planId`,这说明部分话题新闻可能属于付费内容。在依赖这些信息之前,请用实际响应确认准确的字段集合、每页条数、翻页行为,以及没有新闻的话题会返回什么。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/news-list-by-topic API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/news-list-by-topic?key=<API_KEY>&topicId=349'
查询结果
使用场景
- 为关注某一编辑主题的读者构建专题新闻合集,只用话题列表中的 topicId 作为唯一的选择条件。
- 记录每一页最后一条新闻的 id 并作为 lastId 发送,以加载更多话题新闻,同时让所选的 topicId 在所有翻页请求中保持不变。
- 对 entitlements 对象不为空的话题新闻显示付费角标,没有限制的新闻则保持可见且不加角标。
- 运行定时采集任务,按话题保存新闻 id 并标记新出现的 id,让邮件通讯能够突出长期持续话题的最新报道。
- 在单个话题内统计各 storyType 的新闻数量,判断该主题以专题特写、人物访谈还是新闻报道为主,再决定主推哪个标签页。
常见问题
按话题查询新闻的接口会返回什么?
返回某个话题下的最新新闻。由于没有留存探测记录,响应结构来自一个被截断且未经验证的源示例:包含 appIndex 对象、lastUpdatedTime 字符串,以及 storyList 数组,数组条目是新闻对象或广告占位对象。
有效的 topicId 从哪里获取?
使用新闻话题接口返回的 id 值。默认值 349 只是参数说明中提供的示例 ID,请先在自己的话题响应中确认它对应哪个话题,再在界面上为它命名。
怎样加载下一页话题新闻?
第一页将 lastId 留空。要获取下一页,把上一次响应中最后一条新闻的 id 作为 lastId 传入,并保持 topicId 不变。现有资料中没有说明每页条数。
不传 lastId 会怎样?
该参数是可选的。根据参数说明,留空时接口会加载该话题的第一页。
为什么 storyList 中有些条目没有新闻字段?
在源示例中,部分条目是带有 layout、name 和 position 的广告对象,而不是新闻对象。渲染或保存文章之前,请先跳过没有 story 键的条目。
所有话题新闻都可以免费阅读吗?
不一定。源示例中的部分新闻带有非空的 entitlements 对象(包含 name、type,有时还有 teamId 或 seriesId)以及 planId,这表明其中有标注为付费的内容。请用实际响应确认你所选话题下受限新闻的呈现方式。
pubTime 是什么,单位是什么?
在源示例中,pubTime 是一串看起来像时间戳的数字字符串,但文档没有说明单位。转换之前,请先拿几个值与已知的发布日期做比对。
它与最新新闻接口或分类接口有什么不同?
本接口按新闻话题列表中的话题 ID 选择新闻。最新新闻接口返回综合新闻流,分类接口则按分类 ID 选择,请根据你想使用的筛选条件对应的 ID 来源,选择合适的接口。