SuperAPI AI 工具集

openfootball

数据与分析

查看项目

更新于 10-16 03:13

技能介绍

openfootball(football.json)是一个免费、开放、公共领域的足球比赛数据集合,以 JSON 格式提供全球主要联赛与赛事数据,无需 API 密钥或认证。

用途:获取足球比赛结果数据,用于构建积分榜、统计、对阵分析等。

主要能力:提供英格兰、德国、西班牙、意大利、法国等联赛的预构建 JSON 文件,覆盖 2010-11 赛季至今。数据源有两种访问方式:raw GitHub URL(推荐)https://raw.githubusercontent.com/openfootball/football.json/master/{season}/{code}.json,以及 GitHub Pages 镜像。联赛代码采用 {country}.{division} 格式,如 en.1、de.1、es.1、it.1、fr.1。

JSON 结构:顶层字段 name 和 matches;每场比赛包含 round、date、time(可选)、team1、team2、score(可选,含 ft 和 ht)、status(可选)。score.ft 为 [主队进球, 客队进球]。

使用方式:可直接用 curl 获取,例如 curl -s "https://raw.githubusercontent.com/openfootball/football.json/master/2024-25/en.1.json" | jq .;也可用 Python、Node.js 等解析。数据为公共领域(CC0),可自由使用。

限制:并非所有联赛在所有赛季都可用;未开赛比赛无 score 字段;部分比赛无 ht;球队名称含后缀且因联赛而异,需精确匹配;time 为当地开球时间;建议缓存历史赛季,当前赛季轮询间隔不少于 60 秒,并发请求保持合理。GitHub 未认证 API 限 60 次/小时(仅 API 端点,raw 内容不受此限)。