TournamentStats API

Historical match, squad, player, and statistics data for the FIFA World Cup and UEFA European Championship.

原始信息汇总

数据集概述：TournamentStats API

名称： TournamentStats API

核心内容： 提供FIFA世界杯（FIFA World Cup）和UEFA欧洲杯（UEFA European Championship）两个足球赛事的历史数据，涵盖比赛、球队阵容、球员统计等完整信息，并采用统一的数据模型。

数据覆盖范围

• 赛事： 仅包含FIFA世界杯和UEFA欧洲杯两项赛事。
• 数据内容：
  • 每场比赛的比分、场地、淘汰赛结果。
  • 所有届次锦标赛的完整球队阵容，包括球衣号码和队长信息。
  • 球员级统计数据：出场次数、进球、助攻、红黄牌、单场最佳球员奖项（按赛事和整个职业生涯统计）。
  • 比赛裁判和所有国家代表队的主教练。
  • 官方赛事奖项（如金靴奖、金球奖等）。

API 功能与结构

• 统一接口： 所有端点均遵循 /v1/{competition}/... 的URL结构，其中 {competition} 可替换为 world-cup 或 euro，两套赛事共享相同的路径和返回结构。
• 数据格式： 成功请求返回包含 data 键的JSON对象；列表端点额外返回包含 meta.pagination 的分页信息。
• 查询方式：
  • 球队、教练、裁判通过URL友好的名称“slug”进行查询。
  • 球员支持名称搜索（search=参数，不区分重音），存在重名时返回HTTP 300响应及候选列表，可改用数字ID（player_id）查询。
  • 列表端点支持分页参数 ?page= 和 ?per_page=（默认50，最大200）。

端点分类

1. 赛事（Tournaments）： /tournaments、/tournaments/{year} 及嵌套的 /matches、/groups、/squads、/awards。
2. 比赛（Matches）： /matches/{id} 获取单场比赛详情（比分、场地、裁判、球员数据）。
3. 球队（Teams）： /teams、/teams/{team}、/teams/{team}/matches（历史比赛）和 /teams/{team}/head-to-head/{opponent}（两队交锋记录）。
4. 球员（Players）： /players?search=（查找）、/players/{player}（个人资料）、/players/{player}/career（职业生涯总计）、/players/{player}/tournaments/{year}（特定赛事统计）。
5. 排行榜（Leaderboards）： /leaderboards/top-scorers 历史总射手榜。
6. 裁判与教练（Officials and Coaches）： /officials/{official} 和 /coaches/{coach}。

数据说明

• 历史队名： 保留历史时期的球队名称（如“西德”、“苏联”），不会合并到现代国家实体中。
• 球衣号码： 1954年以前的锦标赛，球衣号码反映的是名单顺序而非实际分配的号码。

免责声明

TournamentStats是一个独立项目，与FIFA、UEFA或任何国家足球协会无关，所有数据均来自公开历史记录。