DECISION MODEL DATA · 体育赛事

NBA

NBA 比赛资料、球队和球员目录，以及独立历史汇编。

API 调用说明

能回答的问题

某场比赛的对阵、比分和状态是什么？
球员与球队资料如何关联？

状态与已知缺口

部分可用

仅覆盖本页列出的已取得数据；提供方的全部产品、历史期次及修订版本未全部覆盖。

比赛、球队和球员来自不同来源，标识及时间范围需分别核对
完整技术统计与逐季官方箱分未齐，旧名录不代表当前阵容

提供方

NBA · 官方来源
ESPN · 替代来源
BALLDONTLIE · 替代来源
NBA 历史资料汇编 · 归档来源

PRODUCT

ESPN NBA 赛事对象

nba_event_cards

一条 ESPN 比赛对象，包含日期、赛季、比赛状态及对阵数组；比分与状态位于比赛对象内部。

粒度: 每行是一条提供方记录的观察版本；业务对象可跨快照重复
时间范围: 2025-06-23T00:00Z ～ 2027-04-12T00:30Z · 赛事日期时间
采集时间: 2026-10-06T07:48:37.537412Z ～ 2026-10-06T11:55:46.808230Z
记录数: 1,274

API 调用示例

使用现有 Friends API Key；分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET

/api/v1/data/datasets/decision_model/records/rows?product=nba_event_cards&limit=100

字段表 · 9 个字段

字段名	中文说明
`competitions`	赛事内对阵数组，可包含多场比赛
`date`	提供方标示日期
`id`	提供方对象标识
`links`	提供方公开相关链接
`name`	名称
`season`	赛季标识
`shortName`	提供方简称
`status`	比赛或对象状态；需据此区分计划、进行中和已结束
`uid`	作者标识

PRODUCT

BALLDONTLIE NBA 比赛

nba_games

一条 NBA 比赛记录，包含双方球队、比分、赛季、比赛状态及可得的分节数据；较早资料可能缺字段。

粒度: 每行是一条提供方记录的观察版本；业务对象可跨快照重复
时间范围: 1946-11-01 ～ 2027-04-11 · 比赛日期
采集时间: 2026-10-06T08:10:28.631908Z ～ 2026-10-06T15:02:21.560634Z
记录数: 74,376

API 调用示例

使用现有 Friends API Key；分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET

/api/v1/data/datasets/decision_model/records/rows?product=nba_games&limit=100

字段表 · 33 个字段

字段名	中文说明
`date`	提供方标示日期
`datetime`	比赛时间字段
`home_in_bonus`	主队是否处于罚球奖励状态
`home_ot1`	主队第1次加时得分
`home_ot2`	主队第2次加时得分
`home_ot3`	主队第3次加时得分
`home_q1`	主队第1节得分
`home_q2`	主队第2节得分
`home_q3`	主队第3节得分
`home_q4`	主队第4节得分
`home_team`	主队标识或对象
`home_team_score`	主队总比分
`home_timeouts_remaining`	主队剩余暂停次数
`id`	提供方对象标识
`ist_stage`	季中赛阶段原值
`period`	当前节次
`postponed`	是否延期
`postseason`	是否季后赛
`season`	赛季年份
`status`	比赛或对象状态；需据此区分计划、进行中和已结束
`status_state`	提供方比赛状态枚举
`time`	原文时间或用时，依所属产品口径
`visitor_in_bonus`	客队是否处于罚球奖励状态
`visitor_ot1`	客队第1次加时得分
`visitor_ot2`	客队第2次加时得分
`visitor_ot3`	客队第3次加时得分
`visitor_q1`	客队第1节得分
`visitor_q2`	客队第2节得分
`visitor_q3`	客队第3节得分
`visitor_q4`	客队第4节得分
`visitor_team`	客队标识或对象
`visitor_team_score`	客队总比分
`visitor_timeouts_remaining`	客队剩余暂停次数

PRODUCT

NBA 官方比赛卡片

nba_official_game_cards

一条 NBA 官网比赛卡片，cardData 内含比赛标识、对阵、时间和状态；可能包含季前赛。

粒度: 每行是一条提供方记录的观察版本；业务对象可跨快照重复
时间范围: 2026-10-03 ～ 2026-10-03 · 卡片中比赛日期时间
采集时间: 2026-10-04T07:55:34.872927Z ～ 2026-10-04T12:01:44.443604Z
记录数: 2

API 调用示例

使用现有 Friends API Key；分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET

/api/v1/data/datasets/decision_model/records/rows?product=nba_official_game_cards&limit=100

字段表 · 4 个字段

字段名	中文说明
`cardData`	官方比赛卡片对象，含比赛标识、对阵及状态
`cardId`	官方卡片标识
`cardType`	卡片类型
`selected_date`	提供方响应对应的选定日期

PRODUCT

BALLDONTLIE NBA 球员目录

nba_players

一条球员资料，包含姓名、球队对象、位置、身高、体重和选秀信息；不等于某赛季完整报名名单。

粒度: 每行是一条提供方记录的观察版本；业务对象可跨快照重复
时间范围: 未提供～未提供 · 球员资料观察时点
采集时间: 2026-10-06T08:09:16.029510Z ～ 2026-10-06T12:06:15.256496Z
记录数: 7,470

API 调用示例

使用现有 Friends API Key；分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET

/api/v1/data/datasets/decision_model/records/rows?product=nba_players&limit=100

字段表 · 13 个字段

字段名	中文说明
`college`	大学名称
`country`	国家或地区
`draft_number`	选秀顺位
`draft_round`	选秀轮次
`draft_year`	选秀年份
`first_name`	名字
`height`	身高原文
`id`	提供方对象标识
`jersey_number`	球衣号码
`last_name`	姓氏
`position`	场上位置
`team`	球队、车队或团队，依产品
`weight`	体重原文

PRODUCT

NBA 历史球员赛季名录

nba_players_mirror

一条独立汇编的球员、赛季和球队关系记录；同一球员可跨赛季或球队出现。

粒度: 每行是一条提供方记录的观察版本；业务对象可跨快照重复
时间范围: 2009 ～ 2019 · 名录赛季
采集时间: 2026-10-06T08:10:50.889349Z ～ 2026-10-06T08:10:50.889349Z
记录数: 7,228

API 调用示例

使用现有 Friends API Key；分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET

/api/v1/data/datasets/decision_model/records/rows?product=nba_players_mirror&limit=100

字段表 · 5 个字段

字段名	中文说明
`PLAYER_ID`	球员标识
`PLAYER_NAME`	球员姓名
`SEASON`	赛季
`TEAM_ID`	球队标识
`record_role`	提供方原生字段；含义暂未补充。

PRODUCT

BALLDONTLIE NBA 球队目录

nba_teams

一条球队资料，含名称、缩写、城市、联盟和分区。

粒度: 每行是一条提供方记录的观察版本；业务对象可跨快照重复
时间范围: 未提供～未提供 · 球队资料观察时点
采集时间: 2026-10-06T08:09:04.082307Z ～ 2026-10-06T08:09:04.082307Z
记录数: 89

API 调用示例

使用现有 Friends API Key；分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET

/api/v1/data/datasets/decision_model/records/rows?product=nba_teams&limit=100

字段表 · 7 个字段

字段名	中文说明
`abbreviation`	球队缩写
`city`	球队城市
`conference`	所属联盟
`division`	所属分区
`full_name`	全名
`id`	提供方对象标识
`name`	名称

PRODUCT

NBA 历史球队资料

nba_teams_mirror

一条独立汇编的球队资料，含场馆、成立年份与历史管理人员；不能当作最新球队配置。

粒度: 每行是一条提供方记录的观察版本；业务对象可跨快照重复
时间范围: 1946 ～ 2019 · 资料版本及年度字段
采集时间: 2026-10-06T08:10:51.893103Z ～ 2026-10-06T08:10:51.893103Z
记录数: 30

API 调用示例

使用现有 Friends API Key；分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET

/api/v1/data/datasets/decision_model/records/rows?product=nba_teams_mirror&limit=100

字段表 · 15 个字段

字段名	中文说明
`ABBREVIATION`	球队简称
`ARENA`	球馆名称
`ARENACAPACITY`	球馆容量
`CITY`	所在城市
`DLEAGUEAFFILIATION`	发展联盟附属球队
`GENERALMANAGER`	球队总经理
`HEADCOACH`	球队主教练
`LEAGUE_ID`	联盟标识
`MAX_YEAR`	资料覆盖的结束年份
`MIN_YEAR`	资料覆盖的起始年份
`NICKNAME`	球队昵称
`OWNER`	球队拥有者
`TEAM_ID`	球队标识
`YEARFOUNDED`	成立年份
`record_role`	提供方原生字段；含义暂未补充。

数据观测时间 2026-10-06T17:38:47.854586Z