NBA — NBA Stats API (stats.nba.com) — Common
nba_stats_commonallplayers
GET /stats/commonallplayers
Endpoint URL: GET https://stats.nba.com/stats/commonallplayers
Valid URL: https://stats.nba.com/stats/commonallplayers?IsOnlyCurrentSeason=0&LeagueID=00&Season=2024-25
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
IsOnlyCurrentSeason | is_only_current_season | Y | |||
LeagueID | league_id | Y | |||
Season | season | Y | Season label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. An NBA season tips off in late October and becomes the default in November (2025-26 through October 2026, 2026-27 from November 2026); a G League season (regular season from late December) in January; a Summer League (played in July, which stats.nba.com labels 2026-27 in 2026) in August; a draft combine (May) in June; a draft (drafthistory, a year; late June) in July. With season type Playoffs / PlayIn (or commonplayoffseries) the NBA and the G League roll over in May, after their playoffs start; with All Star the NBA rolls over in March, after the February game (the G League has no All-Star rows and keeps its own rule). A month table cannot follow a lockout or pandemic calendar (1998-99, 2011-12, 2020-21): pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
person_id | integer | Unique player identifier (V3 endpoints). |
display_last_comma_first | character | Player name formatted as "Last, First". |
display_first_last | character | Player name formatted as "First Last". |
rosterstatus | integer | Roster status flag (1 = currently on a roster, 0 = not). |
from_year | character | First season. |
to_year | character | Most recent season. |
playercode | character | URL-style player code slug used by the league's legacy stats pages. |
player_slug | character | URL-safe player identifier. |
team_id | integer | Unique team identifier. |
team_city | character | Team city or region (e.g. 'Las Vegas'). |
team_name | character | Full team display name (e.g. 'Las Vegas Aces'). |
team_abbreviation | character | Short team abbreviation (e.g. 'LAS'). |
team_code | character | Lowercase slug of the player's team used in stats.nba.com URLs (e.g. 'lakers'). |
team_slug | character | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
games_played_flag | character | Y/N flag for whether the player has appeared in a league game. |
otherleague_experience_ch | character | Code for the player's experience in another league (e.g. G League), as reported by the stats API. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
nba_stats_commonallplayers(league_id='00', season='2024-25')
Last validated n/a.
nba_stats_commonplayerinfo
GET /stats/commonplayerinfo
Endpoint URL: GET https://stats.nba.com/stats/commonplayerinfo
Valid URL: https://stats.nba.com/stats/commonplayerinfo?LeagueID=00&PlayerID=2544
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
LeagueID | league_id | Y | |||
PlayerID | player_id | Y |
Returns
return_parsed=True (default) — A dict of DataFrames keyed by result-set name (CommonPlayerInfo, PlayerHeadlineStats, AvailableSeasons) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).
CommonPlayerInfo
| col_name | type | description |
|---|---|---|
person_id | integer | Unique player identifier (V3 endpoints). |
first_name | character | Player's first name. |
last_name | character | Player's last name. |
display_first_last | character | NBA or WNBA Stats value for display first last in the commonplayerinfo result set. |
display_last_comma_first | character | NBA or WNBA Stats value for display last comma first in the commonplayerinfo result set. |
display_fi_last | character | NBA or WNBA Stats value for display fi last in the commonplayerinfo result set. |
player_slug | character | URL-safe player identifier. |
birthdate | character | Player's date of birth as an ISO timestamp string (e.g. '1984-12-30T00:00:00'). |
school | character | Player school / pre-draft team. |
country | character | Venue country. |
last_affiliation | character | NBA or WNBA Stats value for last affiliation in the commonplayerinfo result set. |
height | character | Player height (string e.g. '6-2' or inches). |
weight | character | Player weight in pounds. |
season_exp | integer | NBA or WNBA Stats value for season exp in the commonplayerinfo result set. |
jersey | character | Jersey number worn by the player. |
position | character | Listed roster position (G, F, C, etc.). |
rosterstatus | character | NBA or WNBA Stats value for rosterstatus in the commonplayerinfo result set. |
games_played_current_season_flag | character | Flag indicating games played current season flag for the requested NBA or WNBA Stats context. |
team_id | integer | Unique team identifier. |
team_name | character | Full team display name (e.g. 'Las Vegas Aces'). |
team_abbreviation | character | Short team abbreviation (e.g. 'LAS'). |
team_code | character | Lowercase slug of the player's current team used in stats.nba.com URLs (e.g. 'lakers'). |
team_city | character | Team city or region (e.g. 'Las Vegas'). |
playercode | character | NBA or WNBA Stats value for playercode in the commonplayerinfo result set. |
from_year | integer | First season. |
to_year | integer | Most recent season. |
dleague_flag | character | Flag indicating dleague flag for the requested NBA or WNBA Stats context. |
nba_flag | character | Flag indicating NBA flag for the requested NBA or WNBA Stats context. |
games_played_flag | character | Flag indicating games played flag for the requested NBA or WNBA Stats context. |
draft_year | character | Draft year (4-digit). |
draft_round | character | Round of the draft selection. |
draft_number | character | Overall pick the player was selected with, as a string; 'Undrafted' when never drafted. |
greatest_75_flag | character | Flag indicating greatest 75 flag for the requested NBA or WNBA Stats context. |
PlayerHeadlineStats
| col_name | type | description |
|---|---|---|
player_id | integer | Unique player identifier. |
player_name | character | Player name. |
time_frame | character | |
pts | numeric | Points scored. |
ast | numeric | Assists. |
reb | numeric | Rebounds per game. |
pie | integer | Player Impact Estimate (0-1). |
AvailableSeasons
| col_name | type | description |
|---|---|---|
season_id | character | Unique season identifier. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
nba_stats_commonplayerinfo(league_id='00')
Last validated n/a.
nba_stats_commonplayoffseries
GET /stats/commonplayoffseries
Endpoint URL: GET https://stats.nba.com/stats/commonplayoffseries
Valid URL: https://stats.nba.com/stats/commonplayoffseries?LeagueID=00&Season=2024-25&SeriesID=
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
LeagueID | league_id | Y | |||
Season | season | Y | Season label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. An NBA season tips off in late October and becomes the default in November (2025-26 through October 2026, 2026-27 from November 2026); a G League season (regular season from late December) in January; a Summer League (played in July, which stats.nba.com labels 2026-27 in 2026) in August; a draft combine (May) in June; a draft (drafthistory, a year; late June) in July. With season type Playoffs / PlayIn (or commonplayoffseries) the NBA and the G League roll over in May, after their playoffs start; with All Star the NBA rolls over in March, after the February game (the G League has no All-Star rows and keeps its own rule). A month table cannot follow a lockout or pandemic calendar (1998-99, 2011-12, 2020-21): pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed. | ||
SeriesID | series_id_nullable | Y |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
game_id | character | Unique game identifier. |
home_team_id | integer | Unique identifier for the home team. |
visitor_team_id | integer | Unique identifier for visitor team. |
series_id | character | Playoff series id, the game id stem without the game sequence digit (e.g. '004230010' for the 2023-24 playoffs' first series). |
game_num | integer | NBA or WNBA Stats value for game number in the commonplayoffseries result set. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
nba_stats_commonplayoffseries(league_id='00', season='2024-25')
Last validated n/a.
nba_stats_commonteamroster
GET /stats/commonteamroster
Endpoint URL: GET https://stats.nba.com/stats/commonteamroster
Valid URL: https://stats.nba.com/stats/commonteamroster?LeagueID=00&Season=2024-25&TeamID=1610612739
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
LeagueID | league_id | Y | |||
Season | season | Y | Season label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. An NBA season tips off in late October and becomes the default in November (2025-26 through October 2026, 2026-27 from November 2026); a G League season (regular season from late December) in January; a Summer League (played in July, which stats.nba.com labels 2026-27 in 2026) in August; a draft combine (May) in June; a draft (drafthistory, a year; late June) in July. With season type Playoffs / PlayIn (or commonplayoffseries) the NBA and the G League roll over in May, after their playoffs start; with All Star the NBA rolls over in March, after the February game (the G League has no All-Star rows and keeps its own rule). A month table cannot follow a lockout or pandemic calendar (1998-99, 2011-12, 2020-21): pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed. | ||
TeamID | team_id | Y |
Returns
return_parsed=True (default) — A dict of DataFrames keyed by result-set name (CommonTeamRoster, Coaches) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).
CommonTeamRoster
| col_name | type | description |
|---|---|---|
team_id | integer | Unique team identifier. |
season | character | Season year. |
league_id | character | League identifier from the stats API ("00" = NBA, "10" = WNBA, "20" = G League). |
player | character | Player name. |
nickname | character | Team or athlete nickname. |
player_slug | character | URL-safe player identifier. |
num | character | Jersey number as printed on the roster (string; may be blank or carry a suffix). |
position | character | Listed roster position (G, F, C, etc.). |
height | character | Player height (string e.g. '6-2' or inches). |
weight | character | Player weight in pounds. |
birth_date | character | Date of birth (YYYY-MM-DD). |
age | numeric | Player age (in years). |
exp | character | Exp. |
school | character | Player school / pre-draft team. |
player_id | integer | Unique player identifier. |
how_acquired | character | How the team acquired the player (e.g. draft, trade, free agency). |
Coaches
| col_name | type | description |
|---|---|---|
team_id | integer | Unique team identifier. |
season | character | Season year. |
coach_id | integer | ESPN coach id. |
first_name | character | Player's first name. |
last_name | character | Player's last name. |
coach_name | character | |
is_assistant | integer | |
coach_type | character | |
sort_sequence | integer | |
sub_sort_sequence | integer |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
nba_stats_commonteamroster(league_id='00', season='2024-25')
Last validated n/a.
nba_stats_commonteamyears
GET /stats/commonteamyears
Endpoint URL: GET https://stats.nba.com/stats/commonteamyears
Valid URL: https://stats.nba.com/stats/commonteamyears?LeagueID=00
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
LeagueID | league_id | Y |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
league_id | character | League identifier ('10' = WNBA). |
team_id | integer | Unique team identifier. |
min_year | character | Minimum year queried (echoes min_year). |
max_year | character | Maximum year queried (echoes max_year). |
abbreviation | character | Short abbreviation. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
nba_stats_commonteamyears(league_id='00')
Last validated n/a.