篮球赛事

basketballPOST
POSThttps://v1.apizero.cn/api/basketball

概述

按日期查询篮球赛程与比分,覆盖美国男子职业篮球联赛、美国女子职业篮球联赛、美国大学体育协会男子篮球联赛、中国男子篮球职业联赛。返回开赛时间、比分、比赛状态与场馆,不含赔率或门票。 调用说明: 1)默认 POST /api/basketball,查询北京时间当日 NBA 与 WNBA; 2)按子接口分别查询进行中、未开赛、已结束,或指定联赛; 3)联赛列表子接口返回联赛代码与名称,不请求上游数据源。 时间均为北京时间。赛程缓存约 45 秒。登录每日 20 次;黄金 4000、钻石 8000;企业走额度。单用户 QPS 与条码查询同档。

调用约定

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

鉴权

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

获取 API Key:/account/keys

请求头

Header类型必填说明
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/basketball?date=2026-09-11&limit=80

参数类型必填说明示例
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "date": "2026-09-11",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "all",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

进行中

POSTFORM / QUERY / JSON·APPLICATION/JSON

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

https://v1.apizero.cn/api/basketball?status=live&date=2026-09-11&league=nba&limit=80

参数类型必填说明示例
statusstring比赛状态。本子接口取值为 live(进行中)。live
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
leaguestring联赛代码。用于限定单一联赛;缺省为全部已覆盖联赛。nba
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "status": "live",
  "date": "2026-09-11",
  "league": "nba",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "live",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

未开赛

POSTFORM / QUERY / JSON·APPLICATION/JSON

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

https://v1.apizero.cn/api/basketball?status=upcoming&date=2026-09-11&league=nba&limit=80

参数类型必填说明示例
statusstring比赛状态。本子接口取值为 upcoming(尚未开赛)。upcoming
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
leaguestring联赛代码。用于限定单一联赛;缺省为全部已覆盖联赛。nba
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "status": "upcoming",
  "date": "2026-09-11",
  "league": "nba",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "upcoming",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

已结束

POSTFORM / QUERY / JSON·APPLICATION/JSON

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

https://v1.apizero.cn/api/basketball?status=finished&date=2026-09-11&league=nba&limit=80

参数类型必填说明示例
statusstring比赛状态。本子接口取值为 finished(已结束)。finished
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
leaguestring联赛代码。用于限定单一联赛;缺省为全部已覆盖联赛。nba
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "status": "finished",
  "date": "2026-09-11",
  "league": "nba",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "finished",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

NBA

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询美国男子职业篮球联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

https://v1.apizero.cn/api/basketball?league=nba&date=2026-09-11&status=all&limit=80

参数类型必填说明示例
leaguestring联赛代码。本子接口取值为 nba(美国男子职业篮球联赛)。nba
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
statusstring比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。all
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "league": "nba",
  "date": "2026-09-11",
  "status": "all",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "all",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

WNBA

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询美国女子职业篮球联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

https://v1.apizero.cn/api/basketball?league=wnba&date=2026-09-11&status=all&limit=80

参数类型必填说明示例
leaguestring联赛代码。本子接口取值为 wnba(美国女子职业篮球联赛)。wnba
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
statusstring比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。all
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "league": "wnba",
  "date": "2026-09-11",
  "status": "all",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "all",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

NCAA 男篮

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询美国大学体育协会男子篮球联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。

https://v1.apizero.cn/api/basketball?league=ncaa&date=2026-09-11&status=all&limit=80

参数类型必填说明示例
leaguestring联赛代码。本子接口取值为 ncaa(美国大学体育协会男子篮球联赛)。ncaa
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
statusstring比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。all
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "league": "ncaa",
  "date": "2026-09-11",
  "status": "all",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "all",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

CBA

POSTFORM / QUERY / JSON·APPLICATION/JSON

查询中国男子篮球职业联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。该联赛使用独立数据源。

https://v1.apizero.cn/api/basketball?league=cba&date=2026-09-11&status=all&limit=80

参数类型必填说明示例
leaguestring联赛代码。本子接口取值为 cba(中国男子篮球职业联赛)。cba
date(日期)string比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。2026-09-11
statusstring比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。all
limit(条数)int返回条数。取值范围 1–200,缺省 80。80
{
  "league": "cba",
  "date": "2026-09-11",
  "status": "all",
  "limit": "80"
}

返回结果

字段类型说明
summary.sportstring运动:football / basketball
summary.datestring查询的比赛日(北京日期)
summary.leaguestring联赛代码或 all
summary.countnumber本次返回场次数
summary.generated_atstring生成时间(北京时间)
summary.livenumber本次返回中进行中的场次数
summary.totalnumber当日该范围未截断前的场次总数
summary.statusstring筛选状态:all / live / upcoming / finished
matchesarray赛程:进行中 → 未开赛按时间 → 已结束
idstring场次 ID
league_namestring联赛中文名
start_atstring开赛时间(北京时间)
statusstringlive / upcoming / finished
homeobject主队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
awayobject客队 name / short / logo / score
namestring名称
shortstringshort
scorenumberscore
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "summary": {
      "sport": "basketball",
      "date": "2026-09-11",
      "league": "nba",
      "status": "all",
      "count": 1,
      "total": 1,
      "live": 0,
      "generated_at": "2026-09-11 17:40:00"
    },
    "matches": [
      {
        "id": "401810001",
        "league": "nba",
        "league_name": "NBA",
        "start_at": "2026-09-11 09:00:00",
        "status": "finished",
        "status_text": "已结束",
        "venue": "Crypto.com Arena",
        "home": {
          "name": "Los Angeles Lakers",
          "short": "LAL",
          "score": 112
        },
        "away": {
          "name": "Golden State Warriors",
          "short": "GSW",
          "score": 108
        }
      }
    ]
  },
  "tips": "极数本源 · https://apizero.cn"
}

联赛列表

POSTFORM / QUERY / JSON·APPLICATION/JSON

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

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

参数类型必填说明示例
action(操作)string操作类型。本子接口取值为 leagues(返回联赛目录)。leagues
{
  "action": "leagues"
}

返回结果

字段类型说明
sportstringbasketball
countnumber联赛数量
leaguesarrayid / code / name
idstringid
codestringcode
namestring名称
tipsstring品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
{
  "code": 0,
  "msg": "成功",
  "data": {
    "sport": "basketball",
    "count": 4,
    "leagues": [
      {
        "id": "nba",
        "code": "nba",
        "name": "NBA"
      },
      {
        "id": "wnba",
        "code": "wnba",
        "name": "WNBA"
      },
      {
        "id": "ncaa",
        "code": "ncaa",
        "name": "NCAA 男篮"
      },
      {
        "id": "cba",
        "code": "cba",
        "name": "CBA"
      }
    ]
  },
  "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/basketball" \
  -H "Authorization: Bearer $APIZERO_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

错误码

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

业务码HTTP说明
0200成功
4000400参数错误
4011401API Key 无效
4013403API Key 已暂停
4014403当前 IP 不在 Key 白名单
4015401此接口需要 API Key
4022402余额不足
4029429调用过快(QPS)
4030429今日免费额度已用完
4040503接口已下线
4041404接口不存在
5000500服务器内部错误
5020502上游暂时不可用
5021502上游返回格式异常
5030502暂无可用节点

调用限制

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

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

更新日志

  • 1.0.02026-09-11

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

免责声明

赛程与比分来自公开体育数据源,可能有延迟或漏场。CBA 为独立备源,覆盖可能少于 NBA。仅供资讯展示,不构成投注建议。

篮球赛事 接入文档|极数本源