Skip to main content

NBA — NBA Stats API (stats.nba.com) — League: leaguegamefinder–leaguestandings

nba_stats_leaguegamefinder​

GET /stats/leaguegamefinder

Endpoint URL: GET https://stats.nba.com/stats/leaguegamefinder

Valid URL: https://stats.nba.com/stats/leaguegamefinder?Conference=&DateFrom=&DateTo=&Division=&DraftNumber=&DraftRound=&DraftTeamID=0&DraftYear=&EqAST=&EqBLK=&EqDD=&EqDREB=&EqFG3A=&EqFG3M=&EqFG3_PCT=&EqFGA=&EqFGM=&EqFG_PCT=&EqFTA=&EqFTM=&EqFT_PCT=&EqMINUTES=&EqOREB=&EqPF=&EqPTS=&EqREB=&EqSTL=&EqTD=&EqTOV=&GameID=&GtAST=&GtBLK=&GtDD=&GtDREB=&GtFG3A=&GtFG3M=&GtFG3_PCT=&GtFGA=&GtFGM=&GtFG_PCT=&GtFTA=&GtFTM=&GtFT_PCT=&GtMINUTES=&GtOREB=&GtPF=&GtPTS=&GtREB=&GtSTL=&GtTD=&GtTOV=&LeagueID=00&Location=&LtAST=&LtBLK=&LtDD=&LtDREB=&LtFG3A=&LtFG3M=&LtFG3_PCT=&LtFGA=&LtFGM=&LtFG_PCT=&LtFTA=&LtFTM=&LtFT_PCT=&LtMINUTES=&LtOREB=&LtPF=&LtPTS=&LtREB=&LtSTL=&LtTD=&LtTOV=&Outcome=&PORound=&PlayerID=&PlayerOrTeam=T&RookieYear=&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&StarterBench=&TeamID=0&VsConference=&VsDivision=&VsTeamID=0&YearsExperience=

API ParameterPythonPatternRequiredNullableDescription
Conferenceconference_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
DraftNumberdraft_number_nullableY
DraftRounddraft_round_nullableY
DraftTeamIDdraft_team_id_nullableY
DraftYeardraft_year_nullableY
EqASTeq_ast_nullableY
EqBLKeq_blk_nullableY
EqDDeq_dd_nullableY
EqDREBeq_dreb_nullableY
EqFG3Aeq_fg3a_nullableY
EqFG3Meq_fg3m_nullableY
EqFG3_PCTeq_fg3_pct_nullableY
EqFGAeq_fga_nullableY
EqFGMeq_fgm_nullableY
EqFG_PCTeq_fg_pct_nullableY
EqFTAeq_fta_nullableY
EqFTMeq_ftm_nullableY
EqFT_PCTeq_ft_pct_nullableY
EqMINUTESeq_minutes_nullableY
EqOREBeq_oreb_nullableY
EqPFeq_pf_nullableY
EqPTSeq_pts_nullableY
EqREBeq_reb_nullableY
EqSTLeq_stl_nullableY
EqTDeq_td_nullableY
EqTOVeq_tov_nullableY
GameIDgame_id_nullableY
GtASTgt_ast_nullableY
GtBLKgt_blk_nullableY
GtDDgt_dd_nullableY
GtDREBgt_dreb_nullableY
GtFG3Agt_fg3a_nullableY
GtFG3Mgt_fg3m_nullableY
GtFG3_PCTgt_fg3_pct_nullableY
GtFGAgt_fga_nullableY
GtFGMgt_fgm_nullableY
GtFG_PCTgt_fg_pct_nullableY
GtFTAgt_fta_nullableY
GtFTMgt_ftm_nullableY
GtFT_PCTgt_ft_pct_nullableY
GtMINUTESgt_minutes_nullableY
GtOREBgt_oreb_nullableY
GtPFgt_pf_nullableY
GtPTSgt_pts_nullableY
GtREBgt_reb_nullableY
GtSTLgt_stl_nullableY
GtTDgt_td_nullableY
GtTOVgt_tov_nullableY
LeagueIDleague_idY
Locationlocation_nullableY
LtASTlt_ast_nullableY
LtBLKlt_blk_nullableY
LtDDlt_dd_nullableY
LtDREBlt_dreb_nullableY
LtFG3Alt_fg3a_nullableY
LtFG3Mlt_fg3m_nullableY
LtFG3_PCTlt_fg3_pct_nullableY
LtFGAlt_fga_nullableY
LtFGMlt_fgm_nullableY
LtFG_PCTlt_fg_pct_nullableY
LtFTAlt_fta_nullableY
LtFTMlt_ftm_nullableY
LtFT_PCTlt_ft_pct_nullableY
LtMINUTESlt_minutes_nullableY
LtOREBlt_oreb_nullableY
LtPFlt_pf_nullableY
LtPTSlt_pts_nullableY
LtREBlt_reb_nullableY
LtSTLlt_stl_nullableY
LtTDlt_td_nullableY
LtTOVlt_tov_nullableY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PlayerIDplayer_id_nullableY
PlayerOrTeamplayer_or_team_abbreviationY
RookieYearrookie_year_nullableY
Seasonseason_nullableYSeason 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.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_nullableYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY
VsTeamIDvs_team_id_nullableY
YearsExperienceyears_experience_nullableY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
season_idcharacterUnique season identifier.
team_idintegerUnique team identifier.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
game_idcharacterUnique game identifier.
game_datecharacterGame date (YYYY-MM-DD).
matchupcharacterMatchup.
wlcharacterWl.
minintegerMinutes played.
ptsintegerPoints scored.
fgmintegerField goals made.
fgaintegerField goal attempts.
fg_pctnumericField goal percentage (0-1).
fg3_mintegerThree-point field goals made.
fg3_aintegerThree-point field goal attempts.
fg3_pctnumericThree-point field goal percentage (0-1).
ftmintegerFree throws made.
ftaintegerFree throw attempts.
ft_pctnumericFree throw percentage (0-1).
orebintegerOffensive rebounds.
drebintegerDefensive rebounds.
rebintegerRebounds per game.
astintegerAssists.
stlintegerSteals.
blkintegerBlocks.
tovintegerTurnovers.
pfintegerPersonal fouls.
plus_minusnumericPlus/minus point differential while on court.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leaguegamefinder(league_id='00', season_nullable='2024-25')

Last validated n/a.

nba_stats_leaguegamelog​

GET /stats/leaguegamelog

Endpoint URL: GET https://stats.nba.com/stats/leaguegamelog

Valid URL: https://stats.nba.com/stats/leaguegamelog?Counter=0&DateFrom=&DateTo=&Direction=ASC&LeagueID=00&PlayerOrTeam=T&Season=2024-25&SeasonType=Regular+Season&Sorter=DATE

API ParameterPythonPatternRequiredNullableDescription
CountercounterY
DateFromdate_from_nullableY
DateTodate_to_nullableY
DirectiondirectionY
LeagueIDleague_idY
PlayerOrTeamplayer_or_team_abbreviationY
SeasonseasonYSeason 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.
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
SortersorterY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
season_idcharacterUnique season identifier.
team_idintegerUnique team identifier.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
game_idcharacterUnique game identifier.
game_datecharacterGame date (YYYY-MM-DD).
matchupcharacterMatchup.
wlcharacterWl.
minintegerMinutes played.
fgmintegerField goals made.
fgaintegerField goal attempts.
fg_pctnumericField goal percentage (0-1).
fg3_mintegerThree-point field goals made.
fg3_aintegerThree-point field goal attempts.
fg3_pctnumericThree-point field goal percentage (0-1).
ftmintegerFree throws made.
ftaintegerFree throw attempts.
ft_pctnumericFree throw percentage (0-1).
orebintegerOffensive rebounds.
drebintegerDefensive rebounds.
rebintegerRebounds per game.
astintegerAssists.
stlintegerSteals.
blkintegerBlocks.
tovintegerTurnovers.
pfintegerPersonal fouls.
ptsintegerPoints scored.
plus_minusintegerPlus/minus point differential while on court.
video_availableintegerVideo available.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leaguegamelog(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_leaguehustlestatsplayer​

GET /stats/leaguehustlestatsplayer

Endpoint URL: GET https://stats.nba.com/stats/leaguehustlestatsplayer

Valid URL: https://stats.nba.com/stats/leaguehustlestatsplayer?College=&Conference=&Country=&DateFrom=&DateTo=&Division=&DraftPick=&DraftYear=&Height=&LeagueID=00&Location=&Month=0&OpponentTeamID=0&Outcome=&PORound=&PerMode=Totals&PlayerExperience=&PlayerPosition=&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&TeamID=0&VsConference=&VsDivision=&Weight=

API ParameterPythonPatternRequiredNullableDescription
Collegecollege_nullableY
Conferenceconference_nullableY
Countrycountry_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
DraftPickdraft_pick_nullableY
DraftYeardraft_year_nullableY
Heightheight_nullableY
LeagueIDleague_idY
Locationlocation_nullableY
Monthmonth_nullableY
OpponentTeamIDopponent_team_id_nullableY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PerModeper_mode_timeY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_nullableY
SeasonseasonYSeason 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.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY
Weightweight_nullableY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
player_idintegerUnique player identifier.
player_namecharacterPlayer name.
team_idintegerUnique team identifier.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
agenumericPlayer age (in years).
gintegerGames played.
minnumericMinutes played.
contested_shotsnumericDefensively contested shots.
contested_shots_2_ptnumericOpponent two-point attempts contested.
contested_shots_3_ptnumericOpponent three-point attempts contested.
deflectionsnumericDefensive deflections.
charges_drawnnumericCharges drawn.
screen_assistsnumericScreen assists (resulting in a basket).
screen_ast_ptsnumericPoints teammates scored directly off the row's screen assists.
off_loose_balls_recoverednumericLoose balls recovered while on offense.
def_loose_balls_recoverednumericLoose balls recovered while on defense.
loose_balls_recoverednumericTotal loose balls recovered.
pct_loose_balls_recovered_offnumericShare of recovered loose balls that came on offense, as a decimal.
pct_loose_balls_recovered_defnumericShare of recovered loose balls that came on defense, as a decimal.
off_boxoutsnumericBox-outs recorded on the offensive glass.
def_boxoutsnumericBox-outs recorded on the defensive glass.
box_outsnumericBox-outs executed.
box_out_player_team_rebsnumericTeam rebounds secured following the row's box-outs.
box_out_player_rebsnumericRebounds the player secured directly off their own box-outs.
pct_box_outs_offnumericShare of box-outs recorded on the offensive glass, as a decimal.
pct_box_outs_defnumericShare of box-outs recorded on the defensive glass, as a decimal.
pct_box_outs_team_rebnumericShare of box-outs after which the team secured the rebound, as a decimal.
pct_box_outs_rebnumericShare of box-outs after which the player secured the rebound, as a decimal.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leaguehustlestatsplayer(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_leaguehustlestatsteam​

GET /stats/leaguehustlestatsteam

Endpoint URL: GET https://stats.nba.com/stats/leaguehustlestatsteam

Valid URL: https://stats.nba.com/stats/leaguehustlestatsteam?College=&Conference=&Country=&DateFrom=&DateTo=&Division=&DraftPick=&DraftYear=&Height=&LeagueID=00&Location=&Month=0&OpponentTeamID=0&Outcome=&PORound=&PerMode=Totals&PlayerExperience=&PlayerPosition=&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&TeamID=0&VsConference=&VsDivision=&Weight=

API ParameterPythonPatternRequiredNullableDescription
Collegecollege_nullableY
Conferenceconference_nullableY
Countrycountry_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
DraftPickdraft_pick_nullableY
DraftYeardraft_year_nullableY
Heightheight_nullableY
LeagueIDleague_idY
Locationlocation_nullableY
Monthmonth_nullableY
OpponentTeamIDopponent_team_id_nullableY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PerModeper_mode_timeY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_nullableY
SeasonseasonYSeason 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.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY
Weightweight_nullableY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
minnumericMinutes played.
contested_shotsnumericDefensively contested shots.
contested_shots_2_ptnumericOpponent two-point attempts contested.
contested_shots_3_ptnumericOpponent three-point attempts contested.
deflectionsnumericDefensive deflections.
charges_drawnnumericCharges drawn.
screen_assistsnumericScreen assists (resulting in a basket).
screen_ast_ptsnumericPoints teammates scored directly off the row's screen assists.
off_loose_balls_recoverednumericLoose balls recovered while on offense.
def_loose_balls_recoverednumericLoose balls recovered while on defense.
loose_balls_recoverednumericTotal loose balls recovered.
pct_loose_balls_recovered_offnumericShare of recovered loose balls that came on offense, as a decimal.
pct_loose_balls_recovered_defnumericShare of recovered loose balls that came on defense, as a decimal.
off_boxoutsnumericBox-outs recorded on the offensive glass.
def_boxoutsnumericBox-outs recorded on the defensive glass.
box_outsnumericBox-outs executed.
pct_box_outs_offnumericShare of box-outs recorded on the offensive glass, as a decimal.
pct_box_outs_defnumericShare of box-outs recorded on the defensive glass, as a decimal.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leaguehustlestatsteam(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_leagueleaders​

GET /stats/leagueleaders

Endpoint URL: GET https://stats.nba.com/stats/leagueleaders

Valid URL: https://stats.nba.com/stats/leagueleaders?ActiveFlag=&LeagueID=00&PerMode=Totals&Scope=S&Season=2024-25&SeasonType=Regular+Season&StatCategory=PTS

API ParameterPythonPatternRequiredNullableDescription
ActiveFlagactive_flag_nullableY
LeagueIDleague_idY
PerModeper_mode48Y
ScopescopeY
SeasonseasonYSeason 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.
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
StatCategorystat_category_abbreviationY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
player_idintegerUnique player identifier.
rankintegerRank of the row within the returned leaderboard (1 = best) for the stat the endpoint sorts by.
playercharacterPlayer name.
team_idintegerUnique team identifier.
teamcharacterTeam-side label or team identifier.
gpintegerGames played.
minnumericMinutes played.
fgmnumericField goals made.
fganumericField goal attempts.
fg_pctnumericField goal percentage (0-1).
fg3_mnumericThree-point field goals made.
fg3_anumericThree-point field goal attempts.
fg3_pctnumericThree-point field goal percentage (0-1).
ftmnumericFree throws made.
ftanumericFree throw attempts.
ft_pctnumericFree throw percentage (0-1).
orebnumericOffensive rebounds.
drebnumericDefensive rebounds.
rebnumericRebounds per game.
astnumericAssists.
stlnumericSteals.
blknumericBlocks.
tovnumericTurnovers.
ptsnumericPoints scored.
effnumericEff.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leagueleaders(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_leaguelineupviz​

GET /stats/leaguelineupviz

Endpoint URL: GET https://stats.nba.com/stats/leaguelineupviz

Valid URL: https://stats.nba.com/stats/leaguelineupviz?Conference=&DateFrom=&DateTo=&Division=&GameSegment=&GroupQuantity=5&LastNGames=0&LeagueID=00&Location=&MeasureType=Base&MinutesMin=10&Month=0&OpponentTeamID=0&Outcome=&PORound=&PaceAdjust=N&PerMode=Totals&Period=0&PlusMinus=N&Rank=N&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&ShotClockRange=&TeamID=0&VsConference=&VsDivision=

API ParameterPythonPatternRequiredNullableDescription
Conferenceconference_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
GameSegmentgame_segment_nullableY
GroupQuantitygroup_quantityY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MinutesMinminutes_minY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason 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.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
ShotClockRangeshot_clock_range_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
group_idcharacterESPN group id.
group_namecharacterThe lineup's five players as a ' - ' separated string of abbreviated names.
team_idintegerUnique team identifier.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
minnumericMinutes played.
off_ratingnumericPoints scored per 100 possessions with the lineup on the floor (offensive rating).
def_ratingnumericPoints allowed per 100 possessions with the lineup on the floor (defensive rating).
net_ratingnumericNet rating (off rating - def rating).
pacenumericPossessions per 48 minutes.
ts_pctnumericTrue shooting percentage (0-1).
fta_ratenumericFree throw attempts per field goal attempt for the lineup.
tm_ast_pctnumericPercentage of the lineup's made field goals that were assisted, as a decimal.
pct_fga_2_ptnumericShare of field goal attempts taken as two-pointers, as a decimal.
pct_fga_3_ptnumericShare of field goal attempts taken as three-pointers, as a decimal.
pct_pts_2_pt_mrnumericShare of points scored on mid-range two-pointers, as a decimal.
pct_pts_fbnumericShare of points scored on fast breaks, as a decimal.
pct_pts_ftnumericShare of points scored at the free throw line, as a decimal.
pct_pts_paintnumericShare of points scored in the paint, as a decimal.
pct_ast_fgmnumericPercentage of made field goals that were assisted, as a decimal.
pct_uast_fgmnumericPercentage of made field goals that were unassisted, as a decimal.
opp_fg3_pctnumericOpponent three-point percentage against the lineup, as a decimal.
opp_efg_pctnumericOpponent effective field goal percentage against the lineup, as a decimal.
opp_fta_ratenumericOpponent free throw attempt rate against the lineup.
opp_tov_pctnumericOpponent turnover percentage forced by the lineup.
sum_tm_minnumericTotal team minutes summed across the lineup's stints on the floor.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leaguelineupviz(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_leagueplayerondetails​

GET /stats/leagueplayerondetails

Endpoint URL: GET https://stats.nba.com/stats/leagueplayerondetails

Valid URL: https://stats.nba.com/stats/leagueplayerondetails?DateFrom=&DateTo=&GameSegment=&LastNGames=0&LeagueID=00&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PaceAdjust=N&PerMode=Totals&Period=0&PlusMinus=N&Rank=N&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&TeamID=1610612749&VsConference=&VsDivision=

API ParameterPythonPatternRequiredNullableDescription
DateFromdate_from_nullableY
DateTodate_to_nullableY
GameSegmentgame_segment_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason 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.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
TeamIDteam_idY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
group_setcharacterName of the grouping family used for this dashboard or split row.
team_idintegerUnique team identifier.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
vs_player_idintegerStats API identifier for vs player identifier associated with this NBA or WNBA Stats row.
vs_player_namecharacterDisplay name for vs player name associated with this NBA or WNBA Stats row.
court_statuscharacterIndicates whether the compared player was on court or off court for the split row.
gpintegerGames played.
wintegerWins.
lintegerLosses.
w_pctnumericWins percentage (0-1 decimal).
minnumericMinutes played.
fgmnumericField goals made.
fganumericField goal attempts.
fg_pctnumericField goal percentage (0-1).
fg3_mnumericThree-point field goals made.
fg3_anumericThree-point field goal attempts.
fg3_pctnumericThree-point field goal percentage (0-1).
ftmnumericFree throws made.
ftanumericFree throw attempts.
ft_pctnumericFree throw percentage (0-1).
orebnumericOffensive rebounds.
drebnumericDefensive rebounds.
rebnumericRebounds per game.
astnumericAssists.
tovnumericTurnovers.
stlnumericSteals.
blknumericBlocks.
blkanumericBlocked field-goal attempts against for the requested NBA or WNBA Stats split.
pfnumericPersonal fouls.
pfdnumericPersonal fouls drawn for the requested NBA or WNBA Stats split.
ptsnumericPoints scored.
plus_minusnumericPlus/minus point differential while on court.
gp_rankintegerRank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rankintegerRank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rankintegerRank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rankintegerRank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rankintegerRank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rankintegerRank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rankintegerRank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rankintegerRank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_m_rankintegerRank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_a_rankintegerRank for three-point field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_pct_rankintegerRank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rankintegerRank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rankintegerRank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rankintegerRank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rankintegerRank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rankintegerRank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rankintegerRank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rankintegerRank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rankintegerRank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rankintegerRank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rankintegerRank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rankintegerRank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rankintegerRank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rankintegerRank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rankintegerRank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rankintegerRank for plus-minus within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leagueplayerondetails(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_leagueseasonmatchups​

GET /stats/leagueseasonmatchups

Endpoint URL: GET https://stats.nba.com/stats/leagueseasonmatchups

Valid URL: https://stats.nba.com/stats/leagueseasonmatchups?DefPlayerID=&DefTeamID=0&LeagueID=00&OffPlayerID=&OffTeamID=0&PerMode=Totals&Season=2024-25&SeasonType=Regular+Season

API ParameterPythonPatternRequiredNullableDescription
DefPlayerIDdef_player_id_nullableY
DefTeamIDdef_team_id_nullableY
LeagueIDleague_idY
OffPlayerIDoff_player_id_nullableY
OffTeamIDoff_team_id_nullableY
PerModeper_mode_simpleY
SeasonseasonYSeason 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.
SeasonTypeseason_type_playoffsYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
season_idcharacterUnique season identifier.
off_player_idintegerStats API identifier for offensive player identifier associated with this NBA or WNBA Stats row.
off_player_namecharacterDisplay name for offensive player name associated with this NBA or WNBA Stats row.
def_player_idintegerStats API identifier for defensive player identifier associated with this NBA or WNBA Stats row.
def_player_namecharacterDisplay name for defensive player name associated with this NBA or WNBA Stats row.
gpintegerGames played.
matchup_minnumericNBA or WNBA Stats value for matchup minutes in the leagueseasonmatchups result set.
partial_possnumericEstimated partial possessions credited to the stint or rotation interval.
player_ptsnumericScoring or score-margin metric for player points in the requested NBA or WNBA Stats split.
team_ptsnumericScoring or score-margin metric for team points in the requested NBA or WNBA Stats split.
matchup_astnumericNBA or WNBA Stats value for matchup assists in the leagueseasonmatchups result set.
matchup_tovnumericTurnover or loose-ball metric for matchup turnovers in the requested NBA or WNBA Stats split.
matchup_blknumericNBA or WNBA Stats value for matchup blocks in the leagueseasonmatchups result set.
matchup_fgmnumericShooting metric for matchup fgm in the requested NBA or WNBA Stats split.
matchup_fganumericShooting metric for matchup fga in the requested NBA or WNBA Stats split.
matchup_fg_pctnumericPercentage or rate for matchup field goals percentage in the requested NBA or WNBA Stats split.
matchup_fg3_mnumericShooting metric for matchup fg3m in the requested NBA or WNBA Stats split.
matchup_fg3_anumericShooting metric for matchup fg3a in the requested NBA or WNBA Stats split.
matchup_fg3_pctnumericPercentage or rate for matchup three-point field goals percentage in the requested NBA or WNBA Stats split.
help_blkintegerNBA or WNBA Stats value for help blocks in the leagueseasonmatchups result set.
help_fgmintegerShooting metric for help fgm in the requested NBA or WNBA Stats split.
help_fgaintegerShooting metric for help fga in the requested NBA or WNBA Stats split.
help_fg_percintegerShooting metric for help field goals perc in the requested NBA or WNBA Stats split.
matchup_ftmnumericNBA or WNBA Stats value for matchup ftm in the leagueseasonmatchups result set.
matchup_ftanumericNBA or WNBA Stats value for matchup fta in the leagueseasonmatchups result set.
sflnumericNBA or WNBA Stats value for sfl in the leagueseasonmatchups result set.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leagueseasonmatchups(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_leaguestandings​

GET /stats/leaguestandings

Endpoint URL: GET https://stats.nba.com/stats/leaguestandings

Valid URL: https://stats.nba.com/stats/leaguestandings?LeagueID=00&Season=2024-25&SeasonType=Regular+Season&SeasonYear=

API ParameterPythonPatternRequiredNullableDescription
LeagueIDleague_idY
SeasonseasonYSeason 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.
SeasonTypeseason_typeYSeason type, a label: Regular Season, Pre Season, Playoffs, PlayIn or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs / PlayIn roll over in May (NBA, G League), All Star in March (NBA).
SeasonYearseason_nullableY

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
league_idcharacterLeague identifier used in compact NBA Stats schedule and scoreboard result sets.
season_idcharacterStats API identifier for seasonid associated with this NBA or WNBA Stats row.
team_idintegerUnique team identifier.
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
conferencecharacterConference name.
conference_recordcharacterNBA or WNBA Stats value for conferencerecord in the leaguestandings result set.
playoff_rankintegerNBA or WNBA Stats value for playoffrank in the leaguestandings result set.
clinch_indicatorcharacterNBA or WNBA Stats value for clinchindicator in the leaguestandings result set.
divisioncharacterTeam division.
division_recordcharacterNBA or WNBA Stats value for divisionrecord in the leaguestandings result set.
division_rankintegerNBA or WNBA Stats value for divisionrank in the leaguestandings result set.
winsintegerTotal wins.
lossesintegerTotal losses.
win_pctnumericWinning percentage for the team or split represented by this row.
league_rankintegerNBA or WNBA Stats value for leaguerank in the leaguestandings result set.
recordcharacterOverall win-loss record.
homecharacterHome.
roadcharacterRoad.
l10characterLast-ten record.
last10_homecharacterNBA or WNBA Stats value for last10home in the leaguestandings result set.
last10_roadcharacterNBA or WNBA Stats value for last10road in the leaguestandings result set.
otcharacterOt.
three_pts_or_lesscharacterScoring or score-margin metric for threeptsorless in the requested NBA or WNBA Stats split.
ten_pts_or_morecharacterScoring or score-margin metric for tenptsormore in the requested NBA or WNBA Stats split.
long_home_streakintegerNBA or WNBA Stats value for longhomestreak in the leaguestandings result set.
str_long_home_streakcharacterNBA or WNBA Stats value for strlonghomestreak in the leaguestandings result set.
long_road_streakintegerNBA or WNBA Stats value for longroadstreak in the leaguestandings result set.
str_long_road_streakcharacterNBA or WNBA Stats value for strlongroadstreak in the leaguestandings result set.
long_win_streakintegerNBA or WNBA Stats value for longwinstreak in the leaguestandings result set.
long_loss_streakintegerNBA or WNBA Stats value for longlossstreak in the leaguestandings result set.
current_home_streakintegerNBA or WNBA Stats value for currenthomestreak in the leaguestandings result set.
str_current_home_streakcharacterNBA or WNBA Stats value for strcurrenthomestreak in the leaguestandings result set.
current_road_streakintegerNBA or WNBA Stats value for currentroadstreak in the leaguestandings result set.
str_current_road_streakcharacterNBA or WNBA Stats value for strcurrentroadstreak in the leaguestandings result set.
current_streakintegerNBA or WNBA Stats value for currentstreak in the leaguestandings result set.
str_current_streakcharacter
conference_games_backnumericNBA or WNBA Stats value for conferencegamesback in the leaguestandings result set.
division_games_backnumericNBA or WNBA Stats value for divisiongamesback in the leaguestandings result set.
clinched_conference_titleintegerFlag indicating clinchedconferencetitle for the requested NBA or WNBA Stats context.
clinched_division_titleintegerFlag indicating clincheddivisiontitle for the requested NBA or WNBA Stats context.
clinched_playoff_birthintegerFlag indicating clinchedplayoffbirth for the requested NBA or WNBA Stats context.
eliminated_conferenceintegerFlag indicating eliminatedconference for the requested NBA or WNBA Stats context.
eliminated_divisionintegerFlag indicating eliminateddivision for the requested NBA or WNBA Stats context.
ahead_at_halfcharacterNBA or WNBA Stats value for aheadathalf in the leaguestandings result set.
behind_at_halfcharacterNBA or WNBA Stats value for behindathalf in the leaguestandings result set.
tied_at_halfcharacterNBA or WNBA Stats value for tiedathalf in the leaguestandings result set.
ahead_at_thirdcharacterNBA or WNBA Stats value for aheadatthird in the leaguestandings result set.
behind_at_thirdcharacterNBA or WNBA Stats value for behindatthird in the leaguestandings result set.
tied_at_thirdcharacterNBA or WNBA Stats value for tiedatthird in the leaguestandings result set.
score100_ptscharacterScoring or score-margin metric for score100pts in the requested NBA or WNBA Stats split.
opp_score100_ptscharacterScoring or score-margin metric for oppscore100pts in the requested NBA or WNBA Stats split.
opp_over500characterNBA or WNBA Stats value for oppover500 in the leaguestandings result set.
lead_in_fgpctcharacterShooting metric for leadinfgpct in the requested NBA or WNBA Stats split.
lead_in_rebcharacterRebounding metric for leadinreb in the requested NBA or WNBA Stats split.
fewer_turnoverscharacterTurnover or loose-ball metric for fewerturnovers in the requested NBA or WNBA Stats split.
points_pgnumericScoring or score-margin metric for pointspg in the requested NBA or WNBA Stats split.
opp_points_pgnumericScoring or score-margin metric for opppointspg in the requested NBA or WNBA Stats split.
diff_points_pgnumericScoring or score-margin metric for diffpointspg in the requested NBA or WNBA Stats split.
vs_eastcharacterNBA or WNBA Stats value for vseast in the leaguestandings result set.
vs_atlanticcharacterNBA or WNBA Stats value for vsatlantic in the leaguestandings result set.
vs_centralcharacterNBA or WNBA Stats value for vscentral in the leaguestandings result set.
vs_southeastcharacterNBA or WNBA Stats value for vssoutheast in the leaguestandings result set.
vs_westcharacterNBA or WNBA Stats value for vswest in the leaguestandings result set.
vs_northwestcharacterNBA or WNBA Stats value for vsnorthwest in the leaguestandings result set.
vs_pacificcharacterNBA or WNBA Stats value for vspacific in the leaguestandings result set.
vs_southwestcharacterNBA or WNBA Stats value for vssouthwest in the leaguestandings result set.
jancharacterValue for January in the endpoint's monthly NBA or WNBA Stats split.
febcharacterValue for February in the endpoint's monthly NBA or WNBA Stats split.
marcharacterValue for March in the endpoint's monthly NBA or WNBA Stats split.
aprcharacterValue for April in the endpoint's monthly NBA or WNBA Stats split.
maycharacterValue for May in the endpoint's monthly NBA or WNBA Stats split.
juncharacterValue for June in the endpoint's monthly NBA or WNBA Stats split.
julcharacterValue for July in the endpoint's monthly NBA or WNBA Stats split.
augcharacterValue for August in the endpoint's monthly NBA or WNBA Stats split.
sepcharacterValue for September in the endpoint's monthly NBA or WNBA Stats split.
octcharacterValue for October in the endpoint's monthly NBA or WNBA Stats split.
novcharacterValue for November in the endpoint's monthly NBA or WNBA Stats split.
deccharacterValue for December in the endpoint's monthly NBA or WNBA Stats split.
pre_ascharacterNBA or WNBA Stats value for preas in the leaguestandings result set.
post_ascharacterNBA or WNBA Stats value for postas in the leaguestandings result set.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

nba_stats_leaguestandings(league_id='00', season='2024-25')

Last validated n/a.