Football Stats API – Live Scores, xG, Odds & Player Data

Real-time football data API with match stats, player stats, xG, pre-match & live odds, fixtures, and historical data across 1,196 competitions.

原始信息汇总

数据集概述：Football Stats API – Live Scores, xG, Odds & Player Data

该数据集提供的是一个专业级、覆盖面广的足球数据 REST API，旨在为开发者提供结构化的 JSON 格式数据。API 由 TheStatsApi 创建，在 RapidAPI 平台上发布。

核心数据内容

• 实时与历史比赛数据：包括实时比分、赛程、结果以及比赛事件（进球、红黄牌等）。
• 详细比赛统计：提供控球率、射门数、传球数、角球、犯规等数据，并支持上半场和下半场的分段统计。
• 球员与球队数据：
  • 球员数据：包含球员的赛季和职业生涯统计数据（进球、助攻、出场次数等），以及详细的比赛级球员表现数据（分组为传球、射门、防守和综合类）。
  • 球队数据：提供球队赛季级表现统计（胜平负、积分、排名等）和球队阵容信息。
• 高级分析数据：提供预期进球（xG）和非点球预期进球（npxG）等高级分析指标。
• 博彩赔率：提供赛前和实时滚球赔率，覆盖赔率市场包括胜平负（1X2）、双方进球（BTTS）、总进球数、角球和亚洲盘口。数据包含开盘价和最新价。
• 比赛射门地图：包含每次射门的详细信息（xG值、射门部位、射门情况、场上坐标、守门员是否参与等）。
• 比赛参与者：包含裁判的职业生涯统计数据。

覆盖范围

• 赛事数量：默认覆盖 80 项赛事，按需可扩展至 1,196 项。
• 球员数量：超过 84,000 名球员。
• 国家/地区：覆盖 100 多个国家/地区。
• 历史数据跨度：提供长达 10 年的历史数据。
• 包含的顶级赛事：英超、西甲、意甲、德甲、法甲、欧冠、美国职业足球大联盟等。

API 特点与使用方式

• 资源ID格式：使用稳定、带前缀的字符串ID（如比赛为 mt_），便于跨端点关联数据。
• 分页机制：列表端点支持 page 和 per_page 参数，返回结果包含 meta 对象，内含分页信息。
• 响应格式：
  • 列表端点返回 { data, meta } 结构。
  • 详情端点返回 { data } 结构。
  • 可选或不可用的字段返回 null。
• 错误格式：所有错误遵循 { error: { code, message, status_code } } 格式。
• 认证方式：通过 RapidAPI 平台进行认证和调用，使用 RapidAPI 的请求头和密钥。

主要端点类别

• Competitions：获取赛事列表、详情及赛季信息。
• Teams：获取球队信息、阵容及赛季统计数据。
• Matches：获取比赛列表、详情、统计数据、实时统计数据、球员比赛统计和射门地图。
• Players：搜索球员、获取球员个人资料及赛季统计数据。
• Odds：获取比赛的赛前赔率和实时滚球赔率。