加载接口文档…
4
累计调用
1098ms
平均响应
100.00%
服务可用性
20 次/日
免费额度
访问限制
查看更多方案 →无 Key 调用
每日 5 次 · QPS 1
登录免费
当前方案每日 20 次 · QPS 2
黄金会员
每日 4,000 次 · QPS 80
钻石会员
每日 8,000 次 · QPS 30
企业会员
企业接口额度 · QPS 120
接入文档
接口请求地址
https://v1.apizero.cn/api/basketball
接口请求方式
POST
请求参数格式
FORM / QUERY / JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/basketball?status=upcoming&date=2026-09-11&league=nba&limit=80
接口信息备注
查询指定日期处于尚未开赛状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时，matches 返回空数组。
请求参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
| status | string | 可选 · 比赛状态。本子接口取值为 upcoming（尚未开赛）。 · 默认 upcoming · 示例：upcoming |
| date（日期） | string | 可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-11 |
| league | string | 可选 · 联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。 · 示例：nba |
| limit（条数） | int | 可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80 |
请求头说明
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
返回字段说明
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 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"
}免责声明
赛程与比分来自公开体育数据源，可能有延迟或漏场。CBA 为独立备源，覆盖可能少于 NBA。仅供资讯展示，不构成投注建议。