官方足球视频 API
快速开始
- 从权限标签页获取访问令牌。
- 调用任一 API 端点，例如：GET
- 解析 JSON 响应。
- 将响应中某个视频的
embedHTML 插入页面，即可显示播放器。对于移动应用，可从嵌入代码中提取视频 URL，并通过 WebView 显示视频。
端点
你可以通过以下端点，以 JSON 格式获取视频嵌入代码：
Free Feed
GETFree Feed 端点可用于获取数量有限的比赛集锦。它包含部分联赛和较早的比赛，可用于预览完整视频 API。
- 仅包含部分联赛和比赛，通常为较早的比赛或精选集锦。
- 返回来自可信来源、可嵌入的官方视频。
- 非常适合测试。
- 不包含付费方案提供的所有赛事或实时更新。
Featured Feed
GET返回经过筛选的相关视频流，包含顶级足球联赛和赛事中近期及重要的比赛。该视频流重点展示最受欢迎、最值得关注的比赛，但不会包含每一场比赛。如需获取特定联赛或球队的全部视频，请使用赛事或球队端点。
- 包含多个联赛近期比赛的精选内容。
- 不会包含所有比赛或赛事，仅展示最相关的内容。
- 所有付费方案均可使用。
赛事
GET你可以使用赛事端点查询任意赛事的视频。该端点会返回指定赛事最新比赛的视频。
例如，以下 URL 会返回英超最近几场比赛的视频。字符串 england-premier-league 是英超的唯一标识符（ID）。
以下是部分热门赛事的 ID：
你可以在此处查看所有赛事的 ID 列表。
球队
GET你可以使用球队端点查询任意球队的视频。该端点会返回指定球队最近比赛的视频。
例如，以下 URL 会返回 Real Madrid 最近几场比赛的视频。字符串 real-madrid 是 Real Madrid 的唯一标识符（ID）。
以下是部分热门球队的 ID：
你可以在此处查看所有球队的 ID 列表。
赛事直播
GET仅返回提供官方赛事直播的比赛，包括正在直播和已经结束的比赛。条目会在开球前约 5 分钟出现。
- 仅显示提供官方可嵌入直播的比赛。
- 包含正在直播和最近结束的比赛（如有，也会提供直播回放）。
- 条目会在预定开球时间前约 5 分钟开始出现。
更新检测端点
GET此端点可用于检测最近更新过的赛事或球队视频流，无需逐一轮询每个端点。
响应结构
响应是一个 JSON 对象，其中包含 response 键，对应值为比赛对象数组。每场比赛都包含基本信息、相关赛事详情和可用视频列表。
JSON{"response": [{"title": "Chelsea - Manchester United","competition": "ENGLAND: Premier League","matchviewUrl": "...","competitionUrl": "...","thumbnail": "...","date": "2029-05-18T15:00:00+0000","homeTeam": {"name": "Chelsea","slug": "chelsea","id": 229},"awayTeam": {"name": "Manchester United","slug": "manchester-united","id": 243},"videos": [{"title": "Highlights","embed": "..."},{"title": "Extended Highlights","embed": "..."}]},...]}response 键包含一个比赛对象数组。每个对象代表一场足球比赛，并包含以下字段：
title– 比赛名称（例如 Chelsea - Manchester United）。competition– 赛事名称（例如 England Premier League）。date– 比赛的开球日期和时间。thumbnail– 比赛缩略图的 URL。videos– 该场比赛所有可用视频的数组。每个视频对象包含：title– 视频标题（例如 Highlights 或 Extended Highlights）。embed– 视频的 HTML 嵌入代码。id– 视频的唯一标识符。
homeTeam/awayTeam– 代表参赛球队的对象，包括：name– 球队全名（例如 Chelsea）。slug– URL 中使用的球队 slug（例如 chelsea）。id– 球队的唯一标识符。
matchviewUrl– 比赛详情小组件页面的 URL，其中包含即时比分、统计数据和排名等详细信息。competitionUrl– 赛事小组件的 URL，显示实时积分榜、比赛结果和即将进行的赛程。
自动播放
在视频 URL 中添加 autoplay=1 参数，即可启用自动播放。
例如：https://www.scorebat.com/embed/v/69a7723c34f88/?...&autoplay=1如果直接使用 embed HTML，可以在 iframe 的 src 中，将 &autoplay=1 追加到视频 URL 后。
配额
每个方案都包含每月请求限额。
- 每次视频观看或小组件展示计为 1 request。
- 每次调用 Video API 都会从每月额度中扣除 5 requests。
例如：
- Starter plan 每月包含 5,000 次请求。
- Standard plan 每月包含 20,000 次请求。
- Advanced plan 每月包含 100,000 次请求。
- 如果需要更高限额，请联系我们了解 Enterprise plans。
如果超出每月请求限额，你的账户会自动切换到 Free plan，直至下一个计费周期。在此期间，小组件和视频中会显示广告及 ScoreBat 标志，并且只能访问 Free Feed 端点。