获取正在进行的板球比赛列表,按赛事类型和系列赛分组,包含比赛 ID、球队、场地、状态文字和各局比分(如有)。

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

以一个 JSON 对象返回当前的实时比赛数据。该接口在本页没有输入参数,直接向 /matches/v1/live 发起 GET 请求即可。源接口说明还提到了可选的国家代码和 UTC 偏移请求头,但此处并未开放,因此没有任何按地区或时区调整结果的文档说明。一次探测调用返回了 HTTP 200 和一个 JSON 对象,其中包含:typeMatches,一个分组数组,每组带有 matchType 标签(观察到 International、League、Domestic 和 Women)以及一个 seriesMatches 数组;filters.matchType,列出同样分组标签的数组;appIndex,带有 seoTitle 和 webURL 文本的对象;responseLastUpdated,一个字符串;以及 contentFilters,由 filterId 和 filterName 组成的数组(观察到 liveStream 过滤项)。seriesMatches 中的每个条目要么是 seriesAdWrapper,其中包含 seriesId、seriesName 和 matches 数组(部分包装对象还带有 isLiveStreamEnabled),要么是带有 name、layout 和 position 的占位广告对象,罗列比赛时应跳过后者。每场比赛都有 matchInfo 对象,且在探测到的大多数比赛中还带有 matchScore 对象。matchInfo 包含 matchId、seriesId、seriesName、matchDesc、matchFormat(例如 T20 或 TEST)、state 与 stateTitle(探测值包括 In Progress、Toss、Innings Break、Stumps、Badlight 和 Complete)、status、hideScoreStatus、以毫秒时间戳字符串表示的 startDate 和 endDate、isTimeAnnounced、team1 和 team2(teamId、teamName、teamSName、imageId),以及 venueInfo(id、ground、city、timezone、latitude、longitude);currBatTeamId、isFantasyEnabled 和 livestreamEnabled 只在部分比赛中出现。matchScore 包含 team1Score 和 team2Score,每个里面是 inngs1 之类的局对象,带有 inningsId、runs、wickets 和 overs。以上所有字段都见于探测样本或源示例;但样本只是某一时刻的快照,并非保证不变的接口约定,所以请把可选字段当作可能缺失来处理。返回结果反映请求时刻正在进行的比赛,因此列表可能很短甚至为空,接口也不承诺特定的延迟,或对所有赛事的覆盖。

API 功能

按赛事类型分组的比赛列表 比赛放在 typeMatches 分组中,标签包括 International、League、Domestic 和 Women,filters.matchType 又重复列出这些标签,因此无需硬编码名称就能做出分类标签页。
按系列赛嵌套的实时记录 每个 seriesAdWrapper 都包含 seriesId、seriesName 和 matches 数组,实时页面可以按赛事或巡回赛分块,并在每个区块下展示对应的比赛。
实时状态词汇 state、stateTitle、status 和 hideScoreStatus 反映比赛当前所处的阶段;探测中出现过 In Progress、Toss、Innings Break、Stumps、Badlight 和 Complete,另有自由文本形式的状态说明。
各局比分对象 比赛开始后,matchScore 带有 team1Score 和 team2Score,其中 inngs1 之类的对象包含 inningsId、runs、wickets 和 overs,可直接拼成一行简洁的比分。
快照标记与直播标志 responseLastUpdated 为本次快照打上标记,contentFilters、isLiveStreamEnabled 和 livestreamEnabled 提示哪些实时比赛有直播,比赛卡片可据此显示徽标。

在线 API 演示

GET /api/project/cricbuzz-cricket/matches-live

无需参数,点击查询即可调用 API。

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

实时比赛接口需要传入参数吗?

不需要。本页没有输入参数,直接向 /matches/v1/live 发起 GET 请求即可。源接口说明提到了可选的国家代码和 UTC 偏移请求头,但这里无法配置,所以不要假设会返回按地区或时区调整后的结果。

如何从实时比赛卡片跳转到某一场具体的比赛?

读取目标比赛的 matchInfo.matchId;如果还需要赛事信息,再取 seriesId。它们都是数字型标识,可以在其他比赛级别的请求中复用。

seriesMatches 里除了 matches 还有什么?

探测返回了两种条目:一种是带有 seriesId、seriesName 和 matches 的 seriesAdWrapper,另一种是带有 name、layout 和 position 的占位广告对象。渲染比赛列表时,请跳过没有 seriesAdWrapper 的条目。

为什么有些实时比赛没有 matchScore?

在探测样本中,大多数比赛带有 matchScore,但并非全部。请把 matchScore、currBatTeamId 和各个布尔标志当作可选字段,缺少比分对象时,退回使用 status 或 hideScoreStatus。

startDate 和 endDate 用的是什么时间格式?

它们是以字符串形式返回的毫秒时间戳,转换前请先解析成数字。venueInfo.timezone 给出场地所在地的 UTC 偏移(例如 +09:00),可以用来显示当地开赛时间。

responseLastUpdated 是什么意思?

它是本次快照的字符串时间标记。样本里看起来像以秒为单位的 Unix 时间戳,但其格式没有文档说明,所以在用它判断数据新鲜度之前,请先在自己的响应里确认。

这份列表保证完整或实时吗?

不保证。它只是请求时刻数据源列为进行中的比赛快照,可能很短甚至为空,也不一定包含所有赛事,同时不承诺任何特定延迟。

相关接口

相关指南

查看订阅方案 →