FotMob API

Real-time football (soccer) data — live scores, fixtures, league tables, lineups, shot maps with xG, match momentum, and detailed team & player statistics. Fast, clean JSON.

原始信息汇总

数据集概述：FotMob API

该API提供全面的实时足球（英式足球）数据，通过部署在边缘网络的REST API交付，所有响应均规范化为结构清晰的 JSON 格式。

核心功能与数据亮点

• 实时数据：涵盖比赛、联赛、球队、球员和搜索等数据类别。
• 高级分析：提供通常需要付费才能获得的进阶数据，包括：
  • 射门地图：包含每次射门的球场坐标、预期进球数、射正/被封堵/进球标志、射门情况与身体部位。
  • 比赛势头：每分钟的压力曲线（正值为主场优势，负值为客场优势）。
  • Opta级统计数据：包含控球率、射门、传球及成功率、关键传球、重大机会、对抗、抢断、拦截、传中、长传等详细数据，支持主客队对比。
  • 分组感知的联赛积分榜：为多小组赛事（如世界杯）返回独立、有序的积分榜，并自动计算积分、净胜球和状态列。
  • 统计排行榜：按联赛赛季返回最佳射手、助攻榜及超过60种排名的列表。

数据端点目录

API 共提供 21 个端点，分为以下 5 个类别：

类别	端点 (示例)	功能描述
Matches	GET /matches?date=YYYYMMDD	获取指定日期的所有比赛及比分状态
	GET /matches/{id}	获取完整比赛详情（比分、进球、助攻、红黄牌、换人、阵容、裁判、教练）
	GET /matches/{id}/score	获取精简比分及状态（已开始/已结束）
	GET /matches/{id}/lineups	获取首发阵容及替补，含阵型、球衣号码、国籍
	GET /matches/{id}/momentum	获取每分钟的比赛势头系列数据
	GET /matches/{id}/shotmap	获取每次射门的坐标及xG数据
	GET /matches/{id}/stats	获取主客队的Opta团队统计详细数据
	GET /matches/{id}/table	获取该场比赛所属赛事的积分榜
Leagues	GET /leagues/{id}	获取联赛元数据及当前积分榜
	GET /leagues/{id}/seasons	获取所有可用赛季信息
	GET /leagues/{id}/fixtures	获取当前赛季的全部赛程
	GET /leagues/{id}/top-stats	获取统计领先者（射手、助攻等）
Teams	GET /teams/{id}	获取球队资料（国家、排名、球场、教练、阵容、赛程）
	GET /teams/{id}/squad	获取球员名单（位置、号码、俱乐部）
	GET /teams/{id}/fixtures	获取近期及未来比赛
	GET /teams/{id}/stats	获取赛季总结（评分、零封、红黄牌、进球分解）
Players	GET /players/{id}	获取球员资料（年龄、国籍、身高、惯用脚、位置、现俱乐部、市场价值、统计）
	GET /players/{id}/stats	获取赛季统计摘要（进球、助攻、红黄牌、评分）
Search	GET /search?term=	预输入搜索，匹配球队、球员及比赛

技术与使用规范

• 响应格式：仅返回 JSON，字段命名采用一致的 camelCase 格式。
• 标识符：使用稳定的字符串标识符（matchId, teamId, playerId, leagueId）。
• 空安全：未开始的比赛返回 score: null。
• 缓存机制：响应头包含 Cache-Control 和 X-Cache 以指示数据新鲜度。
• 错误处理：采用统一的错误格式，包含错误代码、消息和请求ID。
• 认证：由 RapidAPI 平台自动处理，无需手动设置密钥。
• 速率限制：由 RapidAPI 在订阅计划层面管理。
• 日期格式：查询日期使用 YYYYMMDD；开球时间返回格式为 DD.MM.YYYY HH:mm。
• 联赛ID：指的是赛事模板ID（如 47 为英超联赛）。

搜集汇总

背景与挑战

背景概述

FotMob API提供实时足球数据，包括实时比分、赛程、排行榜、阵容、射门图与xG、比赛势头以及详细的球队与球员统计数据。它以快速、简洁的JSON格式呈现。