按 live、recent 或 upcoming 三种状态获取板球比赛列表,返回系列赛、球队、场地、状态文字、各局比分和 matchId。

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

通过必填的 `type` 路径参数选择比赛状态视图,可选值为 `live`(进行中)、`recent`(近期已结束,默认值)和 `upcoming`(即将开始),返回对应的板球比赛列表。该接口目前没有记录到探测调用,下文字段来自源响应示例,尚未经过实际验证。示例的顶层是 `typeMatches` 数组,按赛事类别(`matchType`,例如 International、League、Domestic 和 Women)分组,每组包含带有 `matches` 列表的 `seriesMatches`。每个条目都有 `matchInfo` 对象,包含 matchId、seriesId、seriesName、matchDesc、matchFormat、startDate、endDate、state、stateTitle、status、team1 和 team2(各含 teamId、teamName、teamSName),以及 venueInfo(ground、city、timezone);已经产生比分的比赛还会带有 `matchScore`,列出每个局的 runs、wickets 和 overs。日期是以毫秒为单位的纪元时间戳字符串。拿到列表后,可把返回的 matchId 传给比赛详情类接口继续查询。数据取决于当前的赛程,所以某个视图可能没有任何比赛。

API 功能

三种比赛状态视图 只需切换 `type` 路径参数,同一个接口就能在实时、近期和即将开始三种比赛列表之间切换,一个客户端封装即可支撑所有标签页。
按赛事分组的数据结构 比赛嵌套在 typeMatches 和 seriesMatches 之下,界面可以直接渲染 International、League、Domestic 和 Women 等分区,无需重新分组。
球队、场地与赛果文字 每个 matchInfo 都包含两支球队及简称、比赛场地与城市、比赛状态,以及类似胜负差距的可读状态文字。
列表内直接带局比分 已有比分的比赛会通过 matchScore 返回每局的得分、出局数和回合数,比分卡片不必再多发一次请求。
可串联后续查询的 ID 每个条目里的 matchId、seriesId 和球队 ID 可以直接用于比赛详情、系列赛和球队接口,让列表成为按标识符串联流程的入口。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

type 参数可以填哪些值?

文档记载的取值有 `live`、`recent` 和 `upcoming`,默认值为 `recent`。其他取值没有文档说明,建议先在自己的代码里校验后再发起请求。

某个视图会返回空的比赛列表吗?

会。结果取决于请求时刻实际存在的赛程,尤其是 live 视图,在没有比赛进行时可能为空。遇到空的或缺失的 typeMatches 数组时,请给出清晰的空状态提示。

怎样从这个列表进一步获取某场比赛的完整信息?

从 matchInfo 里取出 matchId,传给比赛详情类接口即可,例如用 match-details/get-info 获取比赛基本信息。这个列表只是摘要视图,并不是完整的计分卡。

日期和时间是什么格式?

在源示例中,startDate 和 endDate 是毫秒级纪元时间戳字符串,venueInfo 中带有类似 +09:00 的时区偏移。这一点尚未经过探测调用确认,依赖具体格式之前请先查看一次真实响应。

可以按国家或时区筛选吗?

不可以。该接口只开放 `type` 这一个路径参数。请在自己的代码中把时间戳转换成用户所在时区,并在拿到列表后再按系列赛或球队筛选。

相关接口

相关指南

查看订阅方案 →