TheStatsAPI

什么是 TheStatsAPI？

TheStatsAPI 是一个面向开发者的足球统计 API，提供对比赛数据、球员和球队统计、赛程/赛果以及投注赔率的程序化访问。它旨在为需要结构化足球数据的应用提供支持，以干净、分页的 JSON 格式从文档化端点返回数据。

该 API 默认覆盖 80 个赛事（可按需扩展至 1,196 个赛事），包含历史数据（覆盖 10 年）和可用实时数据，例如赛中赔率和比赛统计。

主要功能

• 赛程和赛果：检索覆盖赛事的赛程列表和历史赛果。
• 球员和球队统计：访问赛季和职业生涯球员统计（例如进球、助攻、出场、分钟、黄红牌、射门）和球队相关统计。
• 实时和终场比赛统计：使用端点获取比赛统计，包括射门、预期进球 (xG)、控球、传球和逐分钟事件。
• 赔率（赛前和实时）：获取赛前赔率，对于支持的赛程，当 live_odds_available 为 true 时，通过实时端点获取赛中赔率。
• 高级分析：提取预期进球指标及相关底层数据，包括 xG、非点球 xG (npxG)、xA，以及更深入的比赛分析。
• 赛事范围和结构化数据：查询赛事和赛季（通过 matches the competition detail’s current_season_id 选择当前赛季），从 5 个类别（赛事、球队、比赛、球员、赔率）的 19 个端点获取 JSON 响应。

如何使用 TheStatsAPI

1. 启动免费试用，使用交互式演示测试端点（文档显示示例请求和“Run API Call” 流程）。
2. 获取 API 密钥，使用 Authorization: Bearer YOUR_API_KEY 头部进行请求认证。
3. 使用文档化的基础路由 /api/football/*（例如赛事列表或比赛统计）。
4. 请求所需特定资源（赛事、赛季、比赛、球员、赔率），并遵循端点返回的分页参数。

网站显示的示例调用：

• GET /api/football/matches/mt_010249745/stats，带 Bearer 令牌。

使用场景

• 幻想足球应用：使用球员赛季/职业生涯统计和逐场比赛得分数据构建计分和球员选择功能。
• 比赛日计分板：为支持实时数据的赛程显示实时赔率和比赛统计（包括状态和事件驱动更新）。
• 投注分析和回测：结合存档赛前赔率数据、历史赛果和 xG 指标，支持建模和分析。
• 球队和球员表现报告：使用赛季和职业生涯汇总数据（进球、助攻、分钟、黄红牌、射门）加上比赛和事件上下文生成仪表板。
• 编辑或体育数据产品：使用结构化赛程/赛果和分析字段（如 xG 和 npxG）丰富文章或数据源。

常见问题

TheStatsAPI 是否返回实时数据和终场数据？

API 提供 实时和终场比赛统计（射门、xG、控球、传球、黄红牌、进球和逐分钟事件），并包含实时比赛赔率端点（适用于 live_odds_available 为 true 的比赛）。

有多少赛事可用？

网站说明 默认 80 个赛事，可按需扩展至 1,196 个。

端点返回什么格式？

文档指出端点返回 干净、分页的 JSON。

可以查询哪些类型数据？

网站列出 赛事、球队、比赛、球员和赔率 的端点和类别，包括赛程/赛果、球员赛季统计以及赛前/实时赔率。

如何认证请求？

演示中的请求使用 Authorization Bearer 令牌 头部：Authorization: Bearer YOUR_API_KEY。

替代方案

• 带足球 API 的体育数据聚合器：同类替代品通常提供比赛统计和球员/赛程数据作为 JSON，但覆盖范围和实时赔率/赛中数据可用性可能不同。
• 带体育连接器的通用分析/数据平台：这些可能提供更简单的可视化或管道，但提取相同比赛级事件和 xG 字段可能需要额外步骤。
• 专注投注的赔率 API：如果主要需求是赔率（赛前和/或赛中），以赔率为主的 API 可简化访问，但可能不包含广泛的比赛/事件和 xG 分析。
• 无赔率的开放足球数据源：对于无博彩赔率的球队/球员/比赛，开放数据源合适，但 xG 和投注赔率可能需单独来源。