免费足球数据 API — 98 个联赛

1 · 第一次调用（不需要密钥）

# 全部联赛，以及每个联赛可以查询的赛季
curl https://footballcharts-backend.onrender.com/api/v1/leagues/

# 中超 2025 赛季全部赛果
curl "https://footballcharts-backend.onrender.com/api/v1/leagues/china/results/?season=2025"

{
  "league": "china",
  "season": "2025",
  "season_state": "complete",
  "count": 240,
  "matches": [
    {
      "date": "2025-02-22",
      "time": "11:35:00",
      "kickoff_utc": "2025-02-22T11:35:00Z",
      "homeTeam": "Chengdu Rongcheng",
      "awayTeam": "Wuhan Three Towns",
      "score": "1:0",
      "ht_result": "0:0",
      "first_goal_time": 59,
      "first_goal_time_extra": 0,
      "goalless": false
    }
  ],
  "source_url": "https://www.football-charts.com/leagues/china/super-league?ref=api",
  "attribution": "Data by football-charts.com"
}

2 · Python：获取赛果，画出进球时间分布

只需要 requests。完整脚本还会用 matplotlib 画图，并自动选用系统里的中文字体。

import requests

API = "https://footballcharts-backend.onrender.com/api/v1"
HEADERS = {}  # 有免费密钥时：{"Authorization": "Bearer fc_你的密钥"}

# 中超 2025 赛季全部赛果（自然年赛制，赛季写作 "2025"）
res = requests.get(f"{API}/leagues/china/results/",
                   params={"season": "2025"}, headers=HEADERS, timeout=30).json()
for m in res["matches"][:3]:
    print(m["kickoff_utc"], m["homeTeam"], m["score"], m["awayTeam"],
          "半场", m["ht_result"], "首球", m["first_goal_time"], "分钟")

# 进球时间分布：每 15 分钟一段，"45+" 和 "90+" 是补时
gt = requests.get(f"{API}/leagues/china/goal-timing/",
                  params={"season": "2025"}, headers=HEADERS, timeout=30).json()
print(dict(zip(gt["time_bins"], gt["stats"]["period_totals"])))

3 · CSV 样例：中超 2025 赛季与 98 联赛代码对照表

240 场比赛，一行一场，取自开放数据集（CC BY 4.0）。包括开球时间（UTC）、主客队、半场和全场比分，以及每个进球的分钟（all_goal_times，如 "12,47,93"）。文件均为 UTF-8 编码并带 BOM，Excel 可以直接打开。

下载 csl_2025_results.csv（中超 2025 赛果） · 下载 leagues_zh_cn.csv（98 个联赛代码与中英文对照表） · 全部 92 个联赛的同格式数据见 开放数据集

4 · 赛季怎么写：跨年制和自然年制

• · 跨年制（秋季开始，次年春季结束）写作 "2025-2026"：英超、西甲、德甲、意甲、法甲、沙特联、澳超等。
• · 自然年制（同一年内开始和结束）写作 "2025"：中超、韩K联、巴甲、挪超、瑞典超、芬超等。
• · 日职联：2026 年上半年是过渡期的特别赛季（"2026"），从 2026-27 赛季起改为跨年制（"2026-2027"）。
• · 写错格式时，API 返回 400 unknown_season，并在提示里给出正确写法。最稳妥的做法是先调用 /leagues/，直接使用其中的赛季字符串。

5 · 时间一律为 UTC

API 中所有日期和时间都是 UTC。北京时间比 UTC 早 8 小时：kickoff_utc 为 2025-02-22T11:35:00Z 的比赛，北京时间 19:35 开球。2026 年 10 月 13 日以前，已完赛比赛的 time 字段是数据源的本地时间而不是 UTC，现已更正，并新增了 kickoff_utc 字段。

6 · 错误码

出错时返回 JSON：{"error": {"code": "…", "message": "…"}}，message 为英文。

7 · 免费密钥：每天 200 次

只需要邮箱。密钥会立即显示在页面上，同时发送到你的邮箱（没收到请看垃圾邮件文件夹）。调用时加请求头 Authorization: Bearer fc_你的密钥。

免费密钥供个人使用（试用、自己的分析和项目），同一邮箱的所有密钥合计每天 200 次。供他人使用的应用、网站、机器人或频道需要商业版。10 月 26 日之前注册的密钥在 11 月 2 日之前仍为每天 5,000 次。

8 · 全部接口

基础地址：https://footballcharts-backend.onrender.com/api/v1。接口说明也可以直接访问 GET /api/v1/（英文）。

9 · 完整历史（付费）

同一个接口、同样的 JSON，2020 年以来的全部赛季：

• · 个人：€9/月 或 €99/年，每天 5,000 次，个人和研究用途。
• · 商业：€39/月 或 €390/年，每天 25,000 次。供他人使用的应用、网站、机器人或频道（收费或免费）都需要商业版；提供发票和邮件支持，变更提前 30 天通知（仍需注明来源，不得转售原始数据）。

先注册免费密钥；购买后，同一个密钥在一分钟内升级，代码不用改，原来返回 403 的赛季直接可用。付款方式、年付、发票和免费学术申请见价格与购买 →

附录 · MCP 服务器（给 AI 助手和智能体用）

MCP（Model Context Protocol）让支持它的 AI 客户端直接调用上面的数据。托管服务器无需安装、无需密钥：

https://mcp.football-charts.com/mcp

# 带免费密钥（每天 200 次）：
https://mcp.football-charts.com/fc_你的密钥/mcp

{
  "mcpServers": {
    "football-charts": {
      "url": "https://mcp.football-charts.com/mcp"
    }
  }
}

npx -y footballcharts-mcp

# 国内网络可用 npmmirror 镜像：
npx --registry=https://registry.npmmirror.com -y footballcharts-mcp

curl -s https://mcp.football-charts.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

可在 Cherry Studio、Cursor、Cline、VS Code 等支持 MCP 的客户端中添加。所有工具都是只读的，工具说明和返回内容为英文：