Docs / Stats & data

NBA Player Stats API

Partial/nba-api

Every NBA player, every game, one endpoint. Look up a player, then pull their box-score line, full game log, or season averages — the same unified envelope you get for every other sport on the API.

Coverage

Live for the NBA — the current 2025-26 season through the Finals, plus the 2023-24 and 2024-25 archives: per-game box scores, game logs, and season averages. NBA has the deepest player-level coverage on the basketball surface.

Endpoints

/v1/players

Find a player and their id (start here — ids are how every stat call is keyed).

curl "https://api.bigballsdata.com/v1/players?sport=basketball&league=nba&name=jokic" \
  -H "Authorization: Bearer $BBS_API_KEY"
/v1/nba/players/{id}/stats

Season averages and per-game box-score stats for one player.

curl "https://api.bigballsdata.com/v1/nba/players/{player_id}/stats?season=2025-26" \
  -H "Authorization: Bearer $BBS_API_KEY"
/v1/players/{id}/gamelog

Game-by-game log for one player across a season.

curl "https://api.bigballsdata.com/v1/players/{player_id}/gamelog?sport=basketball&season=2025-26" \
  -H "Authorization: Bearer $BBS_API_KEY"

Example response

Illustrative shape of the unified envelope. Values are examples; live fields come from the call above.

{
  "data": {
    "player_id": "…",
    "name": "Example Player",
    "team": "DEN",
    "season": "2025-26",
    "averages": { "pts": 26.4, "reb": 12.1, "ast": 9.0, "min": 34.2 }
  },
  "meta": { "source": "…", "request_id": "…" }
}

What you can build

Fantasy projections

Feed season averages + game logs into a projection model for daily fantasy lineups.

Player comparison tool

Look up two ids and diff their per-game lines in a side-by-side widget.

Box-score bot

Post nightly stat lines to Discord/Slack the moment a game finishes.

FAQ

How do I get a player id?
Call /v1/players with a name filter (e.g. ?name=jokic) to list matches and their ids, then pass the id to /v1/nba/players/{id}/stats. Ids are UUIDs; you discover them from the list endpoint.
Which seasons are available?
NBA player stats cover 2023-24, 2024-25, and the live 2025-26 season. Pass ?season= to scope a call.

Start pulling NBA Player Stats

Free tier: 1,000 requests/day (2,000 with GitHub), no credit card.

Get an API key