按 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 功能

按单场比赛查询视频 传入一个 matchId 就能拿到与该场比赛绑定的视频条目,比赛详情页可以只加载本场的分析和预览片段,不必在全站视频流里再去检索。
标签关联系列赛、球队和球员 每个条目都带有由 itemId、itemName、itemType 组成的 tags 数组,示例中出现 series、match、team 和 player 类型,方便把视频跳转链接到你自己产品里的相关页面。
视频类型筛选 可选的 videoType 参数按返回视频的 videoType 字段过滤,例如 Analysis 或 Match Forecast;留空则返回全部类型。
基于 commTimestamp 的游标翻页 首页不传 timestamp,翻页时把上一次响应最后一条视频的 commTimestamp 传进去即可加载下一页,无需自己计算偏移量。
标题、语言与封面图引用 条目提供 headline、language、imageId 和 videoUrl 链接,足够在比赛页的内容栏里画出带文字和缩略图的卡片列表。
每条视频的分类标签 category 数组由 id、imageID 和 name 对象组成,用来给视频归类,例如归入 Press Conference,编辑后台可据此按内容类型分组。
明确的空结果响应 文档记录了返回空对象的 204 响应,比如按 videoType 筛选后没有结果的情形,因此没有视频是一种正常状态,而不是错误。

在线 API 演示

GET /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 从哪里获取?

使用本产品中比赛列表、比赛赛程、系列赛比赛、球队赛程、球队赛果或场地比赛等接口返回的 matchId。默认值 151543 只是示例,而且该接口没有记录过实际探测调用。

如何加载下一页视频?

首页请求不要传 timestamp。要翻到下一页,把上一次响应里最后一条视频的 commTimestamp 作为 timestamp 传入。示例中 commTimestamp 是字符串,而 timestamp 参数的类型是数字。

这里返回 204 是什么意思?

源文档记录了一个返回空对象的 204 响应,例如请求的 videoType 下没有任何视频时就会出现。请把它当作该比赛和该筛选条件下的空状态,而不是失败。

multilangEnabled 会改变什么?

源说明提到原版应用始终传 true,且测试中没有看到明显效果。请保持默认值,不要指望它能切换返回视频的语言。

哪些响应字段是经过确认的?

没有任何字段经过实际探测确认。字段列表来自源 200 示例,而所提供的证据里该示例只截取了前几个条目。其中的条目包含 headline、videoType、language、videoUrl、tags 和 category,可选字段可能因比赛而异。

可以下载或转发 videoUrl 里的视频吗?

响应提供的是 videoUrl 和 appLinkUrl 这类链接字段。所提供的文档没有授予下载、嵌入或再分发的权利,因此在展示或存储这些内容之前,请先确认你拥有相应的内容权利。

相关接口

相关指南

查看订阅方案 →