加载接口文档…
篮球赛事
API按日期查询篮球赛程与比分，覆盖美国男子职业篮球联赛、美国女子职业篮球联赛、美国大学体育协会男子篮球联赛、中国男子篮球职业联赛。返回开赛时间、比分…
由 极数本源 提供·更新于 最近
0
累计调用
—
平均响应
—
服务可用性
访问限制
查看更多方案 →未携带 API Key
无匿名额度，须携带 API Key
登录免费
无登录免费额度
免费试用
一次性 10 次
接入文档
接口请求地址
https://v1.apizero.cn/api/basketball
接口请求方式
POST
请求参数格式
FORM / QUERY / JSON
接口返回格式
APPLICATION/JSON
接口请求示例
https://v1.apizero.cn/api/basketball?action=matches&status=live&date=2026-09-11&league=nba&limit=80
接口信息备注
查询指定日期处于进行中状态的比赛的赛程、比分及比赛状态。可通过 league 限定单一联赛。无符合条件的比赛时，matches 返回空数组。
请求参数说明
status（状态）string
可选 · 比赛状态。本子接口取值为 live（进行中）。 · 默认 live · 示例：live
date（日期）string
可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-11
league（联赛）string
可选 · 联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。 · 示例：nba
limit（条数）int
可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80
| 名称 | 类型 | 说明 |
|---|---|---|
| status（状态） | string | 可选 · 比赛状态。本子接口取值为 live（进行中）。 · 默认 live · 示例：live |
| date（日期） | string | 可选 · 比赛日期。格式 YYYY-MM-DD 或 YYYYMMDD，缺省为北京时间当日。 · 示例：2026-09-11 |
| league（联赛） | string | 可选 · 联赛代码。用于限定单一联赛；缺省为全部已覆盖联赛。 · 示例：nba |
| limit（条数） | int | 可选 · 返回条数。取值范围 1–200，缺省 80。 · 默认 80 · 示例：80 |
请求头说明
Authorizationstring
必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
返回字段说明
summaryobject
sport / date / league / status / count / total / live / generated_at
statusstring
筛选状态：all / live / upcoming / finished
totalnumber
当日该范围未截断前的场次总数
livenumber
本次返回中进行中的场次数
generated_atstring
生成时间（北京时间）
matchesarray
赛程：进行中 → 未开赛按时间 → 已结束
idstring
场次 ID
league_namestring
联赛中文名
start_atstring
开赛时间（北京时间）
statusstring
live / upcoming / finished
homeobject
主队 name / short / logo / score
namestring
名称
shortstring
short
logostring
logo
scorenumber
score
awayobject
客队 name / short / logo / score
namestring
名称
shortstring
short
logostring
logo
scorenumber
score
tipsstring
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| summary | object | sport / date / league / status / count / total / live / generated_at | ||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||
| 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",
"season": "2026",
"start_at": "2026-09-11 09:00:00",
"start_ts": 1789088400,
"status": "finished",
"status_text": "已结束",
"period": 4,
"clock": "0.0",
"venue": "Crypto.com Arena",
"city": "Los Angeles",
"home": {
"name": "Los Angeles Lakers",
"short": "LAL",
"logo": "https://a.espncdn.com/i/teamlogos/nba/500/lal.png",
"score": 112
},
"away": {
"name": "Golden State Warriors",
"short": "GSW",
"logo": "https://a.espncdn.com/i/teamlogos/nba/500/gs.png",
"score": 108
}
}
]
},
"tips": "极数本源 · https://apizero.cn"
}