按球队 ID 获取某支板球队的新闻报道列表

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

按必填的数字路径参数 `teamId`(默认值 2)返回与某一支板球队相关的新闻报道。teamId 取自球队列表接口返回的 `teamId` 字段。该接口不接受其他参数,现有资料也没有说明分页游标。此接口没有留存实际探测记录,下面的响应说明来自一份未经验证、且在 4,000 个字符处被截断的源示例。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)、`lastUpdatedTime` 字符串和 `storyList` 数组;对于默认的 teamId 2,示例里的 seoTitle 写的是印度队。`storyList` 的每个条目要么是 `story` 对象,要么是带有 `layout`、`name`、`position` 的 `ad` 广告位对象,所以客户端需要跳过广告位。单条报道包含 `id`(整数)、`hline`、`seoHeadline`、`intro`、`context`(示例中是访谈标签或巡回赛标签)、`storyType`(例如 Interviews 或 Previews)、`source`、`imageId`、`pubTime`(一串类似 epoch 的数字字符串,单位未说明)、空的 `adsType` 和 `entitlements` 对象,以及带有 `caption`、`id`、`source` 的 `coverImage`。在依赖这些内容之前,请用真实响应确认具体字段、返回的报道数量,以及某支球队没有报道时的表现。

API 功能

按球队筛选的报道流 只需一次 GET 请求并传入路径参数 teamId,就能拿到某一支板球队对应的新闻报道,球队页面可以直接展示这支球队自己的资讯,不必再过滤综合新闻流。
球队 ID 来自球队列表 teamId 就是球队列表接口返回的 teamId 字段值。表单已预填 2,可以立刻发出第一个请求,再换成任意其他球队 id。
按身份而不是文本搜索 按数字球队 id 选择,可以避免把仅仅包含球队名称字样的无关文章也收进来,而用关键词去搜索标题时就会出现这种情况。
访谈和前瞻作为报道类型 示例中的 storyType 字段取值包括 Interviews 和 Previews 等,同一个球队资讯流无需额外请求,就能拆分成访谈、赛前前瞻和战报等标签页。
每条报道带巡回赛或赛制标签 context 字段在示例中写着双边系列赛之类的巡回赛名称,或者 Interview 之类的体裁标签,给每张卡片加上一个简短标签,说明它背后对应的赛程。
封面图说明与来源署名 示例中每条报道的 coverImage 对象都带有 caption、id 和 source 署名,卡片可以在标题旁边显示图片说明和图片来源机构名称。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

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

返回某一支球队的新闻报道。此接口没有实际探测记录,数据结构来自一份被截断且未经验证的源示例:包含 appIndex 对象、lastUpdatedTime 字符串和 storyList 数组,数组条目是报道对象或广告占位对象。

有效的 teamId 从哪里获取?

使用球队列表接口返回的 teamId 字段。默认值 2 是参数说明里提供的示例 id,它对应的示例响应里页面标题写的是印度队,在界面上标注之前,请先在自己的球队响应里核对对应关系。

可以翻页查看某支球队更早的报道吗?

现有资料只记录了 teamId 这一个路径参数,没有分页游标。会返回多少条报道、能否取到更早的报道,需要用真实响应来确认。

为什么 storyList 里有些条目没有报道字段?

在源示例中,部分条目是带有 layout、name、position 的广告对象,而不是报道对象。构建文章卡片时,请跳过没有 story 键的条目。

怎样读取某条报道的全文?

每条报道都带有一个整数 id。把这个 id 传给新闻详情接口即可获取文章正文,因为本接口只返回标题、导语和封面图引用。

返回的报道一定都只与所请求的球队有关吗?

接口的定位是按球队查新闻,但资料没有说明报道是如何与球队匹配的。一条报道可能同时提到多支球队,在把它视为某支球队专属内容之前,请先阅读标题和上下文标签。

哪些响应字段是已验证的?

没有任何字段经过验证。此接口没有探测记录,源示例又在 4,000 个字符处被截断,所以字段名、类型和报道数量在你查看真实响应之前都不能视为已确认。

某支球队没有新闻时会怎样?

资料没有说明。请把缺失或为空的 storyList 当作正常结果处理,因为是否有报道取决于具体球队,界面上显示空状态即可,不要当作错误。

相关接口

相关指南

查看订阅方案 →