运行中

免费试用多种计费VIP免费

新品生活服务

足球赛事

API

按日期查询足球赛程与比分，覆盖英格兰、西班牙、意大利、德国、法国足球甲级联赛，以及欧洲冠军联赛、欧洲联赛、中国足球协会超级联赛、英格兰足球协会挑…

接入文档

由极数本源提供·更新于最近

先试用，再接接口

不用写代码。打开工具页跑一遍足球赛事，看清结果再来订阅。

打开足球赛事

累计调用

—

平均响应

—

服务可用性

访问限制

查看更多方案 →

我的方案按量计费升级套餐

QPS 3

新用户试用 10 次，用尽后不再发放—

注册后一次性授予 10 次试用，用尽后不再发放。不另设每日免费额度时，之后按次或点数计费。

未携带 API Key

无匿名额度，须携带 API Key

登录免费

无登录免费额度

免费试用

一次性 10 次

AI 文档

把这个地址发给 AI，就能生成调用代码

https://apizero.cn/aidocs/football/raw.md

打开文档

接入文档

打开

接口请求地址

https://v1.apizero.cn/api/football

接口请求方式

POST

请求参数格式

FORM / QUERY / JSON

接口返回格式

APPLICATION/JSON

接口请求示例

https://v1.apizero.cn/api/football?action=matches&league=all&status=all&date=2026-09-12&limit=80

接口信息备注

查询北京时间当日英格兰、西班牙、意大利、德国、法国足球甲级联赛，以及欧洲冠军联赛、中国足球协会超级联赛的赛程、比分及比赛状态。可通过 date 指定比赛日，通过 limit 控制返回条数。

请求参数说明

date（日期）string

可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-12

limit（条数）int

可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80

名称	类型	说明
date（日期）	string	可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-12
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

status	string	筛选状态：all / live / upcoming / finished
total	number	当日该范围未截断前的场次总数
live	number	本次返回中进行中的场次数
generated_at	string	生成时间（北京时间）

matches

array

赛程：进行中 → 未开赛按时间 → 已结束

string

场次 ID

league_name

string

联赛中文名

start_at

string

开赛时间（北京时间）

status

string

live / upcoming / finished

home

object

主队 name / short / logo / score

name	string	名称
short	string	short
logo	string	logo
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
logo	string	logo
score	number	score

tips

string

品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn

返回示例

{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "football",
      "date": "2026-09-12",
      "league": "all",
      "status": "all",
      "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"
}

加载接口文档…

名称

类型

说明

date（日期）

string

可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-12

limit（条数）

int

可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80

名称

类型

说明

Authorization

string

{ "code": 0, "msg": "成功", "data": { "summary": { "sport": "football", "date": "2026-09-12", "league": "all", "status": "all", "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" }