按 matchId 获取一场板球比赛的分析、赛前预览和比赛预测视频列表,支持 videoType 筛选与 timestamp 翻页。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回与某一场板球比赛相关的视频条目。matchId 为必填数字,请使用本产品中比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId。另有三个可选查询参数。timestamp 是翻页游标:首次请求留空,翻到下一页时传入上一次响应中最后一条视频的 commTimestamp。videoType 用于按返回视频的 videoType 字段筛选(例如 Analysis 或 Match Forecast),留空表示全部类型;没有对应视频的类型会返回 204。multilangEnabled 是布尔值,源说明提到原版应用始终传 true,且测试中没有看到明显效果。源 200 示例是一个 videoList 数组,每个条目包含 headline、videoId(数字)、itemId 和 mappingId(字符串)、videoType、language、imageId、commTimestamp(字符串)、videoUrl、appLinkUrl、adTag 和 infraType,还有由 id、imageID、name 组成的 category 数组,由 itemId、itemName、itemType 组成的 tags 数组(示例中出现 series、match、team 和 player 四种类型),以及在示例中为空对象的 freeMinuteBeginMessage 和 freeMinuteExpiredMessage。文档同时给出了返回空对象的 204 示例。该接口没有记录过实际探测调用,且所提供的 200 示例只截取了前几个条目,因此所有字段都来自源示例,可选字段是否出现取决于赛事覆盖情况。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/videos-list-by-match API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/videos-list-by-match?key=<API_KEY>&matchId=151543&multilangEnabled=true'
查询结果
使用场景
- 在比赛详情页加入分析与预览视频栏,按 matchId 列出每条视频的标题,并用 imageId 显示缩略图。
- 搭建赛前内容栏:先请求 videoType 为 Match Forecast 的视频,遇到 204 时再退回不带筛选条件的请求。
- 遇到重点比赛视频很多时,把最后一条视频的 commTimestamp 填入 timestamp 参数,逐页加载完整的视频流。
- 读取 tags 中 itemType 为 player 或 team 的条目,把每条视频链接到相关球员页和球队页。
- 按 category 的 name(例如 Press Conference)给某场比赛的视频库分组,用于编辑看板或内容盘点。
- 对赛程里的每个 matchId 逐一调用并统计 204 响应的数量,查出哪些比赛有视频覆盖、哪些没有。
常见问题
这个接口的 matchId 从哪里获取?
使用本产品中比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId。默认值 151543 只是示例,而且该接口没有记录过实际探测调用。
如何加载下一页视频?
首页请求不要传 timestamp。要翻到下一页,把上一次响应里最后一条视频的 commTimestamp 作为 timestamp 传入。示例中 commTimestamp 是字符串,而 timestamp 参数的类型是数字。
这里返回 204 是什么意思?
源文档记录了一个返回空对象的 204 响应,例如请求的 videoType 下没有任何视频时就会出现。请把它当作该比赛和该筛选条件下的空状态,而不是失败。
multilangEnabled 会改变什么?
源说明提到原版应用始终传 true,且测试中没有看到明显效果。请保持默认值,不要指望它能切换返回视频的语言。
哪些响应字段是经过确认的?
没有任何字段经过实际探测确认。字段列表来自源 200 示例,而所提供的证据里该示例只截取了前几个条目。其中的条目包含 headline、videoType、language、videoUrl、tags 和 category,可选字段可能因比赛而异。
可以下载或转发 videoUrl 里的视频吗?
响应提供的是 videoUrl 和 appLinkUrl 这类链接字段。所提供的文档没有授予下载、嵌入或再分发的权利,因此在展示或存储这些内容之前,请先确认你拥有相应的内容权利。