按分类获取最新板球新闻列表

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

返回单个新闻分类下的最新新闻列表,分类由必填的数字路径参数 `categoryId` 指定(默认值 5)。`categoryId` 请取自新闻分类接口返回的 `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`。在正式依赖之前,请用真实响应核对确切的字段集合、每页条数,以及某个分类下没有新闻时的表现。

API 功能

按分类筛选的头条流 用 categoryId 路径参数发起一次 GET 请求,即可拿到单个新闻分类下的最新新闻,栏目页无需在客户端按标签再去过滤综合资讯流。
分类 ID 来自分类列表接口 categoryId 就是新闻分类接口返回的 id 值。表单已预填 5,可以先发出第一次请求,再换成其他分类的 id。
以新闻 ID 作为翻页游标 可选参数 lastId 接收你收到的最后一条新闻的 id。第一页保持留空,之后传入该 id,就能沿着同一分类的列表继续往下读。
每条新闻自带编辑标签 根据来源示例,每条新闻都带有 hline、seoHeadline、intro、context 和 storyType,足以渲染标题、一行导语以及赛事或系列赛标签,无需再发第二次请求。
需要过滤的原生广告条目 示例中的 storyList 把 story 对象与带 layout、name、position 的 ad 对象混在一起。识别 ad 键并跳过这些条目,就能得到干净的文章列表。
新闻 ID 可直接衔接文章详情 每条新闻的整数 id 正是新闻详情接口所需的 newsId,列表页只需再追加一次调用就能打开完整文章。

在线 API 演示

GET /api/project/cricbuzz-cricket/news-list-by-category

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

按分类获取新闻的接口会返回什么?

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

有效的 categoryId 从哪里获取?

使用新闻分类接口返回的 id 字段。默认值 5 只是参数说明中提供的示例 id,在界面上给它命名之前,请先在你自己的分类响应里确认它对应哪个栏目。

如何加载下一页新闻?

第一次调用时让 lastId 留空。要加载下一页,把上一次响应 storyList 中最后一条新闻的 id 作为 lastId 传入。现有资料没有说明每页条数,请自行读取响应中的数组长度。

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

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

lastId 是必填参数吗?

不是。只有 categoryId 是必填的。lastId 为可选参数,仅在首次请求之后用于翻页。

列表里包含文章全文吗?

不包含。示例中的新闻对象只有标题、导语、赛事标签、新闻类型、来源和封面图引用。要阅读正文,请把新闻的 id 作为 newsId 传给新闻详情接口。

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

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

分类为空或分类不存在时会怎样?

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

相关接口

相关指南

查看订阅方案 →