Zafronix FIFA World Cup API

Complete FIFA World Cup data — all 24 tournaments (1930–2026), live scores, squads, standings, brackets. Free tier included.

原始信息汇总

数据集概述：Zafronix FIFA World Cup API

这是一个提供完整 FIFA 世界杯历史数据与实时数据的 REST API，覆盖 1930 年至 2026 年 的所有 24 届赛事。

核心数据内容

• 球员级数据：超过 2,500 名球员的详细信息（出生日期、场上位置、所属俱乐部、每届赛事统计）。
• 赛事数据：每届赛事的完整信息，包括球队阵容、淘汰赛赛程、小组排名、体育场数据、冠军及获奖名单。
• 历史匹配：1,068 场比赛的详细结果与数据。
• 场馆数据：206 个场馆的详细信息。
• 精选冷知识：经过整理的赛事趣闻与事实。

技术规格

• 基础 URL：https://api.zafronix.com/fifa/worldcup/v1
• 数据格式：JSON（UTF-8 编码）
• 认证方式：通过 X-API-Key 请求头进行认证。
• 版本控制：采用 URL 版本控制（如 /v1, /v2）。

主要端点（v1）

方法	路径	描述
GET	/v1	返回 API 版本和构建信息。
GET	/v1/health	检查 API 运行状态（公开端点）。
GET	/v1/tournaments	列出所有赛事（年、主办国、冠军）（公开端点）。
GET	/v1/tournaments/:year	获取指定年份赛事的完整数据（球队、淘汰赛、阵容、奖项）。
GET	/v1/teams	查询某届赛事的所有球队。
GET	/v1/teams/:name	查询某支球队跨届次的所有参赛记录及最终排名。
GET	/v1/teams/:name/roster?year=YYYY	获取某支球队在指定年份的阵容。
GET	/v1/players	搜索球员。
GET	/v1/players/:name	获取某位球员的全部世界杯生涯数据。
GET	/v1/trivia	获取精选的冷知识。
GET	/v1/compare?years=1986,2022	提供两届赛事的多维度指标对比。
GET	/v1/aggregates/players	进行球员层面的聚合分析（如位置、出生月份）。
GET	/v1/aggregates/champions	提供冠军相关统计（夺冠次数、重复冠军等）。

数据来源与质量

• 数据来源：官方 FIFA 档案、RSSSF（国际足球历史与统计联合会）、英文维基百科、各国家队官方协会档案。
• 数据原则：不采用博客、Reddit、粉丝网站或 AI 生成内容作为主要来源。错误报告将在 48 小时内得到确认。

定价计划

计划	月费	速率限制	功能
免费	$0	500 次/天	当前赛事 + 1 个历史赛事，无实时更新。
Hobby	$9	50K 次/月	所有 23 届历史赛事，无实时数据。
Pro	$29	500K 次/月	所有历史数据 + 赛事期间实时更新（5 分钟延迟）。
Studio	$99	无限制	包含 Pro 所有功能 + 邮件支持 + 批量导出端点。