按球队 ID 查询板球球队已完赛的比赛结果,按系列赛分组返回结果状态、对阵双方、场地与各局比分

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

返回某一支板球球队的历史比赛结果。唯一必填的路径参数是 teamId,即数字类型的球队 ID,取自球队列表接口返回的 teamId 字段,默认示例值为 2。根据源响应示例,返回内容包含带有导航信息的 appIndex 对象和 teamMatchesData 数组。结果条目使用 matchDetailsMap,其键为系列赛名称,并带有 match 数组和 seriesId。每场比赛的 matchInfo 包括 matchId、matchDesc、matchFormat、state、status、hideScoreStatus,以毫秒时间戳字符串表示的 startDate 与 endDate,seriesId、seriesName,含 teamId、teamName、teamSName 和 imageId 的 team1 与 team2,以及含 id、ground、city 和 timezone 的 venueInfo;有比分数据时还会带有 matchScore,给出每支球队各局的得分、出局数和回合数。数组中部分条目是广告位,只包含 adDetail 对象而没有比赛数据;示例里一场被放弃的比赛也没有 matchScore。本接口没有记录过实时探测,上述字段均来自未经验证、可能被截断的源示例。文档中也没有分页或日期范围参数。

API 功能

按系列赛分组的赛果 在源示例中,每个 matchDetailsMap 条目都以系列赛名称为键并带有 seriesId,因此赛果标签页可以按巡回赛或锦标赛分段展示。
赛果状态文字 每个 matchInfo 都包含 state、status 和 hideScoreStatus,例如获胜方及优势幅度、因雨放弃比赛的说明,或比赛已结束的提示。
各队各局比分 有比分数据时,matchScore 会返回 team1Score 和 team2Score,包含各局的得分、出局数和回合数,可用来制作紧凑的赛果卡片。
场地与赛制信息 venueInfo 提供球场、城市、场地 ID 和时区,matchInfo 还给出 matchFormat 以及 matchDesc,例如半决赛或带序号的 ODI 场次说明。
用比赛 ID 进入详情页 每条结果都带有 matchId 和双方球队 ID,可以作为键,从球队赛果列表跳转到比赛中心或记分卡页面。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

teams-get-results 接口会返回什么内容?

返回 teamId 所指球队的比赛结果。源示例中的 teamMatchesData 条目按系列赛分组,每个条目带有 matchInfo,并在有数据时附带 matchScore 各局比分。

有效的 teamId 从哪里获取?

使用球队列表接口返回的 teamId 字段。预填的 2 只是默认示例值,该操作的源示例显示它返回的是名为 India 的球队的赛果。

可以按日期、系列赛或页码筛选结果吗?

文档中的输入只有 teamId,没有列出日期范围、系列赛筛选或分页参数,因此不要假设响应覆盖无限长的历史,也不要假设可以翻页获取更多数据。

为什么有些条目是 adDetail 而不是比赛数据?

源示例在各系列赛分组之间穿插了广告位对象。构建赛果列表时,请跳过没有 matchDetailsMap 的条目。

每场结果都会带比分吗?

不一定。源示例中一场因雨放弃的比赛只有状态文字,没有 matchScore,所以请把 matchScore 以及各局数据都当作可选字段处理。

这些字段是否经过实时探测确认?

没有。该操作没有记录过探测调用,字段列表来自可能被截断的源响应示例,依赖这些字段之前,请先用自己的请求验证真实的响应结构。

相关接口

相关指南

查看订阅方案 →