加载接口文档…
足球赛事
API按日期查询足球赛程与比分，覆盖英格兰、西班牙、意大利、德国、法国足球甲级联赛，以及欧洲冠军联赛、欧洲联赛、中国足球协会超级联赛、英格兰足球协会挑…
由 极数本源 提供·更新于 最近
0
累计调用
—
平均响应
—
服务可用性
访问限制
查看更多方案 →未携带 API Key
无匿名额度，须携带 API Key
登录免费
无登录免费额度
免费试用
一次性 10 次
接入文档
接口请求地址
https://v1.apizero.cn/api/football
接口请求方式
POST
请求参数格式
FORM / QUERY / JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/football?action=matches&status=finished&date=2026-09-12&league=epl&limit=80
接口信息备注
查询指定日期处于已结束状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时，matches 返回空数组。
请求参数说明
status（状态）string
可选 · 比赛状态。本子接口取值为 finished（已结束）。 · 默认 finished · 示例：finished
date（日期）string
可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-12
league（联赛）string
可选 · 联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。 · 示例：epl
limit（条数）int
可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80
| 名称 | 类型 | 说明 |
|---|---|---|
| status（状态） | string | 可选 · 比赛状态。本子接口取值为 finished（已结束）。 · 默认 finished · 示例：finished |
| date（日期） | string | 可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-12 |
| league（联赛） | string | 可选 · 联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。 · 示例：epl |
| limit（条数） | int | 可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80 |
请求头说明
Authorizationstring
必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
返回字段说明
summaryobject
sport / date / league / status / count / total / live / generated_at
statusstring
筛选状态：all / live / upcoming / finished
totalnumber
当日该范围未截断前的场次总数
livenumber
本次返回中进行中的场次数
generated_atstring
生成时间（北京时间）
matchesarray
赛程：进行中 → 未开赛按时间 → 已结束
idstring
场次 ID
league_namestring
联赛中文名
start_atstring
开赛时间（北京时间）
statusstring
live / upcoming / finished
homeobject
主队 name / short / logo / score
namestring
名称
shortstring
short
logostring
logo
scorenumber
score
awayobject
客队 name / short / logo / score
namestring
名称
shortstring
short
logostring
logo
scorenumber
score
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| summary | object | sport / date / league / status / count / total / live / generated_at | ||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| matches | array | 赛程：进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"summary": {
"sport": "football",
"date": "2026-09-12",
"league": "all",
"status": "finished",
"count": 1,
"total": 7,
"live": 0,
"generated_at": "2026-09-11 17:40:00"
},
"matches": [
{
"id": "401879285",
"league": "epl",
"league_name": "英超",
"season": "2026",
"start_at": "2026-09-12 22:00:00",
"start_ts": 1789214400,
"status": "upcoming",
"status_text": "未开赛",
"period": 0,
"clock": "",
"venue": "Vitality Stadium",
"city": "Bournemouth",
"home": {
"name": "AFC Bournemouth",
"short": "BOU",
"logo": "https://a.espncdn.com/i/teamlogos/soccer/500/349.png",
"score": 0
},
"away": {
"name": "Brentford",
"short": "BRE",
"logo": "https://a.espncdn.com/i/teamlogos/soccer/500/337.png",
"score": 0
}
}
]
},
"tips": "极数本源 · https://apizero.cn"
}