篮球赛事
basketballPOSThttps://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鉴权
请求地址为 POST /api/basketball。请按子接口分别传入对应参数。返回时间均为北京时间。
获取 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。 |
今日赛程
查询北京时间当日美国男子职业篮球联赛、美国女子职业篮球联赛的赛程、比分及比赛状态。可通过 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.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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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"
}进行中
查询指定日期处于进行中状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时,matches 返回空数组。
https://v1.apizero.cn/api/basketball?status=live&date=2026-09-11&league=nba&limit=80
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| status | string | 否 | 比赛状态。本子接口取值为 live(进行中)。 | live |
| date(日期) | string | 否 | 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。 | 2026-09-11 |
| league | string | 否 | 联赛代码。用于限定单一联赛;缺省为全部已覆盖联赛。 | nba |
| limit(条数) | int | 否 | 返回条数。取值范围 1–200,缺省 80。 | 80 |
{
"status": "live",
"date": "2026-09-11",
"league": "nba",
"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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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"
}未开赛
查询指定日期处于尚未开赛状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时,matches 返回空数组。
https://v1.apizero.cn/api/basketball?status=upcoming&date=2026-09-11&league=nba&limit=80
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| status | string | 否 | 比赛状态。本子接口取值为 upcoming(尚未开赛)。 | upcoming |
| date(日期) | string | 否 | 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。 | 2026-09-11 |
| league | string | 否 | 联赛代码。用于限定单一联赛;缺省为全部已覆盖联赛。 | nba |
| limit(条数) | int | 否 | 返回条数。取值范围 1–200,缺省 80。 | 80 |
{
"status": "upcoming",
"date": "2026-09-11",
"league": "nba",
"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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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"
}已结束
查询指定日期处于已结束状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时,matches 返回空数组。
https://v1.apizero.cn/api/basketball?status=finished&date=2026-09-11&league=nba&limit=80
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| status | string | 否 | 比赛状态。本子接口取值为 finished(已结束)。 | finished |
| date(日期) | string | 否 | 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。 | 2026-09-11 |
| league | string | 否 | 联赛代码。用于限定单一联赛;缺省为全部已覆盖联赛。 | nba |
| limit(条数) | int | 否 | 返回条数。取值范围 1–200,缺省 80。 | 80 |
{
"status": "finished",
"date": "2026-09-11",
"league": "nba",
"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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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
查询美国男子职业篮球联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。
https://v1.apizero.cn/api/basketball?league=nba&date=2026-09-11&status=all&limit=80
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| league | string | 否 | 联赛代码。本子接口取值为 nba(美国男子职业篮球联赛)。 | nba |
| date(日期) | string | 否 | 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。 | 2026-09-11 |
| status | string | 否 | 比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。 | all |
| limit(条数) | int | 否 | 返回条数。取值范围 1–200,缺省 80。 | 80 |
{
"league": "nba",
"date": "2026-09-11",
"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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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
查询美国女子职业篮球联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。
https://v1.apizero.cn/api/basketball?league=wnba&date=2026-09-11&status=all&limit=80
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| league | string | 否 | 联赛代码。本子接口取值为 wnba(美国女子职业篮球联赛)。 | wnba |
| date(日期) | string | 否 | 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。 | 2026-09-11 |
| status | string | 否 | 比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。 | all |
| limit(条数) | int | 否 | 返回条数。取值范围 1–200,缺省 80。 | 80 |
{
"league": "wnba",
"date": "2026-09-11",
"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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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 男篮
查询美国大学体育协会男子篮球联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。
https://v1.apizero.cn/api/basketball?league=ncaa&date=2026-09-11&status=all&limit=80
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| league | string | 否 | 联赛代码。本子接口取值为 ncaa(美国大学体育协会男子篮球联赛)。 | ncaa |
| date(日期) | string | 否 | 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。 | 2026-09-11 |
| status | string | 否 | 比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。 | all |
| limit(条数) | int | 否 | 返回条数。取值范围 1–200,缺省 80。 | 80 |
{
"league": "ncaa",
"date": "2026-09-11",
"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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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
查询中国男子篮球职业联赛指定日期的赛程、比分及比赛状态。时间均为北京时间。该联赛使用独立数据源。
https://v1.apizero.cn/api/basketball?league=cba&date=2026-09-11&status=all&limit=80
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| league | string | 否 | 联赛代码。本子接口取值为 cba(中国男子篮球职业联赛)。 | cba |
| date(日期) | string | 否 | 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD,缺省为北京时间当日。 | 2026-09-11 |
| status | string | 否 | 比赛状态。取值 all(全部)、live(进行中)、upcoming(未开赛)、finished(已结束)。 | all |
| limit(条数) | int | 否 | 返回条数。取值范围 1–200,缺省 80。 | 80 |
{
"league": "cba",
"date": "2026-09-11",
"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 | 赛程:进行中 → 未开赛按时间 → 已结束 | ||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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"
}联赛列表
返回本接口支持的联赛代码与名称,不请求上游数据源。
https://v1.apizero.cn/api/basketball?action=leagues
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| action(操作) | string | 否 | 操作类型。本子接口取值为 leagues(返回联赛目录)。 | leagues |
{
"action": "leagues"
}返回结果
| 字段 | 类型 | 说明 | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| sport | string | basketball | |||||||||
| count | number | 联赛数量 | |||||||||
| leagues | array | id / code / name | |||||||||
| |||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · 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 | 说明 |
|---|---|---|
| 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
上架按日期查询赛程与比分 支持联赛过滤与进行中筛选
免责声明
赛程与比分来自公开体育数据源,可能有延迟或漏场。CBA 为独立备源,覆盖可能少于 NBA。仅供资讯展示,不构成投注建议。