NBA API (nbaapi.com)

Base URL

https://api.server.nbaapi.com/api

Authentication

No API key and no account.

Rate limit

No published limit. It is a community-run mirror — page sensibly rather than pulling whole seasons in a loop.

Pricing

Free.

CORS

Enabled — callable directly from browser JavaScript

Official docs

Read the docs

Every request below was executed against the live API on 2026-08-21, and the response shown is the real body it returned — not an illustration.

curl 'https://api.server.nbaapi.com/api/playertotals?season=2024&pageSize=1'

const res = await fetch("https://api.server.nbaapi.com/api/playertotals?season=2024&pageSize=1");
if (!res.ok) throw new Error(`Request failed: ${res.status}`);
const data = await res.json();
console.log(data);

import requests

res = requests.get("https://api.server.nbaapi.com/api/playertotals?season=2024&pageSize=1", timeout=20)
res.raise_for_status()
print(res.json())

{
  "data": [
    {
      "playerId": "doncilu01",
      "playerName": "Luka Dončić",
      "position": "PG",
      "age": 24,
      "games": 70,
      "gamesStarted": 70,
      "minutesPg": 2624,
      "fieldGoals": 804,
      "fieldAttempts": 1652,
      "fieldPercent": 0.487,
      "threeFg": 284,
      "threeAttempts": 744,
      "threePercent": 0.382,
      "twoFg": 520,
      "twoAttempts": 908,
      "twoPercent": 0.573,
      "effectFgPercent": 0.573,
      "ft": 478,
      "ftAttempts": 608,
      "ftPercent": 0.786,
      "offensiveRb": 59,
      "defensiveRb": 588,
      "totalRb": 647,
      "assists": 686,
      "steals": 99,
      "blocks": 38,
      "turnovers": 282,
      "personalFouls": 149,
      "points": 2370,
      "team": "DAL",
      "season": 2024,
      "isPlayoff": false
    }
  ],
  "pagination": {
    "total": 949,
    "page": 1,
    "pageSize": 1,
    "pages": 949
  }
}

data[].playerId / playerNamestring

Basketball-Reference style player slug and display name. The slug is stable across seasons; the name is not.

data[].position / age / teamstring / integer

Listed position, age during that season, and three-letter team code.

data[].games / gamesStarted / minutesPginteger

Appearances, starts and total minutes. Despite the name, `minutesPg` in the captured record is a season total, not a per-game average.

data[].fieldGoals / fieldAttempts / fieldPercentinteger / float

Overall shooting from the floor.

data[].threeFg / threeAttempts / threePercentinteger / float

Three-point splits.

data[].twoFg / twoAttempts / twoPercentinteger / float

Two-point splits.

data[].effectFgPercentfloat

Effective field-goal percentage, weighting three-pointers at 1.5. Use this rather than raw FG% for comparisons.

data[].ft / ftAttempts / ftPercentinteger / float

Free-throw shooting.

data[].offensiveRb / defensiveRb / totalRbinteger

Rebounding split by end of the floor.

data[].assists / steals / blocks / turnovers / personalFouls / pointsinteger

Season totals for the remaining box-score categories.

data[].season / isPlayoffinteger / boolean

Season ending year and whether this line is postseason. Filter on `isPlayoff` before aggregating.

paginationobject

`total`, `page`, `pageSize` and `pages` for walking the result set.

• Build a player comparison tool with correct effective field-goal percentages
• Chart a player's shooting profile across seasons
• Assemble a fantasy basketball projection dataset
• Separate regular-season and playoff performance for the same player