⚽ 足球数据开放 API
把欧洲主流联赛与世界杯数据接入你的应用:积分榜、射手榜 / 助攻榜、球员生涯数据,以及世界杯 23 届全部赛程与比分。
9联赛
1,801积分榜记录
3,086球员
23届世界杯
① 开通 足球数据 API 仅注册用户 · 支付后立即发放 Key
本服务为付费服务,且仅限注册用户开通。请先登录(或注册),登录后在本页在线支付,支付成功立即获得专属 API Key。
登录 / 注册后开通
② 调用方式
在请求头携带 X-API-Key(推荐),或加查询参数 ?key=***。返回统一为 JSON:{"ok":true,"code":200,"data":{...}}
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/overview"
响应头会返回当日配额:X-Quota-Limit / X-Quota-Used。超限返回 429,Key 无效返回 401,未开通/到期返回 403。
③ 接口列表 全部为 GET · 本服务 ¥699/年
GET/api/ow/fb/overview
数据概览:联赛/积分/球员/世界杯数量、字段说明与全部接口路径。
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/overview"
GET/api/ow/fb/leagues
联赛列表(中英文名 / 所属地区 / 赛季数 / 最新赛季)。
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/leagues"
GET/api/ow/fb/standings
积分榜(场次 / 胜平负 / 进球 / 失球 / 净胜球 / 积分)。
| 参数 | 必填 | 说明 |
|---|
| league | 否 | 联赛标识,如 yingchao(英超) |
| season | 否 | 赛季 4 位年份,默认最新 |
| limit | 否 | 最大 100,默认 50 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/standings?league=yingchao&season=2026"
GET/api/ow/fb/scorers
射手榜 / 助攻榜(按赛季)。
| 参数 | 必填 | 说明 |
|---|
| league | 否 | 联赛标识 |
| season | 否 | 赛季 |
| stat | 否 | goal(进球,默认)/ assist(助攻) |
| limit | 否 | 最大 200,默认 30 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/scorers?league=yingchao&season=2011&stat=goal"
GET/api/ow/fb/players
球员搜索(生涯总进球/助攻、效力联赛)。
| 参数 | 必填 | 说明 |
|---|
| q | 否 | 姓名模糊搜索 |
| limit | 否 | 最大 200,默认 30 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/players?q=范佩西"
GET/api/ow/fb/player
单个球员的逐赛季明细。
| 参数 | 必填 | 说明 |
|---|
| id | 是 | 球员 ID(可由 players 接口获得) |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/player?id=1"
GET/api/ow/fb/worldcup
世界杯届次列表(主办国 / 参赛队数 / 场次 / 冠军 / 亚军 / 三四名)。
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/worldcup"
GET/api/ow/fb/wc-matches
世界杯比赛(阶段 / 小组 / 主客队 / 比分)。
| 参数 | 必填 | 说明 |
|---|
| year | 否 | 届次年份,如 2022 |
| stage | 否 | 阶段,如 Final / First stage |
| limit | 否 | 最大 300,默认 100 |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/wc-matches?year=2022"
GET/api/ow/fb/wc-groups
世界杯小组分组(参赛球队列表)。
| 参数 | 必填 | 说明 |
|---|
| year | 否 | 届次年份(当前覆盖 2026) |
curl -H "X-API-Key: ***" "https://www.oweidata.com/api/ow/fb/wc-groups?year=2026"
④ 返回示例
{
"ok": true,
"code": 200,
"data": {
"league": "yingchao", "season": "2026", "count": 20,
"list": [
{ "rank": 1, "team": "曼城", "played": 5, "win": 5, "draw": 0, "loss": 0,
"goals_for": 13, "goals_against": 5, "goal_diff": 8, "points": 15 }
]
}
}
字段说明:league 联赛标识 · season 赛季 · rk=rank 排名 · gf/ga/gd 进球/失球/净胜球 · points 积分。
错误码:401 Key 缺失/无效 · 403 Key 未开通/已停用/已到期 · 404 未找到数据 · 429 超出当日配额 · 422 参数错误。
⑤ 使用条款
1. 数据整理自公开渠道,仅供研究与产品展示参考;
2. 请注明数据来源“鸥维数据(www.oweidata.com)”;
3. 禁止转售、二次分发原始数据或进行高频爬取;
4. 本服务含 1000 次/日 调用额度;如需更高配额或商用授权,请通过页脚「关于我们」联系我们。
