balldontlie logo

balldontlie

balldontlie

NBA / WNBA / NFL / MLB / NHL 等 20+ 联赛的体育数据 API,按运动分别订阅:免费档只开放 Teams / Players / Games 且限 5 req/min,All-Star($9.99/月)放开到 60 req/min 并解锁球员单场数据与伤病,GOAT($39.99/月)600 req/min 含赛季均值、高阶数据、Box Score、Standings、赔率与球员道具盘

访问站点 ↗文档 ↗健康巡检 12 小时前
适合什么时候用

API key 认证最简单:所有请求带 `Authorization: YOUR_API_KEY` 头即可,没有 OAuth 握手、没有签名,注册即拿 key,5 分钟跑通第一个请求

先注意什么

免费档几乎只能看不能用:除了 Teams / Players / Games,赛季均值、Box Score、Standings、Leaders、赔率全锁在 GOAT($39.99/月)后面;想要球员单场数据最低也得上 All-Star($9.99/月)

第一步先查

打开 balldontlie.io 注册账号拿到 API key。所有请求基址是 https://api.balldontlie.io/v1/(赔率等部分功能在 v2),认证只需带 HTTP 头 `Authorization: YOUR_API_KEY`(注意没有 Bearer 前缀)。先用免费档打 GET /teams 验证 key 生效,再打 GET /players?search=curry 试搜索。需要球员单场数据就升 All-Star($9.99/月),需要 season_averages / box_scores / standings / 赔率就升 GOAT($39.99/月)。轮询比分时把请求频率压在档位的 req/min 限制内,免费档 5 req/min 基本只够开发调试。

认证
api_key
CORS
不支持
HTTPS
注册
需要
延迟
753 ms
协议
REST
计费
freemium

可用率 · 30 天窗口

巡检: 19可用率: 100%平均延迟: 701ms
01

关于这个 API

balldontlie 是一个面向开发者的体育数据 API,最早因为「免费、好用、不要 key 就能拉 NBA 数据」在社区里出名,现在已经扩展到 NBA、WNBA、NFL、MLB、NHL、英超等 20+ 联赛,并改成了 API key + 分档订阅模式。基址是 https://api.balldontlie.io/v1/,认证方式极简:每个请求带一个 HTTP 头 `Authorization: YOUR_API_KEY`,没有 OAuth、没有签名。NBA 这一块的端点覆盖很全:Teams、Players、Games、Game Player Stats、Season Averages、Team Season Averages、Game Advanced Stats(v1/v2)、Box Scores(实时与历史)、Lineups、Plays(逐回合)、Player Injuries、Standings、Leaders、Betting Odds、Player Props、Contracts。但这些端点是按订阅档位逐步解锁的:免费档($0,5 req/min)只开放 Teams / Players / Games;All-Star($9.99/月,60 req/min)追加 Game Player Stats、Active Players、Player Injuries;GOAT($39.99/月,600 req/min)解锁全部,包括赛季均值、高阶数据、Box Score、阵容、逐回合、Standings、Leaders、赔率、球员道具盘和合同数据。最贵的 All-Access($299.99/月,600 req/min)是唯一一档跨全部运动的订阅,其余档位都是「按运动单独计费」——这意味着做 NBA + NFL 双联赛产品,要么买两份 GOAT,要么直接上 All-Access,成本台阶比较陡。和官方 stats.nba.com(未文档化、无 key、随时可能 429 或改接口)相比,balldontlie 的最大价值是稳定 + 公开标价 + 简单认证,适合独立开发者和小团队快速起步;和 API-Sports(API-NBA)相比,balldontlie 的速率限制是「每分钟 N 次」而非「每天 N 次」,免费档 5 req/min 几乎只够调试,真正上生产建议至少 All-Star。两个常见踩坑:第一,很多人以为免费档能拉比分和球员数据,实际免费档连 Games 的 box score 都没有,球员单场数据最低要 All-Star;第二,速率是按分钟卡的,写轮询循环时一定要做节流,不然秒级请求会直接撞 429。

02

你可以做什么

  • 1球队/球员展示页:免费档的 /teams 和 /players 就够拉一个 NBA 30 队名册 + 球员档案的静态站,不花钱也不用爬 stats.nba.com
  • 2赛程与比分小程序:/games 支持按 date、season、team_ids 过滤,配合 box_scores(GOAT 档)做实时比分推送;免费档轮询要卡死 5 req/min,生产建议直接上 All-Star
  • 3幻想体育 / 数据看板:season_averages + advanced_stats + leaders(GOAT 档)一套拉完做球员对比雷达图,赔率和 player props 走 v2 odds 端点
03

优劣对比

优点

  • API key 认证最简单:所有请求带 `Authorization: YOUR_API_KEY` 头即可,没有 OAuth 握手、没有签名,注册即拿 key,5 分钟跑通第一个请求
  • 价格透明且阶梯清晰:Free(5 req/min)→ All-Star $9.99(60 req/min)→ GOAT $39.99(600 req/min),全部公开标价,比 SportsDataIO 那种「联系销售拿报价」对独立开发者友好得多
  • 一套 API 覆盖 20+ 联赛:NBA、WNBA、NFL、MLB、NHL、英超等共用同一套认证和分页约定,做多运动产品时不用学多套 SDK;All-Access($299.99/月)一次解锁全部运动

注意事项

  • 免费档几乎只能看不能用:除了 Teams / Players / Games,赛季均值、Box Score、Standings、Leaders、赔率全锁在 GOAT($39.99/月)后面;想要球员单场数据最低也得上 All-Star($9.99/月)
  • 按运动分别计费:GOAT $39.99 只覆盖一个运动,做 NBA + NFL 双联赛要么买两份要么直接上 All-Access $299.99/月,成本跳跃明显
  • 速率限制按分钟卡得很死:免费档 5 req/min 实测做任何轮询都不够;不像 API-Sports 给的是「每天 N 次」配额,balldontlie 是「每分钟 N 次」,突发流量容易撞 429
04

官方快速开始

在官方文档查看快速开始:docs.balldontlie.io

05

快速开始

打开 balldontlie.io 注册账号拿到 API key。所有请求基址是 https://api.balldontlie.io/v1/(赔率等部分功能在 v2),认证只需带 HTTP 头 `Authorization: YOUR_API_KEY`(注意没有 Bearer 前缀)。先用免费档打 GET /teams 验证 key 生效,再打 GET /players?search=curry 试搜索。需要球员单场数据就升 All-Star($9.99/月),需要 season_averages / box_scores / standings / 赔率就升 GOAT($39.99/月)。轮询比分时把请求频率压在档位的 req/min 限制内,免费档 5 req/min 基本只够开发调试。

06

常见问题

balldontlie 还免费吗?还需要 API key 吗?+

现在需要 key 了。早期 balldontlie 是无 key 免费访问,现在改成了 API key + 分档订阅。免费档($0)仍然存在,但只开放 Teams / Players / Games 三类端点,限速 5 req/min,且没有比分明细、球员数据、赛季均值和赔率。注册即可拿 key,认证只需带 `Authorization: YOUR_API_KEY` 头。

balldontlie 免费档能拿到球员单场数据和比分吗?+

不能。免费档只有 Teams、Players、Games 三个端点,连 Box Score 都没有。球员单场数据(Game Player Stats)和伤病最低要 All-Star($9.99/月);赛季均值、Box Score、Standings、Leaders、赔率、球员道具盘则要 GOAT($39.99/月)。

balldontlie 和官方 stats.nba.com 有什么区别?+

官方 stats.nba.com 没有公开 API、不发 key、端点未文档化,靠社区逆向(如 Python 的 nba_api 包)访问,随时可能 429 限流或改接口,没有 SLA。balldontlie 是正规商业 API:公开标价、稳定端点、简单 key 认证、有文档。代价是要付费才能解锁完整数据,且数据深度(如历史逐回合的细粒度)不一定有 stats.nba.com 全。

balldontlie 的订阅是按运动还是全包?+

除最高的 All-Access($299.99/月,覆盖全部 20+ 运动)外,Free / All-Star / GOAT 都是按单个运动计费。也就是说一份 GOAT $39.99 只覆盖一个运动(比如只 NBA)。要同时做 NBA + NFL,要么买两份 GOAT,要么直接上 All-Access。

07

技术细节

CORS: NoHTTPS: Yes注册: Yes开源: No
认证方式
api_key
计费
freemium
速率限制
Rate limits are per-tier, per-sport: Free = 5 requests/minute, All-Star ($9.99/mo) = 60 requests/minute, GOAT ($39.99/mo) = 600 requests/minute, All-Access ($299.99/mo, all sports) = 600 requests/minute. Limits are enforced per minute, not per day.
免费额度
Free tier ($0): 5 requests/minute, NBA endpoints limited to Teams, Players, and Games (no stats, box scores, standings, or odds). Pagination via cursor; the free tier is meant for prototyping, not production traffic.
协议
REST
SDK
JavaScript, Python
响应时间
753 ms
上次巡检
2026/5/30 07:34:45
08

标签