按话题 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 功能

按话题筛选的新闻流 只需一次 GET 请求并传入 topicId 路径参数,即可获得归在单个编辑话题下的最新新闻,话题页无需在客户端再去过滤综合新闻索引。
话题 ID 来自话题列表 topicId 就是新闻话题接口返回的 id 值。表单预填了 349,可立即发出第一次请求,也可以换成话题列表中的其他话题 ID。
用 lastId 游标获取后续页面 第一页将 lastId 留空,之后传入已收到的最后一条新闻的 id 即可加载下一页。每次翻页请求中的 topicId 都保持不变。
每条新闻含标题、导语和上下文 源示例中的每条新闻都带有 hline、seoHeadline、intro 和简短的 context 标签,足以在不打开文章的情况下渲染出一张话题卡片。
付费内容提示字段 示例新闻包含带有 name 和 type 的 entitlements 对象,以及新闻上的 planId,界面因此可以为受限新闻打上标记,而不是把每一条都当作可免费阅读。
话题页标题与链接 示例中的 appIndex 对象返回话题新闻页的 seoTitle 与 webURL 字符串,可用作新闻列表旁的标题或参考链接。

在线 API 演示

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

使用场景

常见问题

按话题查询新闻的接口会返回什么?

返回某个话题下的最新新闻。由于没有留存探测记录,响应结构来自一个被截断且未经验证的源示例:包含 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 来源,选择合适的接口。

相关接口

相关指南

查看订阅方案 →