以下是一个全面的篮球数据API通常包含的数据分类和具体内容：

1. 核心比赛与赛程数据

这是最基本的数据，几乎所有API都提供。

• 赛程信息：

  • 比赛ID（唯一标识符）

  • 比赛状态（未开始、进行中、已结束、延期）

  • 比赛日期和时间

  • 比赛场馆和城市

• 参赛球队：

  • 主队和客队信息（ID、名称、缩写）

  • 球队比分（每节比分、全场总分）

• 比赛详情：

  • 当前比赛时间/节次

  • 加时赛信息

  • 裁判信息

2. 球队数据

围绕整个球队表现的数据。

• 总统计：

  • 得分、助攻、篮板（总篮板、前场篮板、后场篮板）

  • 抢断、盖帽、失误、犯规

  • 投篮命中率（总命中数、出手数）

  • 三分命中率（命中数、出手数）

  • 罚球命中率（命中数、出手数）

• 比赛内数据：

  • 快攻得分

  • 禁区得分

  • • 最大领先分数

  • 暂停剩余情况

3. 球员数据

最核心和最详细的部分，分为常规统计和高级数据。

• 基础个人数据：

  • 球员ID、姓名、球衣号码、位置

  • 出场时间

  • 得分

  • 助攻、篮板（进攻/防守）

  • 抢断、盖帽

  • 失误、个人犯规

  • 投篮数据：FGM-A（命中/出手）、3PM-A（三分命中/出手）、FTM-A（罚球命中/出手）

• 场上位置数据：

  • 正负值（+/-）

• 深度数据（部分API提供）：

  • 两双、三双信息

  • 球员在场/不在场时球队的攻防效率

4. 比赛进程数据（Play-by-Play）

逐秒或逐事件记录比赛的每一个细节，用于深度分析和数据可视化。

• 事件类型：

  • 投篮（命中/不中）、助攻者

  • 犯规（普通犯规、投篮犯规、进攻犯规）、被犯规者、罚球结果

  • 篮板（进攻篮板、防守篮板）、篮板者

  • 失误、抢断

  • 换人

  • 暂停

  • 每节开始/结束

• 事件详情：

  • 发生时间（比赛时钟和节次）

  • 相关球员

  • 发生位置（坐标x， y， 如果可用）

  • 得分差值

5. 联赛与球队信息

静态或半静态的参考数据。

• 联赛结构：

  • 联盟、赛区、分区信息

  • 赛季列表和年份

• 球队信息：

  • 球队ID、全名、缩写、城市

  • 主场地名称

  • 球队颜色、Logo链接

• 球员信息：

  • 球员ID、全名、身高、体重、出生日期

  • 选秀信息（年份、轮次、顺位）

  • 国籍

  • 效力过的球队历史

6. 排名与胜负记录

联赛的宏观视图。

• 赛区/联盟排名

• 胜负记录（胜场、负场、胜率）

• 主客场记录

• 赛区内战绩

• 连胜/连负记录

7. 高级分析与球员追踪数据（Premium Tier）

这些通常是更专业、更昂贵的API服务，特别是来自官方渠道（如NBA的Stats API）。

• 投篮图表数据：

  • 每次投篮的详细坐标（x， y）

  • 投篮距离

  • 投篮防守距离

  • 投篮类型（跳投、上篮、扣篮）

• 球员追踪数据：

  • 球员跑动速度、距离

  • 触球次数、持球时间

  • 传球次数、潜在助攻

  • 防守投篮干扰

• 高阶数据：

  • 球员效率评级（PER）

  • 真实投篮命中率（TS%）

  • 使用率（USG%）

  • 进攻/防守评分（OffRtg， DefRtg）

  • 胜利贡献值（WS）

总结表格

接入建议：

1. 明确需求：你是在做实时比分App、梦幻体育游戏、数据分析网站还是学术研究？这决定了你需要哪类数据。

2. 选择供应商：比较不同API提供商的数据范围、更新频率、调用限制、费用和文档完整性。

3. 阅读文档：仔细阅读官方API文档，了解如何认证（API Key）、如何构建请求、返回的数据格式（通常是JSON）以及错误代码。

希望这个详细的列表能帮助你全面了解篮球数据API的世界！