API-NBA (API-Sports)

API-Sports 旗下的 NBA 数据 API，提供 leagues / seasons / teams / players / games / statistics / standings 等端点，按「每天请求数」配额计费：免费档 100 req/day，Pro $19/月 7,500 req/day，Ultra $29/月 75,000 req/day，Mega $39/月 150,000 req/day，可直连 v2.nba.api-sports.io 或经 RapidAPI 访问

访问站点 ↗文档 ↗

适合什么时候用

免费档不锁端点，只锁次数：免费 100 req/day 就能访问全部端点和全部赛季，和 balldontlie「免费档锁端点」的策略相反，评估期更容易摸清全貌

先注意什么

免费档 100 req/day 极易耗尽：任何带轮询或多用户的应用都撑不住，评估完基本就得升 Pro（$19/月）

第一步先查

两种接入方式选一种。直连：到 api-sports.io 注册拿 API key，基址 https://v2.nba.api-sports.io/，每个请求带 `x-apisports-key: YOUR_KEY` 头，先打 GET /leagues 验证。走 RapidAPI：在 RapidAPI 上订阅 API-NBA，请求带 `x-rapidapi-key` 和 `x-rapidapi-host: v2.nba.api-sports.io` 两个头。免费档 100 req/day 适合评估，确认端点和数据结构后按流量升 Pro（$19/月，7,500 req/day）或更高。注意配额是按天而非按分钟，写定时任务时按天预算请求数。

认证

api_key

CORS

HTTPS

是

需要

协议

REST

计费

freemium

可用率 · 30 天窗口

日常巡检数据收集后将在此处显示。

关于这个 API

API-NBA 是 API-Sports（同一家公司还运营 API-Football、API-Basketball 等）旗下的 NBA 专用数据 API，当前主版本是 v2，基址 https://v2.nba.api-sports.io/。它提供 leagues、seasons、teams、players、games、statistics、standings 等端点，覆盖赛程、比分、球队/球员数据和常规赛排名。认证有两条路径：直连 API-Sports 用 `x-apisports-key` 头；经 RapidAPI 访问则用 `x-rapidapi-key` + `x-rapidapi-host: v2.nba.api-sports.io` 两个头——很多人搜「api nba」其实落到的是 RapidAPI 上的这个 API-NBA。计费模型和 balldontlie 有个本质差异：API-NBA 是按「每天请求数」配额，且所有档位都能访问全部端点，免费档（$0）给 100 req/day，Pro（$19/月）7,500 req/day，Ultra（$29/月）75,000 req/day，Mega（$39/月）150,000 req/day，更高可到约 150 万 req/day。对比之下 balldontlie 是按「每分钟请求数」+「按端点解锁」。所以选型逻辑很清晰：如果你要的是「全部端点都能用、只是别打太频繁」，API-NBA 的免费档更适合摸底；如果你要的是「高并发实时轮询比分」，要看 balldontlie 的 req/min 档位。两个常见踩坑：第一，免费档 100 req/day 真的很少，任何多用户或轮询应用评估完就得升级，别拿它当生产配额；第二，走 RapidAPI 时计费和限额是 RapidAPI 那一套，和直连 API-Sports 的官方档位不完全对应，接入前务必确认自己是被哪一侧计量，否则容易出现「以为免费结果被 RapidAPI 套餐扣费」的情况。数据深度方面，API-NBA 对常规的赛程/比分/排名/球队球员统计覆盖得很实用，但极细粒度的逐回合和高阶数据不如官方 stats.nba.com 全，重度分析场景可能要再补源。

你可以做什么

1比分与赛程后端：/games 按日期/赛季/球队拉赛程和比分，按天配额计费意味着低频展示站用免费档 100 req/day 就能跑
2球员与球队统计：/statistics + /standings 拉常规赛排名和球队/球员数据，做赛季数据看板；Pro $19/月的 7,500 req/day 足够中小流量
3RapidAPI 集成：很多人搜「api nba」直接落到 RapidAPI 上的 API-NBA，用 x-rapidapi-key + x-rapidapi-host 两个头即可接入，省去单独注册 API-Sports 账号

优劣对比

优点

免费档不锁端点，只锁次数：免费 100 req/day 就能访问全部端点和全部赛季，和 balldontlie「免费档锁端点」的策略相反，评估期更容易摸清全貌
两条接入路径：既可直连 v2.nba.api-sports.io（`x-apisports-key` 头），也可走 RapidAPI（`x-rapidapi-key` + `x-rapidapi-host`），后者对已有 RapidAPI 账号的人零摩擦
官方维护多语言示例：文档里给了 Node.js、PHP、Go、C#、Java、JavaScript、cURL 的请求示例，照抄即可，跨语言团队上手快

注意事项

免费档 100 req/day 极易耗尽：任何带轮询或多用户的应用都撑不住，评估完基本就得升 Pro（$19/月）
数据深度不如官方 stats.nba.com：高阶/逐回合的细粒度数据有限，重度数据分析场景可能需要补别的源
走 RapidAPI 会多一层计费和延迟：RapidAPI 有自己的套餐和限额体系，和直连 API-Sports 的档位不完全一致，接入前要对清楚是按哪边计费

官方快速开始

在官方文档查看快速开始：api-sports.io

快速开始

常见问题

API-NBA（API-Sports）的免费档有多少配额？+

免费档 100 req/day，且能访问全部端点和全部赛季——限制只在每天请求数，不锁功能。这点和 balldontlie 相反（balldontlie 免费档锁端点）。100 req/day 适合评估和极低流量的爱好项目，多用户或轮询应用基本要升 Pro（$19/月，7,500 req/day）。

API-NBA 怎么认证？直连和 RapidAPI 有什么区别？+

直连 API-Sports：基址 https://v2.nba.api-sports.io/，请求带 `x-apisports-key: YOUR_KEY` 头。走 RapidAPI：请求带 `x-rapidapi-key` 和 `x-rapidapi-host: v2.nba.api-sports.io` 两个头。区别主要在计费——RapidAPI 有自己的套餐和限额，和直连档位不完全一致，接入前要确认按哪边计量。

API-NBA 和 balldontlie 怎么选？+

看计费维度。API-NBA 按「每天请求数」配额，所有档位都能访问全部端点，适合「端点全开、别太频繁」的场景。balldontlie 按「每分钟请求数」+「按端点解锁」，适合「高并发实时轮询」但要为完整端点付费（GOAT $39.99/月）。价格上两家月费接近（$19~$39），主要差异是计量方式和免费档策略。

技术细节

CORS: ?HTTPS: Yes注册: Yes开源: No

认证方式: api_key
计费: freemium
速率限制: Metered per day, not per minute: Free = 100 requests/day, Pro ($19/mo) = 7,500 requests/day, Ultra ($29/mo) = 75,000 requests/day, Mega ($39/mo) = 150,000 requests/day. Higher volumes are available up to ~1.5M requests/day. There is also a per-minute burst cap on each tier.
免费额度: Free tier ($0): 100 requests/day with access to all endpoints and all seasons (no feature gating — the limit is purely on daily request count, unlike balldontlie which gates endpoints by tier). Good for evaluation and low-traffic hobby projects.
协议: REST
SDK: JavaScript, Python, PHP, Go, C#, Java