加载接口文档…
足球赛事
API按日期查询足球赛程与比分，覆盖英格兰、西班牙、意大利、德国、法国足球甲级联赛，以及欧洲冠军联赛、欧洲联赛、中国足球协会超级联赛、英格兰足球协会挑战杯、国际足联世界杯。返回开赛时间、比分、比赛状态与场馆，不含赔率或门票。 调用说明： 1）默认 POST /api/football，…
由 极数本源 提供·更新于 今天
657
累计调用
1261ms
平均响应
100.00%
服务可用性
20 次/日
免费额度
访问限制
查看更多方案 →未携带 API Key
每天 5 次 · QPS 1
登录免费
当前方案每天 20 次 · QPS 40
免费试用
一次性 10 次
黄金会员
每天 4,000 次 · QPS 80
钻石会员
每天 8,000 次 · QPS 80
企业会员
每天 16,000 次 · QPS 120
接入文档
接口请求地址
https://v1.apizero.cn/api/football
接口请求方式
POST
请求参数格式
FORM / QUERY / JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/football?status=live&date=2026-09-12&league=epl&limit=80
接口信息备注
查询指定日期处于进行中状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时，matches 返回空数组。
请求参数说明
status（状态）string
可选 · 比赛状态。本子接口取值为 live（进行中）。 · 默认 live · 示例：live
date（日期）string
可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-12
league（联赛）string
可选 · 联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。 · 示例：epl
limit（条数）int
可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80
| 名称 | 类型 | 说明 |
|---|---|---|
| status（状态） | string | 可选 · 比赛状态。本子接口取值为 live（进行中）。 · 默认 live · 示例：live |
| 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。 |
返回字段说明
summary.sportstring
运动：football / basketball
summary.datestring
查询的比赛日（北京日期）
summary.leaguestring
联赛代码或 all
summary.statusstring
筛选状态：all / live / upcoming / finished
summary.countnumber
本次返回场次数
summary.totalnumber
当日该范围未截断前的场次总数
summary.livenumber
本次返回中进行中的场次数
summary.generated_atstring
生成时间（北京时间）
matchesarray
赛程：进行中 → 未开赛按时间 → 已结束
idstring
场次 ID
league_namestring
联赛中文名
start_atstring
开赛时间（北京时间）
statusstring
live / upcoming / finished
homeobject
主队 name / short / logo / score
namestring
名称
shortstring
short
scorenumber
score
awayobject
客队 name / short / logo / score
namestring
名称
shortstring
short
scorenumber
score
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| summary.sport | string | 运动：football / basketball | ||||||||||||||||||||||||||||||||||||||||||
| summary.date | string | 查询的比赛日（北京日期） | ||||||||||||||||||||||||||||||||||||||||||
| summary.league | string | 联赛代码或 all | ||||||||||||||||||||||||||||||||||||||||||
| summary.status | string | 筛选状态：all / live / upcoming / finished | ||||||||||||||||||||||||||||||||||||||||||
| summary.count | number | 本次返回场次数 | ||||||||||||||||||||||||||||||||||||||||||
| summary.total | number | 当日该范围未截断前的场次总数 | ||||||||||||||||||||||||||||||||||||||||||
| summary.live | number | 本次返回中进行中的场次数 | ||||||||||||||||||||||||||||||||||||||||||
| summary.generated_at | string | 生成时间（北京时间） | ||||||||||||||||||||||||||||||||||||||||||
| matches | array | 赛程：进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"summary": {
"sport": "football",
"date": "2026-09-12",
"league": "all",
"status": "live",
"count": 1,
"total": 7,
"live": 0,
"generated_at": "2026-09-11 17:40:00"
},
"matches": [
{
"id": "401879285",
"league": "epl",
"league_name": "英超",
"start_at": "2026-09-12 22:00:00",
"status": "upcoming",
"status_text": "未开赛",
"venue": "Vitality Stadium",
"home": {
"name": "AFC Bournemouth",
"short": "BOU",
"score": 0
},
"away": {
"name": "Brentford",
"short": "BRE",
"score": 0
}
}
]
},
"tips": "极数本源 · https://apizero.cn"
}免责声明
赛程与比分来自公开体育数据源，可能有延迟或漏场。仅供资讯展示，不构成投注建议。请勿用于违法用途。