足球赛事

footballPOST

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

概述

按日期查询足球赛程与比分，覆盖英格兰、西班牙、意大利、德国、法国足球甲级联赛，以及欧洲冠军联赛、欧洲联赛、中国足球协会超级联赛、英格兰足球协会挑战杯、国际足联世界杯。返回开赛时间、比分、比赛状态与场馆，不含赔率或门票。调用说明： 1）默认 POST /api/football，查询北京时间当日主流联赛； 2）按子接口分别查询进行中、未开赛、已结束，或指定联赛； 3）联赛列表子接口返回联赛代码与名称，不请求上游数据源。时间均为北京时间。赛程缓存约 45 秒。登录每日 20 次；黄金 4000、钻石 8000；企业走额度。单用户 QPS 与条码查询同档。

调用约定

网关 · https://v1.apizero.cn
鉴权 · Authorization: Bearer <API Key>
回包 · JSON {code, msg, data}。成功看 code === 0，不要只看 HTTP 200。

/aidocs/football/raw.md

打开 Markdown

鉴权

请求地址为 POST /api/football。请按子接口分别传入对应参数。返回时间均为北京时间。

获取 API Key：/account/keys

请求头

Header	类型	必填	说明
Authorization	string	是	必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。

今日赛程

POSTFORM / QUERY / JSON·APPLICATION/JSON

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

https://v1.apizero.cn/api/football?date=2026-09-12&limit=80

参数	类型	必填	说明	示例
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "date": "2026-09-12",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

进行中

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询指定日期处于进行中状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时，matches 返回空数组。

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

参数	类型	必填	说明	示例
status	string	否	比赛状态。本子接口取值为 live（进行中）。	live
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
league	string	否	联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。	epl
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "status": "live",
  "date": "2026-09-12",
  "league": "epl",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
score	number	score

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"
}

未开赛

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询指定日期处于尚未开赛状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时，matches 返回空数组。

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

参数	类型	必填	说明	示例
status	string	否	比赛状态。本子接口取值为 upcoming（尚未开赛）。	upcoming
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
league	string	否	联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。	epl
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "status": "upcoming",
  "date": "2026-09-12",
  "league": "epl",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
score	number	score

tips

string

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

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

已结束

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询指定日期处于已结束状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时，matches 返回空数组。

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

参数	类型	必填	说明	示例
status	string	否	比赛状态。本子接口取值为 finished（已结束）。	finished
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
league	string	否	联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。	epl
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "status": "finished",
  "date": "2026-09-12",
  "league": "epl",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
score	number	score

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": "英超",
        "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"
}

英超

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询英格兰足球超级联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 epl（英格兰足球超级联赛）。	epl
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "epl",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

西甲

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询西班牙足球甲级联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 laliga（西班牙足球甲级联赛）。	laliga
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "laliga",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

意甲

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询意大利足球甲级联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 seriea（意大利足球甲级联赛）。	seriea
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "seriea",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

德甲

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询德国足球甲级联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 bundesliga（德国足球甲级联赛）。	bundesliga
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "bundesliga",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

法甲

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询法国足球甲级联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 ligue1（法国足球甲级联赛）。	ligue1
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "ligue1",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

欧冠

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询欧洲冠军联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 ucl（欧洲冠军联赛）。	ucl
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "ucl",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

欧联

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询欧洲联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 uel（欧洲联赛）。	uel
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "uel",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

中超

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询中国足球协会超级联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 csl（中国足球协会超级联赛）。	csl
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "csl",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

足总杯

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询英格兰足球协会挑战杯指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 facup（英格兰足球协会挑战杯）。	facup
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "facup",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

世界杯

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询国际足联世界杯指定日期的赛程、比分及比赛状态。时间均为北京时间。

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

参数	类型	必填	说明	示例
league	string	否	联赛代码。本子接口取值为 worldcup（国际足联世界杯）。	worldcup
date（日期）	string	否	比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。	2026-09-12
status	string	否	比赛状态。取值 all（全部）、live（进行中）、upcoming（未开赛）、finished（已结束）。	all
limit（条数）	int	否	返回条数。取值范围 1–200，缺省 80。	80

{
  "league": "worldcup",
  "date": "2026-09-12",
  "status": "all",
  "limit": "80"
}

返回结果

字段

类型

说明

summary.sport

string

运动：football / basketball

summary.date

string

查询的比赛日（北京日期）

summary.league

string

联赛代码或 all

summary.count

number

本次返回场次数

summary.generated_at

string

生成时间（北京时间）

summary.live

number

本次返回中进行中的场次数

summary.total

number

当日该范围未截断前的场次总数

summary.status

string

筛选状态：all / live / upcoming / finished

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
score	number	score

away

object

客队 name / short / logo / score

name	string	名称
short	string	short
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": "英超",
        "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"
}

联赛列表

POSTFORM / QUERY / JSON·APPLICATION/JSON

返回本接口支持的联赛代码与名称，不请求上游数据源。

https://v1.apizero.cn/api/football?action=leagues

参数	类型	必填	说明	示例
action（操作）	string	否	操作类型。本子接口取值为 leagues（返回联赛目录）。	leagues

{
  "action": "leagues"
}

返回结果

字段

类型

说明

sport

string

football

count

number

联赛数量

leagues

array

id / code / name

id	string	id
code	string	code
name	string	名称

tips

string

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

{
  "code": 0,
  "msg": "成功",
  "data": {
    "sport": "football",
    "count": 10,
    "leagues": [
      {
        "id": "epl",
        "code": "epl",
        "name": "英超"
      },
      {
        "id": "laliga",
        "code": "laliga",
        "name": "西甲"
      },
      {
        "id": "seriea",
        "code": "seriea",
        "name": "意甲"
      },
      {
        "id": "bundesliga",
        "code": "bundesliga",
        "name": "德甲"
      },
      {
        "id": "ligue1",
        "code": "ligue1",
        "name": "法甲"
      },
      {
        "id": "ucl",
        "code": "ucl",
        "name": "欧冠"
      },
      {
        "id": "uel",
        "code": "uel",
        "name": "欧联"
      },
      {
        "id": "csl",
        "code": "csl",
        "name": "中超"
      },
      {
        "id": "facup",
        "code": "facup",
        "name": "足总杯"
      },
      {
        "id": "worldcup",
        "code": "worldcup",
        "name": "世界杯"
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

请求示例

示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。把 Key 放在环境变量 APIZERO_KEY，不要写进浏览器、小程序或前端打包。

# 服务端执行：export APIZERO_KEY=...
# 密钥：https://apizero.cn/account/keys
curl -sS -X POST "https://v1.apizero.cn/api/football" \
  -H "Authorization: Bearer $APIZERO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

错误码

先看业务 code。HTTP 也可能不是 200。

业务码	HTTP	说明
0	200	成功
4000	400	参数错误
4011	401	API Key 无效
4013	403	API Key 已暂停
4014	403	当前 IP 不在 Key 白名单
4015	401	此接口需要 API Key
4022	402	余额不足
4029	429	调用过快（QPS）
4030	429	今日免费额度已用完
4040	503	接口已下线
4041	404	接口不存在
5000	500	服务器内部错误
5020	502	上游暂时不可用
5021	502	上游返回格式异常
5030	502	暂无可用节点

调用限制

计费模式	按次付费 · 点数包 · VIP
QPS 限制	2 req/s
登录免费额度	20 次（已认证）
匿名每日额度	5 次（无 API Key）
黄金会员	每日 4000 次 · QPS 80
钻石会员	每日 8000 次 · QPS 30
企业会员	企业接口额度 · QPS 120

购买套餐、看评价请走商城详情。购买 / 调试

更新日志

1.0.02026-09-11
上架按日期查询赛程与比分支持联赛过滤与进行中筛选

免责声明

赛程与比分来自公开体育数据源，可能有延迟或漏场。仅供资讯展示，不构成投注建议。请勿用于违法用途。