EnglishFootballVault

Historical results, league tables and team records for English football since 1871 — every tier from the Premier League to Step 6, plus the complete FA Cup.

原始信息汇总

数据集概述

EnglishFootballVault 是一个独立的、由球迷构建的英格兰国内足球历史数据库 API，提供自 1871-72 赛季（FA Cup）和 1888-89 赛季（Football League）至今的完整历史数据，覆盖英格兰足球金字塔全部八个级别（从英超到第六级别非联赛），以及 FA Cup 自 1871-72 年以来的完整历史。

核心数据覆盖

• 比赛类型：联赛积分榜（直接从比赛结果计算）、完整比赛结果（含加时赛和点球大战）、球队完整历史战绩（合并俱乐部更名记录）、任意两队之间的历史交锋记录，以及跨球队、赛事和比赛的搜索功能。
• 数据规模（截至页面提供的数据）：33 项赛事、155 个赛季、1081 支球队、335,985 场比赛、981,509 个进球、8 个级别。
• 时间范围：首个赛季为 1871-72，最后一个赛季为 2025-26。
• 覆盖说明：
  • FA Cup 仅记录从“第一轮正赛”开始的比赛，资格赛轮次不包含在内。
  • 不同联赛的覆盖深度不一，部分非联赛级别的历史记录不如 FA Cup 久远。
  • 球队记录自动合并同一法律实体下的俱乐部更名（如 Hyde United 合并 Hyde F.C.），但法律上无关、仅同名历史的俱乐部（凤凰俱乐部）只做交叉引用，绝不合并。

技术说明

• 请求方式：所有端点均为简单的 GET 请求，通过 RapidAPI 网关调用，需携带 API 密钥。
• 响应格式：所有响应均为 JSON 对象，成功返回 {"ok": true, ...}，失败返回 {"ok": false, "error": "message"}。
• 错误处理：未知的 id 返回 {"ok": false, "error": "not found"}；headtohead 接口要求 team1 和 team2 不同，否则返回错误。

可用端点（共 10 个）

端点	功能	必需参数
GET /sitestats.php	数据库总体统计（赛事、赛季、球队、比赛、进球数等）	无
GET /competitions.php	所有赛事谱系，按级别分组（含 FA Cup 的 null 级别组）	无
GET /competition.php	单个赛事的详细信息（赛季数、比赛数、首末日期等）	id（competition_id）
GET /seasons.php	指定赛事的可用赛季列表	id（competition_id）
GET /standings.php	联赛积分榜（直接从比赛结果计算，不适用于淘汰制赛事如 FA Cup）	id、season_id
GET /games.php	指定赛事/赛季的完整比赛列表（杯赛含轮次信息）	id、season_id
GET /team.php	球队的完整职业生涯统计和逐赛季比赛历史（含更名合并记录）	id（team_id）
GET /allteams.php	数据库中的所有球队及其大致出场次数	无
GET /search.php	跨球队名、赛事名、场地和备注的自由文本搜索	q（搜索词，最少 2 个字符）
GET /headtohead.php	两队之间在所有记录在案赛事中的历史交锋总览和 W/D/L 及进球汇总	team1、team2（均需 team_id，且不能相同）

示例数据亮点

• 积分榜：返回每支球队的场次、胜平负、进球、失球、净胜球和积分（如 Arsenal 在示例中 38 场 26 胜 8 平 4 负，积 86 分）。
• 历史交锋：以 Arsenal vs Tottenham Hotspur 为例，返回总计 200 场比赛、阿森纳 90 胜、55 平、热刺 55 胜，以及双方进球数。
• 球队历史：Hyde United 示例显示其生涯 3200 场，1180 胜，780 平，1240 负，并包含与 Hyde F.C. 的合并记录及年份范围。

数据许可与归属

EnglishFootballVault 与英超联赛、英格兰足球联赛（EFL）、英足总（The FA）或任何引用的俱乐部/赛事无任何隶属、认可或赞助关系。所有数据均汇编自公开的历史记录。API 创建者为 Tony Spencer。