Bundesliga
收藏官方服务:
资源简介:
Bundesliga standings, fixtures, results, live scores, lineups, events, player and team stats. Current season plus history.
创建时间:
2026-09-05
原始信息汇总
数据集概述:Bundesliga API
类别:体育(Sports)
提供者:Yuval Ron
订阅数:1
核心功能
该API提供德国足球甲级联赛(Bundesliga)的全方位数据,涵盖积分榜、赛程、比赛结果、实时比分、阵容、比赛事件、球员和球队统计等。数据覆盖当前赛季及过往两个完整赛季,新赛季结束后自动归档。
主要端点
| 端点 | 说明 |
|---|---|
GET / |
获取联赛信息、当前赛季及可用赛季列表 |
GET /standings |
积分榜,包含已赛/胜/平/负、进球、积分、状态及升降级区域 |
GET /teams |
当前赛季参赛球队列表 |
GET /teams/{id} |
球队详情(教练、颜色等) |
GET /teams/{id}/squad |
球队阵容(位置、球衣号码、年龄、身高、国籍) |
GET /teams/{id}/matches |
该球队的比赛记录 |
GET /teams/{id}/stats |
赛季汇总统计(含零封、黄红牌) |
GET /teams/{id}/head-to-head/{otherId} |
两队历史交锋记录 |
GET /players |
球员列表(支持球队、位置、国籍筛选) |
GET /players/{id} |
球员详情(含赛季统计) |
GET /players/{id}/matches |
球员逐场数据(出场时间、进球、助攻、评分) |
GET /matches |
赛程与结果(支持轮次、日期、状态、球队筛选) |
GET /matches/{id} |
比赛完整详情:阵容、球员统计、事件、裁判、场地 |
GET /matches/live |
进行中的比赛 |
GET /matches/today |
当日比赛(UTC时间) |
GET /matches/next |
下一轮比赛 |
GET /stats/top-scorers |
射手榜(按进球排名,最多100条) |
GET /stats/top-assists |
助攻榜 |
GET /stats/cards |
牌榜(按红黄牌排名) |
GET /stats/ratings |
平均评分榜(至少出场5次) |
数据特点与规范
- 响应格式:统一为
{ "data": ..., "meta": ... };错误格式为{ "error": { "code": ..., "message": ... } } - 时间戳:采用UTC ISO 8601格式
- 分页:列表端点支持
page和limit(默认50,最大200),meta中返回page、limit、total - 比赛状态:
scheduled(已排定)、live(进行中)、halftime(中场)、finished(已结束)、postponed(延期)、cancelled(取消) - 赛季参数:赛季范围端点支持
?season=2025-26,默认当前赛季 - 球队标识:支持数字ID或slug(如
/teams/bayern-munich),ID为稳定数值型
实时数据机制
- 比赛从开球到终场哨响期间,每30秒轮询更新,保证比分、分钟数、阵容和事件的实时性
- 已完成的比赛会在终场10分钟后再次拉取一次,以获取最终确认的统计数据



