足球赛事

footballPOST
POSThttps://v1.apizero.cn/api/football
获取 API Key工作台购买 / 调试

概述

按日期查询足球赛程与比分，覆盖英格兰、西班牙、意大利、德国、法国足球甲级联赛，以及欧洲冠军联赛、欧洲联赛、中国足球协会超级联赛、英格兰足球协会挑战杯、国际足联世界杯。返回开赛时间、比分、比赛状态与场馆，不含赔率或门票。 调用说明： 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

请求头

Authorizationstring必填

必填鉴权。推荐：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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

{
  "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.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

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

返回结果

sportstring

football

countnumber

联赛数量

leaguesarray

id / code / name

idstring

id

codestring

code

namestring

名称

tipsstring

品牌提示（所有接口统一返回）：极数本源 · 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 各有常规写法和官方库。

curl -sS -X POST "https://v1.apizero.cn/api/football" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

错误码

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

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快（QPS）

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

计费模式
按次付费 · 点数包 · VIP
QPS 限制
QPS 40
登录免费额度
20 次（已认证）
匿名每日额度
5 次（无 API Key）
黄金会员
每天 4,000 次 · QPS 80
钻石会员
每天 8,000 次 · QPS 80
企业会员
本接口约 39,900 次/月 · QPS 120

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

更新日志

  • 1.0.02026-09-11

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

免责声明

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