NBA — NBA Stats API (stats.nba.com) — Player: playerawards–playergamelogs

nba_stats_playerawards

GET /stats/playerawards

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

Valid URL: https://stats.nba.com/stats/playerawards?PlayerID=2544

API Parameter	Python	Pattern	Required	Nullable	Description
PlayerID	player_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
person_id	integer	Unique player identifier (V3 endpoints).
first_name	character	Player's first name.
last_name	character	Player's last name.
team	character	Team-side label or team identifier.
description	character	Long-form description text.
all_nba_team_number	character	NBA or WNBA Stats value for all NBA team number in the playerawards result set.
season	character	Season year.
month	character	NBA or WNBA Stats value for month in the playerawards result set.
week	character	Week number.
conference	character	Conference name.
type	character	Record type / category.
subtype1	character	NBA or WNBA Stats value for subtype1 in the playerawards result set.
subtype2	character	NBA or WNBA Stats value for subtype2 in the playerawards result set.
subtype3	character	NBA or WNBA Stats value for subtype3 in the playerawards result set.

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

Example

nba_stats_playerawards()

Last validated n/a.

nba_stats_playercareerbycollegerollup

GET /stats/playercareerbycollegerollup

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

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

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode_simple			Y
Season	season_nullable			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.
SeasonType	season_type_all_star			Y	Season 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 dict of DataFrames keyed by result-set name (East, South, Midwest, West) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

East

col_name	type	description
region	character	Region label.
seed	integer	Region seed slot of the college in the stats API's career-by-college rollup grid.
college	character	College.
players	integer	Nested list of per-player box scores.
gp	integer	Games played.
min	numeric	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	integer	Three-point field goals made.
fg3_a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Rebounds per game.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
pts	integer	Points scored.

South

col_name	type	description
region	character	Region label.
seed	integer	Region seed slot of the college in the stats API's career-by-college rollup grid.
college	character	College.
players	integer	Nested list of per-player box scores.
gp	integer	Games played.
min	numeric	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	integer	Three-point field goals made.
fg3_a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Rebounds per game.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
pts	integer	Points scored.

Midwest

col_name	type	description
region	character	Region label.
seed	integer	Region seed slot of the college in the stats API's career-by-college rollup grid.
college	character	College.
players	integer	Nested list of per-player box scores.
gp	integer	Games played.
min	numeric	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	integer	Three-point field goals made.
fg3_a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Rebounds per game.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
pts	integer	Points scored.

West

col_name	type	description
region	character	Region label.
seed	integer	Region seed slot of the college in the stats API's career-by-college rollup grid.
college	character	College.
players	integer	Nested list of per-player box scores.
gp	integer	Games played.
min	numeric	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	integer	Three-point field goals made.
fg3_a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Rebounds per game.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
pts	integer	Points scored.

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

Example

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

Last validated n/a.

nba_stats_playercareerstats

GET /stats/playercareerstats

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

Valid URL: https://stats.nba.com/stats/playercareerstats?LeagueID=00&PerMode=Totals&PlayerID=2544

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode36			Y
PlayerID	player_id			Y

Returns

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (SeasonTotalsRegularSeason, CareerTotalsRegularSeason, SeasonTotalsPostSeason, CareerTotalsPostSeason, SeasonTotalsAllStarSeason, CareerTotalsAllStarSeason, SeasonTotalsCollegeSeason, CareerTotalsCollegeSeason, SeasonTotalsShowcaseSeason, CareerTotalsShowcaseSeason, SeasonRankingsRegularSeason, SeasonRankingsPostSeason, SeasonHighs, CareerHighs) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

SeasonTotalsRegularSeason

col_name	type	description
player_id	integer	Unique player identifier.
season_id	character	Unique season identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
player_age	numeric	NBA or WNBA Stats value for player age in the playercareerstats result set.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

CareerTotalsRegularSeason

col_name	type	description
player_id	integer	Unique player identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

SeasonTotalsPostSeason

col_name	type	description
player_id	integer	Unique player identifier.
season_id	character	Unique season identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
player_age	numeric	NBA or WNBA Stats value for player age in the playercareerstats result set.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

CareerTotalsPostSeason

col_name	type	description
player_id	integer	Unique player identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

SeasonTotalsAllStarSeason

col_name	type	description
player_id	integer	Unique player identifier.
season_id	character	Unique season identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
player_age	numeric	NBA or WNBA Stats value for player age in the playercareerstats result set.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

CareerTotalsAllStarSeason

col_name	type	description
player_id	integer	Unique player identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

SeasonTotalsCollegeSeason

col_name	type	description
player_id	character	Unique player identifier.
season_id	character	Unique season identifier.
league_id	character	League identifier ('10' = WNBA).
organization_id	character
school_name	character	College or school of the season row (SeasonTotalsCollegeSeason set).
player_age	character	NBA or WNBA Stats value for player age in the playercareerstats result set.
gp	character	Games played.
gs	character	Games started.
min	character	Minutes played.
fgm	character	Field goals made.
fga	character	Field goal attempts.
fg_pct	character	Field goal percentage (0-1).
fg3_m	character	Three-point field goals made.
fg3_a	character	Three-point field goal attempts.
fg3_pct	character	Three-point field goal percentage (0-1).
ftm	character	Free throws made.
fta	character	Free throw attempts.
ft_pct	character	Free throw percentage (0-1).
oreb	character	Offensive rebounds.
dreb	character	Defensive rebounds.
reb	character	Rebounds per game.
ast	character	Assists.
stl	character	Steals.
blk	character	Blocks.
tov	character	Turnovers.
pf	character	Personal fouls.
pts	character	Points scored.

CareerTotalsCollegeSeason

col_name	type	description
player_id	character	Unique player identifier.
league_id	character	League identifier ('10' = WNBA).
organization_id	character
gp	character	Games played.
gs	character	Games started.
min	character	Minutes played.
fgm	character	Field goals made.
fga	character	Field goal attempts.
fg_pct	character	Field goal percentage (0-1).
fg3_m	character	Three-point field goals made.
fg3_a	character	Three-point field goal attempts.
fg3_pct	character	Three-point field goal percentage (0-1).
ftm	character	Free throws made.
fta	character	Free throw attempts.
ft_pct	character	Free throw percentage (0-1).
oreb	character	Offensive rebounds.
dreb	character	Defensive rebounds.
reb	character	Rebounds per game.
ast	character	Assists.
stl	character	Steals.
blk	character	Blocks.
tov	character	Turnovers.
pf	character	Personal fouls.
pts	character	Points scored.

SeasonTotalsShowcaseSeason

col_name	type	description
player_id	integer	Unique player identifier.
season_id	character	Unique season identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
player_age	numeric	NBA or WNBA Stats value for player age in the playercareerstats result set.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

CareerTotalsShowcaseSeason

col_name	type	description
player_id	integer	Unique player identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
gp	integer	Games played.
gs	integer	Games started.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pf	numeric	Personal fouls.
pts	numeric	Points scored.

SeasonRankingsRegularSeason

col_name	type	description
player_id	integer	Unique player identifier.
season_id	character	Unique season identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
player_age	character	NBA or WNBA Stats value for player age in the playercareerstats result set.
gp	character	Games played.
gs	character	Games started.
rank_pg_min	integer
rank_pg_fgm	integer
rank_pg_fga	integer
rank_fg_pct	integer
rank_pg_fg3_m	integer
rank_pg_fg3_a	integer
rank_fg3_pct	integer
rank_pg_ftm	integer
rank_pg_fta	integer
rank_ft_pct	integer
rank_pg_oreb	integer
rank_pg_dreb	integer
rank_pg_reb	integer
rank_pg_ast	integer
rank_pg_stl	integer
rank_pg_blk	integer
rank_pg_tov	integer
rank_pg_pts	integer
rank_pg_eff	integer

SeasonRankingsPostSeason

col_name	type	description
player_id	integer	Unique player identifier.
season_id	character	Unique season identifier.
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
player_age	character	NBA or WNBA Stats value for player age in the playercareerstats result set.
gp	character	Games played.
gs	character	Games started.
rank_pg_min	integer
rank_pg_fgm	integer
rank_pg_fga	integer
rank_fg_pct	integer
rank_pg_fg3_m	integer
rank_pg_fg3_a	integer
rank_fg3_pct	character
rank_pg_ftm	integer
rank_pg_fta	integer
rank_ft_pct	integer
rank_pg_oreb	integer
rank_pg_dreb	integer
rank_pg_reb	integer
rank_pg_ast	integer
rank_pg_stl	integer
rank_pg_blk	integer
rank_pg_tov	integer
rank_pg_pts	integer
rank_pg_eff	integer

SeasonHighs

col_name	type	description
player_id	integer	Unique player identifier.
game_date	character	Game date (YYYY-MM-DD).
vs_team_id	integer
vs_team_city	character
vs_team_name	character
vs_team_abbreviation	character
stat	character	Stat.
stats_value	integer
stat_order	integer
date_est	character

CareerHighs

col_name	type	description
player_id	integer	Unique player identifier.
game_date	character	Game date (YYYY-MM-DD).
vs_team_id	integer
vs_team_city	character
vs_team_name	character
vs_team_abbreviation	character
stat	character	Stat.
stats_value	integer
stat_order	integer
date_est	character

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

Example

nba_stats_playercareerstats(league_id='00')

Last validated n/a.

nba_stats_playercompare

GET /stats/playercompare

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

Valid URL: https://stats.nba.com/stats/playercompare?Conference=&DateFrom=&DateTo=&GameSegment=&LastNGames=0&LeagueID=00&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PaceAdjust=N&PerMode=Totals&Period=0&PlayerIDList=202681%2C203078%2C2544%2C201567%2C203954&PlusMinus=N&Rank=N&Season=2020-21&SeasonSegment=&SeasonType=Regular+Season&ShotClockRange=&VsConference=&VsDivision=&VsPlayerIDList=201566%2C201939%2C201935%2C201142%2C203076

API Parameter	Python	Pattern	Required	Nullable	Description
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
GameSegment	game_segment_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed_defense			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerIDList	player_id_list			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_playoffs			Y	Season 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).
ShotClockRange	shot_clock_range_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsPlayerIDList	vs_player_id_list			Y

Returns

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (OverallCompare, Individual) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

OverallCompare

col_name	type	description
group_set	character	Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
description	character	Long-form description text.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Shot attempts blocked by opponents (blocks against).
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.

Individual

col_name	type	description
group_set	character	Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
description	character	Long-form description text.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Shot attempts blocked by opponents (blocks against).
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.

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

Example

nba_stats_playercompare(league_id='00')

Last validated n/a.

nba_stats_playerestimatedmetrics

GET /stats/playerestimatedmetrics

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

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

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.
SeasonType	season_type			Y	Season 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_name	type	description
player_id	integer	Unique player identifier.
player_name	character	Player name.
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	numeric	Minutes played.
e_off_rating	numeric	Estimated offensive rating for the requested NBA or WNBA Stats split.
e_def_rating	numeric	Estimated defensive rating for the requested NBA or WNBA Stats split.
e_net_rating	numeric	Estimated net rating for the requested NBA or WNBA Stats split.
e_ast_ratio	numeric	Estimated assist ratio for the requested NBA or WNBA Stats split.
e_oreb_pct	numeric	Estimated offensive rebound percentage for the requested NBA or WNBA Stats split.
e_dreb_pct	numeric	Estimated defensive rebound percentage for the requested NBA or WNBA Stats split.
e_reb_pct	numeric	Estimated rebound percentage for the requested NBA or WNBA Stats split.
e_tov_pct	numeric	Estimated turnovers percentage for the requested NBA or WNBA Stats split.
e_usg_pct	numeric	Estimated usage percentage for the requested NBA or WNBA Stats split.
e_pace	numeric	Estimated pace for the requested NBA or WNBA Stats split.
gp_rank	integer	Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rank	integer	Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rank	integer	Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rank	integer	Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rank	integer	Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_off_rating_rank	integer	Rank for e offensive rating within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_def_rating_rank	integer	Rank for e defensive rating within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_net_rating_rank	integer	Rank for e net rating within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_ast_ratio_rank	integer	Rank for e assists ratio within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_oreb_pct_rank	integer	Rank for e offensive rebounds percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_dreb_pct_rank	integer	Rank for e defensive rebounds percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_reb_pct_rank	integer	Rank for e rebounds percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_tov_pct_rank	integer	Rank for e turnovers percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_usg_pct_rank	integer	Rank for e usage percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
e_pace_rank	integer	Rank for e pace 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_playerestimatedmetrics(league_id='00', season='2024-25')

Last validated n/a.

nba_stats_playerfantasyprofile

GET /stats/playerfantasyprofile

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

Valid URL: https://stats.nba.com/stats/playerfantasyprofile?LeagueID=00&MeasureType=Base&PaceAdjust=N&PerMode=Totals&PlayerID=2544&PlusMinus=N&Rank=N&Season=2024-25&SeasonType=Regular+Season

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
MeasureType	measure_type			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
PlayerID	player_id			Y
PlusMinus	plus_minus			Y
Rank	rank			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.
SeasonType	season_type			Y	Season 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 dict of DataFrames keyed by result-set name (Overall, Location, LastNGames, DaysRestModified, Opponent) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

Overall

col_name	type	description
group_set	character	Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
group_value	character	Value of the split within the group (e.g. a specific opponent, month, or result).
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Shot attempts blocked by opponents (blocks against).
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
dd2	integer	Double-doubles recorded over the split.
td3	integer	Triple-doubles recorded over the split.
fan_duel_pts	numeric	Fantasy points under FanDuel's scoring formula.
nba_fantasy_pts	numeric	Fantasy points under the NBA's fantasy scoring formula.

Location

col_name	type	description
group_set	character	Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
group_value	character	Value of the split within the group (e.g. a specific opponent, month, or result).
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Shot attempts blocked by opponents (blocks against).
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
dd2	integer	Double-doubles recorded over the split.
td3	integer	Triple-doubles recorded over the split.
fan_duel_pts	numeric	Fantasy points under FanDuel's scoring formula.
nba_fantasy_pts	numeric	Fantasy points under the NBA's fantasy scoring formula.

LastNGames

col_name	type	description
group_set	character	Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
group_value	character	Value of the split within the group (e.g. a specific opponent, month, or result).
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Shot attempts blocked by opponents (blocks against).
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
dd2	integer	Double-doubles recorded over the split.
td3	integer	Triple-doubles recorded over the split.
fan_duel_pts	numeric	Fantasy points under FanDuel's scoring formula.
nba_fantasy_pts	numeric	Fantasy points under the NBA's fantasy scoring formula.

DaysRestModified

col_name	type	description
group_set	character	Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
group_value	character	Value of the split within the group (e.g. a specific opponent, month, or result).
season_year	character	Season year string ('YYYY-YY' format).
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Shot attempts blocked by opponents (blocks against).
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
dd2	integer	Double-doubles recorded over the split.
td3	integer	Triple-doubles recorded over the split.
fan_duel_pts	numeric	Fantasy points under FanDuel's scoring formula.
nba_fantasy_pts	numeric	Fantasy points under the NBA's fantasy scoring formula.

Opponent

col_name	type	description
group_set	character	Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
group_value	character	Value of the split within the group (e.g. a specific opponent, month, or result).
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Shot attempts blocked by opponents (blocks against).
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
dd2	integer	Double-doubles recorded over the split.
td3	integer	Triple-doubles recorded over the split.
fan_duel_pts	numeric	Fantasy points under FanDuel's scoring formula.
nba_fantasy_pts	numeric	Fantasy points under the NBA's fantasy scoring formula.

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

Example

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

Last validated n/a.

nba_stats_playerfantasyprofilebargraph

GET /stats/playerfantasyprofilebargraph

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

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

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PlayerID	player_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.
SeasonType	season_type_all_star_nullable			Y	Season 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 dict of DataFrames keyed by result-set name (SeasonAvg, LastFiveGamesAvg) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

SeasonAvg

col_name	type	description
player_id	integer	Unique player identifier.
player_name	character	Player name.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
fan_duel_pts	numeric	Scoring or score-margin metric for fan duel points in the requested NBA or WNBA Stats split.
nba_fantasy_pts	numeric	Nba fantasy points for the requested NBA or WNBA Stats split.
pts	numeric	Points scored.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
fg3_m	numeric	Three-point field goals made.
ft_pct	numeric	Free throw percentage (0-1).
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
fg_pct	numeric	Field goal percentage (0-1).

LastFiveGamesAvg

col_name	type	description
player_id	integer	Unique player identifier.
player_name	character	Player name.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
fan_duel_pts	numeric	Scoring or score-margin metric for fan duel points in the requested NBA or WNBA Stats split.
nba_fantasy_pts	numeric	Nba fantasy points for the requested NBA or WNBA Stats split.
pts	numeric	Points scored.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
fg3_m	numeric	Three-point field goals made.
ft_pct	numeric	Free throw percentage (0-1).
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
fg_pct	numeric	Field goal percentage (0-1).

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

Example

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

Last validated n/a.

nba_stats_playergamelog

GET /stats/playergamelog

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

Valid URL: https://stats.nba.com/stats/playergamelog?DateFrom=&DateTo=&LeagueID=00&PlayerID=2544&Season=2024-25&SeasonType=Regular+Season

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
LeagueID	league_id			Y
PlayerID	player_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.
SeasonType	season_type_all_star			Y	Season 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_name	type	description
season_id	character	Unique season identifier.
player_id	integer	Unique player identifier.
game_id	character	Unique game identifier.
game_date	character	Game date (YYYY-MM-DD).
matchup	character	Matchup.
wl	character	Wl.
min	integer	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	integer	Three-point field goals made.
fg3_a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Rebounds per game.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
pts	integer	Points scored.
plus_minus	integer	Plus/minus point differential while on court.
video_available	integer	Video available.

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

Example

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

Last validated n/a.

nba_stats_playergamelogs

GET /stats/playergamelogs

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

Valid URL: https://stats.nba.com/stats/playergamelogs?DateFrom=&DateTo=&GameSegment=&LastNGames=0&LeagueID=00&Location=&MeasureType=Base&Month=0&Outcome=&PORound=&PerMode=Totals&Period=0&PlayerID=&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&TeamID=0&VsConference=&VsDivision=

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
GameSegment	game_segment_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_player_game_logs_nullable			Y
Month	month_nullable			Y
OppTeamID	oppteamid			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple_nullable			Y
Period	period_nullable			Y
PlayerID	player_id_nullable			Y
Season	season_nullable			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.
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_nullable			Y	Season 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).
ShotClockRange	shot_clock_range_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_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
season_year	character	Season year string ('YYYY-YY' format).
player_id	integer	Unique player identifier.
player_name	character	Player name.
nickname	character	Team or athlete nickname.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
game_id	character	Unique game identifier.
game_date	character	Game date (YYYY-MM-DD).
matchup	character	Matchup.
wl	character	Wl.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn for the requested NBA or WNBA Stats split.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
nba_fantasy_pts	numeric	Nba fantasy points for the requested NBA or WNBA Stats split.
dd2	integer	Double-doubles for the requested NBA or WNBA Stats split.
td3	integer	Triple-doubles for the requested NBA or WNBA Stats split.
wnba_fantasy_pts	numeric	Wnba fantasy points for the requested NBA or WNBA Stats split.
gp_rank	integer	Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rank	integer	Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rank	integer	Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rank	integer	Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rank	integer	Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rank	integer	Rank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rank	integer	Rank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rank	integer	Rank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_a_rank	integer	Rank for three-point field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_pct_rank	integer	Rank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rank	integer	Rank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rank	integer	Rank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rank	integer	Rank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rank	integer	Rank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rank	integer	Rank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rank	integer	Rank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rank	integer	Rank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rank	integer	Rank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rank	integer	Rank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rank	integer	Rank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rank	integer	Rank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rank	integer	Rank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rank	integer	Rank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rank	integer	Rank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rank	integer	Rank for plus-minus within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
nba_fantasy_pts_rank	integer	Rank for NBA fantasy points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dd2_rank	integer	Rank for double-doubles within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
td3_rank	integer	Rank for triple-doubles within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
wnba_fantasy_pts_rank	integer	Rank for WNBA fantasy points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
available_flag	integer	Flag indicating whether the requested NBA or WNBA Stats video or data asset is available.
min_sec	character	Minutes and seconds played, formatted as a game-clock duration string.
team_count	integer	NBA or WNBA Stats value for team count in the playergamelogs result set.

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

Example

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

Last validated n/a.