Global-Football-API

Live football scores, fixtures, league tables, match timelines, plus injury and suspension signals derived from real match events.

原始信息汇总

Global-Football-API 数据集概述

基本信息

• 数据集名称：Global-Football-API
• API 分类：Sports
• API 创建者：xeirto
• 订阅用户数：1
• 详情页地址：https://rapidapi.com/xeirto/api/global-football-api1
• 请求地址：https://global-football-api1.p.rapidapi.com
• 认证方式：需在请求头中携带 RapidAPI Key（X-RapidAPI-Key）与 X-RapidAPI-Host（global-football-api1.p.rapidapi.com）

简介

Global-Football-API 提供全球 16 个顶级联赛的实时比分、赛程、赛果、积分榜、俱乐部、阵容以及完整的逐回合比赛时间线数据。所有数据来自其自有规范化数据库而非第三方代理，因此响应结构稳定，延迟不依赖上游提供商。

订阅方案

方案	价格
BASIC	$0.00 / mo
PRO	$15.00 / mo
ULTRA	$45.00 / mo
MEGA	$150.00 / mo

覆盖范围（16 个顶级联赛）

Slug	联赛	国家
eng.1	Premier League	英格兰
esp.1	LALIGA	西班牙
ger.1	Bundesliga	德国
ita.1	Serie A	意大利
fra.1	Ligue 1	法国
ned.1	Eredivisie	荷兰
por.1	Primeira Liga	葡萄牙
sco.1	Premiership	苏格兰
bel.1	Pro League	比利时
tur.1	Süper Lig	土耳其
usa.1	MLS	美国
mex.1	Liga BBVA MX	墨西哥
arg.1	Liga Profesional	阿根廷
bra.1	Brasileirão	巴西
ksa.1	Saudi Pro League	沙特阿拉伯
jpn.1	J.League	日本

数据内容

• 实时比分：比赛状态、比分、时钟与阶段，比赛进行中每 20 秒刷新。
• 比赛时间线：进球、助攻、乌龙球、点球、黄牌与红牌、换人，均含精确到分钟的时钟及相关球员；可按 important=true 过滤仅重要事件，或查看每场 1,000+ 回合的完整时间线。
• 阵容：首发与替补名单，含球衣号码与位置。
• 积分榜：完整联赛积分表，含场次、胜、平、负、净胜球与积分。
• 俱乐部：每个联赛每支球队的身份、队徽、主场与城市信息。

接口端点

方法	端点	说明
GET	/get/soccer/leagues	发现赛事及其 slug
GET	/get/soccer/{league}/scoreboard	某日比赛
GET	/get/soccer/{league}/fixtures	赛程与赛果
GET	/get/soccer/{league}/standings	积分榜
GET	/get/soccer/{league}/events/{eventId}	比赛详情
GET	/get/soccer/{league}/events/{eventId}/plays	逐回合时间线
GET	/get/soccer/{league}/clubs	联赛俱乐部列表
GET	/get/soccer/{league}/clubs/{clubId}	单支俱乐部详情
GET	/get/soccer/{league}/summary	联赛概要
GET	/get/soccer/meta	当前存储数据及最后同步时间

关键参数

• /get/soccer/leagues：kind（club、international）、available（true 仅返回已存储数据的联赛）。
• /get/soccer/{league}/scoreboard：dates（YYYYMMDD，默认今天 UTC）。
• /get/soccer/{league}/fixtures：from、to（YYYYMMDD，均可选）、status（all 默认、scheduled、live、finished）、page（1+）、limit（1–200，默认 100）。
• /get/soccer/{league}/standings：season（如 2026）。含分组的联赛（MLS、Argentina）每组返回一条记录。
• /get/soccer/{league}/events/{eventId}：fields 可裁剪响应，有效区块为 header、boxscore、keyEvents、rosters、gameInfo、commentary、broadcasts、odds、leaders、news、videos、format、meta；未知区块返回 400 并列出有效名称。
• /get/soccer/{league}/events/{eventId}/plays：important=true 仅返回进球、牌与换人；limit。

响应体积示例

请求	压缩后大小
完整概要	17.5 KB
?fields=header,keyEvents	2.0 KB
?fields=keyEvents	0.7 KB

典型工作流

1. GET /get/soccer/leagues — 选择 slug
2. GET /get/soccer/{slug}/scoreboard — 当日比赛，获取 id
3. GET /get/soccer/{slug}/events/{id}?fields=header,keyEvents — 比分与射手
4. GET /get/soccer/{slug}/events/{id}/plays?important=true — 时间线

响应约定

• 标识符始终为字符串，绝不为数字。
• 日期为 ISO 8601 UTC；dates 查询参数为 YYYYMMDD。
• 比赛状态为 pre、in、post 之一。
• 所有响应均为 gzip 编码。
• 缺失数据以 null 或空数组返回，数值绝不编造。
• 数据为存储快照，不保证实时。

错误码

代码	含义
400	无效的日期、状态、分页、布尔值或 fields 值
401	缺少或无效的 RapidAPI Key
404	未知联赛 slug 或比赛 id
429	超出方案配额或速率限制

路径中含字面量 league 时的 404 表示 {league} 占位符未替换为真实 slug（如 eng.1）。

注意事项

• 数据为存储快照，不保证实时；不得用于博彩、下注或任何延迟/不准确数据可能导致损失的用途。
• 俱乐部与赛事名称及标识归各自所有者所有，与任何联赛、俱乐部或管理机构无关联。

搜集汇总

背景与挑战

背景概述

Global-Football-API是一个快速可靠的足球数据接口，能够提供实时比分、赛程、比赛结果、联赛排名、球队与球员信息，以及赛事实时动态。