NBA — NBA Stats API (stats.nba.com)

sportsdataverse.nba — 112 endpoints.

nba_stats_alltimeleadersgrids

GET /stats/alltimeleadersgrids

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

Valid URL: https://stats.nba.com/stats/alltimeleadersgrids?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode_simple			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
TopX	topx			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
player_id	integer	Unique player identifier.
player_name	character	Player name.
tov	numeric	Turnovers.
tov_rank	integer
is_active_flag	character

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

Example

nba_stats_alltimeleadersgrids(league_id='00')

Last validated n/a.

nba_stats_assistleaders

GET /stats/assistleaders

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

Valid URL: https://stats.nba.com/stats/assistleaders?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode_simple			Y
PlayerOrTeam	player_or_team			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_playoffs			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
rank	integer	Rank.
player_id	integer	Unique player identifier.
player	character	Player name.
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').
jersey_num	character	Jersey number worn by the player.
player_position	character	Position of the player accordinng to NGS
ast	numeric	Assists.

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

Example

nba_stats_assistleaders(league_id='00')

Last validated n/a.

nba_stats_assisttracker

GET /stats/assisttracker

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

Valid URL: https://stats.nba.com/stats/assisttracker?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
College	college_nullable			Y
Conference	conference_nullable			Y
Country	country_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftYear	draft_year_nullable			Y
GameScope	game_scope_simple_nullable			Y
Height	height_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple_nullable			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
Season	season_nullable			Y
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
Weight	weight_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
assists	numeric	Total assists.

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

Example

nba_stats_assisttracker(league_id='00')

Last validated n/a.

nba_stats_boxscoreadvancedv3

GET /stats/boxscoreadvancedv3

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

Valid URL: https://stats.nba.com/stats/boxscoreadvancedv3

API Parameter	Python	Pattern	Required	Nullable	Description
EndPeriod	end_period			Y
EndRange	end_range			Y
GameID	game_id			Y
RangeType	range_type			Y
StartPeriod	start_period			Y
StartRange	start_range			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
pie	numeric	Player Impact Estimate (0-1).
assistpercentage	numeric
assistratio	numeric
assisttoturnover	numeric
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
defensiverating	numeric
defensivereboundpercentage	numeric
effectivefieldgoalpercentage	numeric
estimateddefensiverating	numeric
estimatednetrating	numeric
estimatedoffensiverating	numeric
estimatedpace	numeric
estimatedusagepercentage	numeric
familyname	character
firstname	character	Firstname.
gameid	character
jerseynum	character
minutes	character	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
namei	character
netrating	numeric
offensiverating	numeric
offensivereboundpercentage	numeric
pace	numeric	Possessions per 48 minutes.
paceper40	numeric
personid	integer
playerslug	character
position	character	Listed roster position (G, F, C, etc.).
possessions	numeric	Possessions used.
reboundpercentage	numeric
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character
teamtricode	character
trueshootingpercentage	numeric
turnoverratio	numeric
usagepercentage	numeric

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

Example

nba_stats_boxscoreadvancedv3()

Last validated n/a.

nba_stats_boxscoredefensivev2

GET /stats/boxscoredefensivev2

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

Valid URL: https://stats.nba.com/stats/boxscoredefensivev2

API Parameter	Python	Pattern	Required	Nullable	Description
GameID	game_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
blocks	integer	Total blocks.
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
defensiverebounds	integer	Rebounding metric for defensiverebounds in the requested NBA or WNBA Stats split.
familyname	character	Display name for familyname associated with this NBA or WNBA Stats row.
firstname	character	Firstname.
gameid	character	Unique stats.nba.com game identifier in endpoints that use compact schedule field names.
jerseynum	character	NBA or WNBA Stats value for jerseynum in the boxscoredefensivev2 result set.
matchupassists	integer	Passing or assist metric for matchupassists in the requested NBA or WNBA Stats split.
matchupfieldgoalpercentage	numeric	Percentage or rate for matchupfieldgoalpercentage in the requested NBA or WNBA Stats split.
matchupfieldgoalsattempted	integer	Shooting metric for matchupfieldgoalsattempted in the requested NBA or WNBA Stats split.
matchupfieldgoalsmade	integer	Shooting metric for matchupfieldgoalsmade in the requested NBA or WNBA Stats split.
matchupminutes	character	NBA or WNBA Stats value for matchupminutes in the boxscoredefensivev2 result set.
matchupthreepointerpercentage	numeric	Percentage or rate for matchupthreepointerpercentage in the requested NBA or WNBA Stats split.
matchupthreepointersattempted	integer	Shooting metric for matchupthreepointersattempted in the requested NBA or WNBA Stats split.
matchupthreepointersmade	integer	Shooting metric for matchupthreepointersmade in the requested NBA or WNBA Stats split.
matchupturnovers	integer	Turnover or loose-ball metric for matchupturnovers in the requested NBA or WNBA Stats split.
namei	character	NBA or WNBA Stats value for namei in the boxscoredefensivev2 result set.
partialpossessions	numeric	Estimated partial possessions credited to the stint or rotation interval.
personid	integer	Stats API identifier for personid associated with this NBA or WNBA Stats row.
playerpoints	integer	Scoring or score-margin metric for playerpoints in the requested NBA or WNBA Stats split.
playerslug	character	URL slug for playerslug used by NBA or WNBA Stats pages.
position	character	Listed roster position (G, F, C, etc.).
steals	integer	Total steals.
switcheson	integer	NBA or WNBA Stats value for switcheson in the boxscoredefensivev2 result set.
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character	URL slug for teamslug used by NBA or WNBA Stats pages.
teamtricode	character	Three-letter team code used by NBA or WNBA Stats schedule and scoreboard feeds.

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

Example

nba_stats_boxscoredefensivev2()

Last validated n/a.

nba_stats_boxscorefourfactorsv3

GET /stats/boxscorefourfactorsv3

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

Valid URL: https://stats.nba.com/stats/boxscorefourfactorsv3

API Parameter	Python	Pattern	Required	Nullable	Description
EndPeriod	end_period			Y
EndRange	end_range			Y
GameID	game_id			Y
RangeType	range_type			Y
StartPeriod	start_period			Y
StartRange	start_range			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
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
effectivefieldgoalpercentage	numeric
familyname	character
firstname	character	Firstname.
freethrowattemptrate	numeric
gameid	character
jerseynum	character
minutes	character	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
namei	character
offensivereboundpercentage	numeric
oppeffectivefieldgoalpercentage	numeric
oppfreethrowattemptrate	numeric
oppoffensivereboundpercentage	numeric
oppteamturnoverpercentage	numeric
personid	integer
playerslug	character
position	character	Listed roster position (G, F, C, etc.).
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character
teamtricode	character
teamturnoverpercentage	numeric

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

Example

nba_stats_boxscorefourfactorsv3()

Last validated n/a.

nba_stats_boxscorematchupsv3

GET /stats/boxscorematchupsv3

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

Valid URL: https://stats.nba.com/stats/boxscorematchupsv3

API Parameter	Python	Pattern	Required	Nullable	Description
GameID	game_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
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
familyname	character	Player's family name in the NBA or WNBA Stats matchup boxscore row.
firstname	character	Firstname.
gameid	character	Unique stats.nba.com game identifier in endpoints that use compact schedule field names.
jerseynum	character	Player jersey number shown in the NBA or WNBA Stats matchup boxscore row.
namei	character	Abbreviated player display name used in the NBA or WNBA Stats matchup boxscore row.
personid	integer	NBA or WNBA Stats player identifier associated with the matchup boxscore row.
playerslug	character	URL slug for the player on NBA or WNBA Stats pages.
position	character	Listed roster position (G, F, C, etc.).
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character	URL slug for teamslug used by NBA or WNBA Stats pages.
teamtricode	character	Three-letter team code used by NBA or WNBA Stats schedule and scoreboard feeds.

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

Example

nba_stats_boxscorematchupsv3()

Last validated n/a.

nba_stats_boxscoremiscv3

GET /stats/boxscoremiscv3

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

Valid URL: https://stats.nba.com/stats/boxscoremiscv3

API Parameter	Python	Pattern	Required	Nullable	Description
EndPeriod	end_period			Y
EndRange	end_range			Y
GameID	game_id			Y
RangeType	range_type			Y
StartPeriod	start_period			Y
StartRange	start_range			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
blocks	integer	Total blocks.
blocksagainst	integer
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
familyname	character
firstname	character	Firstname.
foulsdrawn	integer
foulspersonal	integer
gameid	character
jerseynum	character
minutes	character	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
namei	character
opppointsfastbreak	integer
opppointsoffturnovers	integer
opppointspaint	integer
opppointssecondchance	integer
personid	integer
playerslug	character
pointsfastbreak	integer
pointsoffturnovers	integer
pointspaint	integer
pointssecondchance	integer
position	character	Listed roster position (G, F, C, etc.).
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character
teamtricode	character

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

Example

nba_stats_boxscoremiscv3()

Last validated n/a.

nba_stats_boxscoreplayertrackv3

GET /stats/boxscoreplayertrackv3

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

Valid URL: https://stats.nba.com/stats/boxscoreplayertrackv3

API Parameter	Python	Pattern	Required	Nullable	Description
GameID	game_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
assists	integer	Total assists.
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
contestedfieldgoalpercentage	numeric	Percentage or rate for contestedfieldgoalpercentage in the requested NBA or WNBA Stats split.
contestedfieldgoalsattempted	integer	Shooting metric for contestedfieldgoalsattempted in the requested NBA or WNBA Stats split.
contestedfieldgoalsmade	integer	Shooting metric for contestedfieldgoalsmade in the requested NBA or WNBA Stats split.
defendedatrimfieldgoalpercentage	numeric	Percentage or rate for defendedatrimfieldgoalpercentage in the requested NBA or WNBA Stats split.
defendedatrimfieldgoalsattempted	integer	Shooting metric for defendedatrimfieldgoalsattempted in the requested NBA or WNBA Stats split.
defendedatrimfieldgoalsmade	integer	Shooting metric for defendedatrimfieldgoalsmade in the requested NBA or WNBA Stats split.
distance	numeric	Distance value (in feet for shot data; otherwise context-dependent).
familyname	character	Display name for familyname associated with this NBA or WNBA Stats row.
fieldgoalpercentage	numeric	Percentage or rate for fieldgoalpercentage in the requested NBA or WNBA Stats split.
firstname	character	Firstname.
freethrowassists	integer	Shooting metric for freethrowassists in the requested NBA or WNBA Stats split.
gameid	character	Unique stats.nba.com game identifier in endpoints that use compact schedule field names.
jerseynum	character	NBA or WNBA Stats value for jerseynum in the boxscoreplayertrackv3 result set.
minutes	character	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
namei	character	NBA or WNBA Stats value for namei in the boxscoreplayertrackv3 result set.
passes	integer	Passes.
personid	integer	Stats API identifier for personid associated with this NBA or WNBA Stats row.
playerslug	character	URL slug for playerslug used by NBA or WNBA Stats pages.
position	character	Listed roster position (G, F, C, etc.).
reboundchancesdefensive	integer	Rebounding metric for reboundchancesdefensive in the requested NBA or WNBA Stats split.
reboundchancesoffensive	integer	Rebounding metric for reboundchancesoffensive in the requested NBA or WNBA Stats split.
reboundchancestotal	integer	Rebounding metric for reboundchancestotal in the requested NBA or WNBA Stats split.
secondaryassists	integer	Passing or assist metric for secondaryassists in the requested NBA or WNBA Stats split.
speed	numeric	Speed.
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character	URL slug for teamslug used by NBA or WNBA Stats pages.
teamtricode	character	Three-letter team code used by NBA or WNBA Stats schedule and scoreboard feeds.
touches	integer	Touches.
uncontestedfieldgoalsattempted	integer	Shooting metric for uncontestedfieldgoalsattempted in the requested NBA or WNBA Stats split.
uncontestedfieldgoalsmade	integer	Shooting metric for uncontestedfieldgoalsmade in the requested NBA or WNBA Stats split.
uncontestedfieldgoalspercentage	numeric	Percentage or rate for uncontestedfieldgoalspercentage in the requested NBA or WNBA Stats split.

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

Example

nba_stats_boxscoreplayertrackv3()

Last validated n/a.

nba_stats_boxscorescoringv3

GET /stats/boxscorescoringv3

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

Valid URL: https://stats.nba.com/stats/boxscorescoringv3

API Parameter	Python	Pattern	Required	Nullable	Description
EndPeriod	end_period			Y
EndRange	end_range			Y
GameID	game_id			Y
RangeType	range_type			Y
StartPeriod	start_period			Y
StartRange	start_range			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
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
familyname	character
firstname	character	Firstname.
gameid	character
jerseynum	character
minutes	character	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
namei	character
percentageassisted2pt	numeric
percentageassisted3pt	numeric
percentageassistedfgm	numeric
percentagefieldgoalsattempted2pt	numeric
percentagefieldgoalsattempted3pt	numeric
percentagepoints2pt	numeric
percentagepoints3pt	numeric
percentagepointsfastbreak	numeric
percentagepointsfreethrow	numeric
percentagepointsmidrange2pt	numeric
percentagepointsoffturnovers	numeric
percentagepointspaint	numeric
percentageunassisted2pt	numeric
percentageunassisted3pt	numeric
percentageunassistedfgm	numeric
personid	integer
playerslug	character
position	character	Listed roster position (G, F, C, etc.).
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character
teamtricode	character

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

Example

nba_stats_boxscorescoringv3()

Last validated n/a.

nba_stats_boxscoresummaryv2

GET /stats/boxscoresummaryv2

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

Valid URL: https://stats.nba.com/stats/boxscoresummaryv2

API Parameter	Python	Pattern	Required	Nullable	Description
GameID	game_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
game_date_est	character	Game date est.
game_sequence	integer	Game sequence.
game_id	character	Unique game identifier.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_city_name	character	Team city name.
team_nickname	character	Team nickname.
team_wins_losses	character	Team wins losses.
pts_qtr1	integer	Pts qtr1.
pts_qtr2	integer	Pts qtr2.
pts_qtr3	integer	Pts qtr3.
pts_qtr4	integer	Pts qtr4.
pts_ot1	integer	Pts ot1.
pts_ot2	integer	Scoring or score-margin metric for points ot2 in the requested NBA or WNBA Stats split.
pts_ot3	integer	Scoring or score-margin metric for points ot3 in the requested NBA or WNBA Stats split.
pts_ot4	integer	Scoring or score-margin metric for points ot4 in the requested NBA or WNBA Stats split.
pts_ot5	integer	Scoring or score-margin metric for points ot5 in the requested NBA or WNBA Stats split.
pts_ot6	integer	Scoring or score-margin metric for points ot6 in the requested NBA or WNBA Stats split.
pts_ot7	integer	Scoring or score-margin metric for points ot7 in the requested NBA or WNBA Stats split.
pts_ot8	integer	Scoring or score-margin metric for points ot8 in the requested NBA or WNBA Stats split.
pts_ot9	integer	Scoring or score-margin metric for points ot9 in the requested NBA or WNBA Stats split.
pts_ot10	integer	Scoring or score-margin metric for points ot10 in the requested NBA or WNBA Stats split.
pts	integer	Points scored.

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

Example

nba_stats_boxscoresummaryv2()

Last validated n/a.

nba_stats_boxscoretraditionalv3

GET /stats/boxscoretraditionalv3

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

Valid URL: https://stats.nba.com/stats/boxscoretraditionalv3

API Parameter	Python	Pattern	Required	Nullable	Description
EndPeriod	end_period			Y
EndRange	end_range			Y
GameID	game_id			Y
RangeType	range_type			Y
StartPeriod	start_period			Y
StartRange	start_range			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
assists	integer	Total assists.
bench_assists	integer
bench_blocks	integer
bench_fieldgoalsattempted	integer
bench_fieldgoalsmade	integer
bench_fieldgoalspercentage	numeric
bench_foulspersonal	integer
bench_freethrowsattempted	integer
bench_freethrowsmade	integer
bench_freethrowspercentage	numeric
bench_minutes	character
bench_points	integer	Points scored by the bench.
bench_reboundsdefensive	integer
bench_reboundsoffensive	integer
bench_reboundstotal	integer
bench_steals	integer
bench_threepointersattempted	integer
bench_threepointersmade	integer
bench_threepointerspercentage	numeric
bench_turnovers	integer
blocks	integer	Total blocks.
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
familyname	character
fieldgoalsattempted	integer
fieldgoalsmade	integer
fieldgoalspercentage	numeric
firstname	character	Firstname.
foulspersonal	integer
freethrowsattempted	integer
freethrowsmade	integer
freethrowspercentage	numeric
gameid	character
jerseynum	character
minutes	character	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
namei	character
personid	integer
playerslug	character
plusminuspoints	numeric
points	integer	Points scored.
position	character	Listed roster position (G, F, C, etc.).
reboundsdefensive	integer
reboundsoffensive	integer
reboundstotal	integer
starters_assists	integer
starters_blocks	integer
starters_fieldgoalsattempted	integer
starters_fieldgoalsmade	integer
starters_fieldgoalspercentage	numeric
starters_foulspersonal	integer
starters_freethrowsattempted	integer
starters_freethrowsmade	integer
starters_freethrowspercentage	numeric
starters_minutes	character
starters_points	integer
starters_reboundsdefensive	integer
starters_reboundsoffensive	integer
starters_reboundstotal	integer
starters_steals	integer
starters_threepointersattempted	integer
starters_threepointersmade	integer
starters_threepointerspercentage	numeric
starters_turnovers	integer
steals	integer	Total steals.
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character
teamtricode	character
threepointersattempted	integer
threepointersmade	integer
threepointerspercentage	numeric
turnovers	integer	Total turnovers.

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

Example

nba_stats_boxscoretraditionalv3()

Last validated n/a.

nba_stats_boxscoreusagev3

GET /stats/boxscoreusagev3

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

Valid URL: https://stats.nba.com/stats/boxscoreusagev3

API Parameter	Python	Pattern	Required	Nullable	Description
EndPeriod	end_period			Y
EndRange	end_range			Y
GameID	game_id			Y
RangeType	range_type			Y
StartPeriod	start_period			Y
StartRange	start_range			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
comment	character	Player status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
familyname	character
firstname	character	Firstname.
gameid	character
jerseynum	character
minutes	character	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
namei	character
percentageassists	numeric
percentageblocks	numeric
percentageblocksallowed	numeric
percentagefieldgoalsattempted	numeric
percentagefieldgoalsmade	numeric
percentagefreethrowsattempted	numeric
percentagefreethrowsmade	numeric
percentagepersonalfouls	numeric
percentagepersonalfoulsdrawn	numeric
percentagepoints	numeric
percentagereboundsdefensive	numeric
percentagereboundsoffensive	numeric
percentagereboundstotal	numeric
percentagesteals	numeric
percentagethreepointersattempted	numeric
percentagethreepointersmade	numeric
percentageturnovers	numeric
personid	integer
playerslug	character
position	character	Listed roster position (G, F, C, etc.).
teamcity	character	Teamcity.
teamid	integer	Teamid.
teamname	character	Teamname.
teamslug	character
teamtricode	character
usagepercentage	numeric

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

Example

nba_stats_boxscoreusagev3()

Last validated n/a.

nba_stats_commonallplayers

GET /stats/commonallplayers

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

Valid URL: https://stats.nba.com/stats/commonallplayers?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
IsOnlyCurrentSeason	is_only_current_season			Y
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).

Returns

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

col_name	type	description
person_id	integer	Unique player identifier (V3 endpoints).
display_last_comma_first	character
display_first_last	character
rosterstatus	integer
from_year	character	First season.
to_year	character	Most recent season.
playercode	character
player_slug	character	URL-safe player identifier.
team_id	integer	Unique team identifier.
team_city	character	Team city or region (e.g. 'Las Vegas').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_code	character	Internal team code.
team_slug	character	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
games_played_flag	character
otherleague_experience_ch	character
is_nba_assigned	integer
nba_assigned_team_id	integer

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

Example

nba_stats_commonallplayers(league_id='00')

Last validated n/a.

nba_stats_commonplayerinfo

GET /stats/commonplayerinfo

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

Valid URL: https://stats.nba.com/stats/commonplayerinfo?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
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.
display_first_last	character	NBA or WNBA Stats value for display first last in the commonplayerinfo result set.
display_last_comma_first	character	NBA or WNBA Stats value for display last comma first in the commonplayerinfo result set.
display_fi_last	character	NBA or WNBA Stats value for display fi last in the commonplayerinfo result set.
player_slug	character	URL-safe player identifier.
birthdate	character	Date of birth.
school	character	Player school / pre-draft team.
country	character	Venue country.
last_affiliation	character	NBA or WNBA Stats value for last affiliation in the commonplayerinfo result set.
height	character	Player height (string e.g. '6-2' or inches).
weight	character	Player weight in pounds.
season_exp	integer	NBA or WNBA Stats value for season exp in the commonplayerinfo result set.
jersey	character	Jersey number worn by the player.
position	character	Listed roster position (G, F, C, etc.).
rosterstatus	character	NBA or WNBA Stats value for rosterstatus in the commonplayerinfo result set.
games_played_current_season_flag	character	Flag indicating games played current season flag for the requested NBA or WNBA Stats context.
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_code	character	Internal team code.
team_city	character	Team city or region (e.g. 'Las Vegas').
playercode	character	NBA or WNBA Stats value for playercode in the commonplayerinfo result set.
from_year	integer	First season.
to_year	integer	Most recent season.
dleague_flag	character	Flag indicating dleague flag for the requested NBA or WNBA Stats context.
nba_flag	character	Flag indicating NBA flag for the requested NBA or WNBA Stats context.
games_played_flag	character	Flag indicating games played flag for the requested NBA or WNBA Stats context.
draft_year	character	Draft year (4-digit).
draft_round	character	Round of the draft selection.
draft_number	character	The number pick that was used to select a given player.
greatest_75_flag	character	Flag indicating greatest 75 flag for the requested NBA or WNBA Stats context.

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

Example

nba_stats_commonplayerinfo(league_id='00')

Last validated n/a.

nba_stats_commonplayoffseries

GET /stats/commonplayoffseries

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

Valid URL: https://stats.nba.com/stats/commonplayoffseries?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
SeriesID	series_id_nullable			Y

Returns

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

col_name	type	description
game_id	character	Unique game identifier.
home_team_id	integer	Unique identifier for the home team.
visitor_team_id	integer	Unique identifier for visitor team.
series_id	character	Series identifier (e.g. 'W_1').
game_num	integer	NBA or WNBA Stats value for game number in the commonplayoffseries result set.

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

Example

nba_stats_commonplayoffseries(league_id='00')

Last validated n/a.

nba_stats_commonteamroster

GET /stats/commonteamroster

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

Valid URL: https://stats.nba.com/stats/commonteamroster?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
TeamID	team_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
teamid	integer	Teamid.
season	character	Season year.
leagueid	character
player	character	Player name.
nickname	character	Team or athlete nickname.
player_slug	character	URL-safe player identifier.
num	character	Inning number.
position	character	Listed roster position (G, F, C, etc.).
height	character	Player height (string e.g. '6-2' or inches).
weight	character	Player weight in pounds.
birth_date	character	Date of birth (YYYY-MM-DD).
age	numeric	Player age (in years).
exp	character	Exp.
school	character	Player school / pre-draft team.
player_id	integer	Unique player identifier.
how_acquired	character

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

Example

nba_stats_commonteamroster(league_id='00')

Last validated n/a.

nba_stats_commonteamyears

GET /stats/commonteamyears

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

Valid URL: https://stats.nba.com/stats/commonteamyears?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y

Returns

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

col_name	type	description
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
min_year	character	Minimum year queried (echoes min_year).
max_year	character	Maximum year queried (echoes max_year).
abbreviation	character	Short abbreviation.

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

Example

nba_stats_commonteamyears(league_id='00')

Last validated n/a.

nba_stats_cumestatsplayer

GET /stats/cumestatsplayer

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

Valid URL: https://stats.nba.com/stats/cumestatsplayer?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
GameIDs	game_ids			Y
LeagueID	league_id			Y
PlayerID	player_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_all_star			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
display_fi_last	character
person_id	integer	Unique player identifier (V3 endpoints).
jersey_num	character	Jersey number worn by the player.
gp	integer	Games played.
gs	integer	Games started.
actual_minutes	integer
actual_seconds	integer
fg	integer
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3	integer
fg3a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ft	integer
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
off_reb	integer
def_reb	integer
tot_reb	integer
ast	integer	Assists.
pf	integer	Personal fouls.
dq	integer
stl	integer	Steals.
turnovers	integer	Total turnovers.
blk	integer	Blocks.
pts	integer	Points scored.
max_actual_minutes	integer
max_actual_seconds	integer
max_reb	integer
max_ast	integer
max_stl	integer
max_turnovers	integer
max_blk	integer
max_pts	integer
avg_actual_minutes	integer
avg_actual_seconds	numeric
avg_tot_reb	numeric
avg_ast	numeric
avg_stl	numeric
avg_turnovers	numeric
avg_blk	numeric
avg_pts	numeric
per_min_tot_reb	numeric
per_min_ast	numeric
per_min_stl	numeric
per_min_turnovers	numeric
per_min_blk	numeric
per_min_pts	numeric

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

Example

nba_stats_cumestatsplayer(league_id='00')

Last validated n/a.

nba_stats_cumestatsplayergames

GET /stats/cumestatsplayergames

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

Valid URL: https://stats.nba.com/stats/cumestatsplayergames?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Location	location_nullable			Y
Outcome	outcome_nullable			Y
PlayerID	player_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_all_star			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsTeamID	vs_team_id_nullable			Y

Returns

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

col_name	type	description
matchup	character	Matchup.
game_id	character	Unique game identifier.

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

Example

nba_stats_cumestatsplayergames(league_id='00')

Last validated n/a.

nba_stats_cumestatsteam

GET /stats/cumestatsteam

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

Valid URL: https://stats.nba.com/stats/cumestatsteam?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
GameIDs	game_ids			Y
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_all_star			Y
TeamID	team_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
jersey_num	character	Jersey number worn by the player.
player	character	Player name.
person_id	character	Unique player identifier (V3 endpoints).
team_id	character	Unique team identifier.
gp	character	Games played.
gs	character	Games started.
actual_minutes	character
actual_seconds	character
fg	character
fga	character	Field goal attempts.
fg_pct	character	Field goal percentage (0-1).
fg3	character
fg3a	character	Three-point field goal attempts.
fg3_pct	character	Three-point field goal percentage (0-1).
ft	character
fta	character	Free throw attempts.
ft_pct	character	Free throw percentage (0-1).
off_reb	character
def_reb	character
tot_reb	character
ast	character	Assists.
pf	character	Personal fouls.
dq	character
stl	character	Steals.
turnovers	character	Total turnovers.
blk	character	Blocks.
pts	character	Points scored.
max_actual_minutes	character
max_actual_seconds	character
max_reb	character
max_ast	character
max_stl	character
max_turnovers	character
max_blkp	character
max_pts	character
avg_actual_minutes	character
avg_actual_seconds	character
avg_reb	character
avg_ast	character
avg_stl	character
avg_turnovers	character
avg_blkp	character
avg_pts	character
per_min_reb	character
per_min_ast	character
per_min_stl	character
per_min_turnovers	character
per_min_blk	character
per_min_pts	character

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

Example

nba_stats_cumestatsteam(league_id='00')

Last validated n/a.

nba_stats_cumestatsteamgames

GET /stats/cumestatsteamgames

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

Valid URL: https://stats.nba.com/stats/cumestatsteamgames?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Location	location_nullable			Y
Outcome	outcome_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonID	season_id_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsTeamID	vs_team_id_nullable			Y

Returns

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

col_name	type	description
matchup	character	Matchup.
game_id	character	Unique game identifier.

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

Example

nba_stats_cumestatsteamgames(league_id='00')

Last validated n/a.

nba_stats_draftcombinedrillresults

GET /stats/draftcombinedrillresults

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

Valid URL: https://stats.nba.com/stats/draftcombinedrillresults?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
SeasonYear	season_year			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
temp_player_id	integer
player_id	integer	Unique player identifier.
first_name	character	Player's first name.
last_name	character	Player's last name.
player_name	character	Player name.
position	character	Listed roster position (G, F, C, etc.).
standing_vertical_leap	numeric
max_vertical_leap	numeric
lane_agility_time	numeric
modified_lane_agility_time	numeric
three_quarter_sprint	numeric
bench_press	character

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

Example

nba_stats_draftcombinedrillresults(league_id='00')

Last validated n/a.

nba_stats_draftcombinenonstationaryshooting

GET /stats/draftcombinenonstationaryshooting

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

Valid URL: https://stats.nba.com/stats/draftcombinenonstationaryshooting?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
SeasonYear	season_year			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
temp_player_id	integer
player_id	integer	Unique player identifier.
first_name	character	Player's first name.
last_name	character	Player's last name.
player_name	character	Player name.
position	character	Listed roster position (G, F, C, etc.).
off_drib_fifteen_break_left_made	character
off_drib_fifteen_break_left_attempt	character
off_drib_fifteen_break_left_pct	character
off_drib_fifteen_top_key_made	character
off_drib_fifteen_top_key_attempt	character
off_drib_fifteen_top_key_pct	character
off_drib_fifteen_break_right_made	character
off_drib_fifteen_break_right_attempt	character
off_drib_fifteen_break_right_pct	character
off_drib_college_break_left_made	integer
off_drib_college_break_left_attempt	integer
off_drib_college_break_left_pct	numeric
off_drib_college_top_key_made	character
off_drib_college_top_key_attempt	character
off_drib_college_top_key_pct	character
off_drib_college_break_right_made	character
off_drib_college_break_right_attempt	character
off_drib_college_break_right_pct	character
on_move_fifteen_made	character
on_move_fifteen_attempt	character
on_move_fifteen_pct	character
on_move_college_made	integer
on_move_college_attempt	integer
on_move_college_pct	numeric

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

Example

nba_stats_draftcombinenonstationaryshooting(league_id='00')

Last validated n/a.

nba_stats_draftcombineplayeranthro

GET /stats/draftcombineplayeranthro

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

Valid URL: https://stats.nba.com/stats/draftcombineplayeranthro?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
SeasonYear	season_year			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
temp_player_id	integer
player_id	integer	Unique player identifier.
first_name	character	Player's first name.
last_name	character	Player's last name.
player_name	character	Player name.
position	character	Listed roster position (G, F, C, etc.).
height_wo_shoes	numeric
height_wo_shoes_ft_in	character
height_w_shoes	character
height_w_shoes_ft_in	character
weight	character	Player weight in pounds.
wingspan	numeric
wingspan_ft_in	character
standing_reach	numeric
standing_reach_ft_in	character
body_fat_pct	character
hand_length	numeric
hand_width	numeric

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

Example

nba_stats_draftcombineplayeranthro(league_id='00')

Last validated n/a.

nba_stats_draftcombinespotshooting

GET /stats/draftcombinespotshooting

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

Valid URL: https://stats.nba.com/stats/draftcombinespotshooting?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
SeasonYear	season_year			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
temp_player_id	integer
player_id	integer	Unique player identifier.
first_name	character	Player's first name.
last_name	character	Player's last name.
player_name	character	Player name.
position	character	Listed roster position (G, F, C, etc.).
fifteen_corner_left_made	character
fifteen_corner_left_attempt	character
fifteen_corner_left_pct	character
fifteen_break_left_made	character
fifteen_break_left_attempt	character
fifteen_break_left_pct	character
fifteen_top_key_made	character
fifteen_top_key_attempt	character
fifteen_top_key_pct	character
fifteen_break_right_made	character
fifteen_break_right_attempt	character
fifteen_break_right_pct	character
fifteen_corner_right_made	character
fifteen_corner_right_attempt	character
fifteen_corner_right_pct	character
college_corner_left_made	integer
college_corner_left_attempt	integer
college_corner_left_pct	numeric
college_break_left_made	character
college_break_left_attempt	character
college_break_left_pct	character
college_top_key_made	character
college_top_key_attempt	character
college_top_key_pct	character
college_break_right_made	character
college_break_right_attempt	character
college_break_right_pct	character
college_corner_right_made	character
college_corner_right_attempt	character
college_corner_right_pct	character
nba_corner_left_made	character
nba_corner_left_attempt	character
nba_corner_left_pct	character
nba_break_left_made	character
nba_break_left_attempt	character
nba_break_left_pct	character
nba_top_key_made	character
nba_top_key_attempt	character
nba_top_key_pct	character
nba_break_right_made	character
nba_break_right_attempt	character
nba_break_right_pct	character
nba_corner_right_made	character
nba_corner_right_attempt	character
nba_corner_right_pct	character

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

Example

nba_stats_draftcombinespotshooting(league_id='00')

Last validated n/a.

nba_stats_draftcombinestats

GET /stats/draftcombinestats

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

Valid URL: https://stats.nba.com/stats/draftcombinestats?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
SeasonYear	season_all_time			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	character	Season year.
player_id	integer	Unique player identifier.
first_name	character	Player's first name.
last_name	character	Player's last name.
player_name	character	Player name.
position	character	Listed roster position (G, F, C, etc.).
height_wo_shoes	numeric
height_wo_shoes_ft_in	character
height_w_shoes	character
height_w_shoes_ft_in	character
weight	character	Player weight in pounds.
wingspan	numeric
wingspan_ft_in	character
standing_reach	numeric
standing_reach_ft_in	character
body_fat_pct	character
hand_length	numeric
hand_width	numeric
standing_vertical_leap	numeric
max_vertical_leap	numeric
lane_agility_time	numeric
modified_lane_agility_time	numeric
three_quarter_sprint	numeric
bench_press	character
spot_fifteen_corner_left	character
spot_fifteen_break_left	character
spot_fifteen_top_key	character
spot_fifteen_break_right	character
spot_fifteen_corner_right	character
spot_college_corner_left	character
spot_college_break_left	character
spot_college_top_key	character
spot_college_break_right	character
spot_college_corner_right	character
spot_nba_corner_left	character
spot_nba_break_left	character
spot_nba_top_key	character
spot_nba_break_right	character
spot_nba_corner_right	character
off_drib_fifteen_break_left	character
off_drib_fifteen_top_key	character
off_drib_fifteen_break_right	character
off_drib_college_break_left	character
off_drib_college_top_key	character
off_drib_college_break_right	character
on_move_fifteen	character
on_move_college	character

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

Example

nba_stats_draftcombinestats(league_id='00')

Last validated n/a.

nba_stats_fantasywidget

GET /stats/fantasywidget

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

Valid URL: https://stats.nba.com/stats/fantasywidget?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
ActivePlayers	active_players			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
PORound	po_round_nullable			Y
PlayerID	player_id_nullable			Y
Position	position_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id_nullable			Y
TodaysOpponent	todays_opponent			Y
TodaysPlayers	todays_players			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
player_id	integer	Unique player identifier.
player_name	character	Player name.
player_position	character	Position of the player accordinng to NGS
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
gp	integer	Games played.
min	numeric	Minutes played.
fan_duel_pts	numeric
nba_fantasy_pts	numeric
pts	numeric	Points scored.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
blk	numeric	Blocks.
stl	numeric	Steals.
tov	numeric	Turnovers.
fg3m	numeric	Three-point field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).

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

Example

nba_stats_fantasywidget(league_id='00')

Last validated n/a.

nba_stats_franchisehistory

GET /stats/franchisehistory

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

Valid URL: https://stats.nba.com/stats/franchisehistory?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y

Returns

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

col_name	type	description
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team_city	character	Team city or region (e.g. 'Las Vegas').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
start_year	character	Span starting year.
end_year	character	Span ending year.
years	integer	Years.
games	integer	Games played.
wins	integer	Total wins.
losses	integer	Total losses.
win_pct	numeric	Win percentage (0-1 decimal).
po_appearances	integer	NBA or WNBA Stats value for playoff appearances in the franchisehistory result set.
div_titles	integer	NBA or WNBA Stats value for div titles in the franchisehistory result set.
conf_titles	integer	NBA or WNBA Stats value for conf titles in the franchisehistory result set.
league_titles	integer	NBA or WNBA Stats value for league titles in the franchisehistory result set.

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

Example

nba_stats_franchisehistory(league_id='00')

Last validated n/a.

nba_stats_franchiseleaders

GET /stats/franchiseleaders

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

Valid URL: https://stats.nba.com/stats/franchiseleaders?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
TeamID	team_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
team_id	integer	Unique team identifier.
pts	integer	Points scored.
pts_person_id	integer	Stats API identifier for points person identifier associated with this NBA or WNBA Stats row.
pts_player	character	Scoring or score-margin metric for points player in the requested NBA or WNBA Stats split.
ast	integer	Assists.
ast_person_id	integer	Stats API identifier for assists person identifier associated with this NBA or WNBA Stats row.
ast_player	character	NBA or WNBA Stats value for assists player in the franchiseleaders result set.
reb	integer	Rebounds per game.
reb_person_id	integer	Stats API identifier for rebounds person identifier associated with this NBA or WNBA Stats row.
reb_player	character	Rebounding metric for rebounds player in the requested NBA or WNBA Stats split.
blk	integer	Blocks.
blk_person_id	integer	Stats API identifier for blocks person identifier associated with this NBA or WNBA Stats row.
blk_player	character	NBA or WNBA Stats value for blocks player in the franchiseleaders result set.
stl	integer	Steals.
stl_person_id	integer	Stats API identifier for steals person identifier associated with this NBA or WNBA Stats row.
stl_player	character	NBA or WNBA Stats value for steals player in the franchiseleaders result set.

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

Example

nba_stats_franchiseleaders(league_id='00')

Last validated n/a.

nba_stats_franchiseleaderswrank

GET /stats/franchiseleaderswrank

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

Valid URL: https://stats.nba.com/stats/franchiseleaderswrank?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
TeamID	team_id			Y

Returns

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

col_name	type	description
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team	character	Team-side label or team identifier.
person_id	integer	Unique player identifier (V3 endpoints).
player	character	Player name.
season_type	character	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
active_with_team	integer
gp	integer	Games played.
minutes	numeric	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	numeric	Three-point field goals made.
fg3a	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.
pf	numeric	Personal fouls.
stl	numeric	Steals.
tov	numeric	Turnovers.
blk	numeric	Blocks.
pts	numeric	Points scored.
f_rank_gp	integer
f_rank_minutes	integer
f_rank_fgm	integer
f_rank_fga	integer
f_rank_fg_pct	integer
f_rank_fg3m	integer
f_rank_fg3a	integer
f_rank_fg3_pct	integer
f_rank_ftm	integer
f_rank_fta	integer
f_rank_ft_pct	integer
f_rank_oreb	integer
f_rank_dreb	integer
f_rank_reb	integer
f_rank_ast	integer
f_rank_pf	integer
f_rank_stl	integer
f_rank_tov	integer
f_rank_blk	integer
f_rank_pts	integer

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

Example

nba_stats_franchiseleaderswrank(league_id='00')

Last validated n/a.

nba_stats_franchiseplayers

GET /stats/franchiseplayers

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

Valid URL: https://stats.nba.com/stats/franchiseplayers?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode_detailed			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			Y

Returns

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

col_name	type	description
league_id	character	League identifier ('10' = WNBA).
team_id	integer	Unique team identifier.
team	character	Team-side label or team identifier.
person_id	integer	Unique player identifier (V3 endpoints).
player	character	Player name.
season_type	character	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
active_with_team	integer
gp	integer	Games played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	numeric	Three-point field goals made.
fg3a	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.
pf	numeric	Personal fouls.
stl	numeric	Steals.
tov	numeric	Turnovers.
blk	numeric	Blocks.
pts	numeric	Points scored.

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

Example

nba_stats_franchiseplayers(league_id='00')

Last validated n/a.

nba_stats_gamerotation

GET /stats/gamerotation

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

Valid URL: https://stats.nba.com/stats/gamerotation?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
GameID	game_id			Y
LeagueID	league_id			Y

Returns

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

col_name	type	description
game_id	character	Unique game identifier.
team_id	integer	Unique team identifier.
team_city	character	Team city or region (e.g. 'Las Vegas').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
person_id	integer	Unique player identifier (V3 endpoints).
player_first	character	NBA or WNBA Stats value for player first in the gamerotation result set.
player_last	character	NBA or WNBA Stats value for player last in the gamerotation result set.
in_time_real	numeric	Real-time clock value when the player entered the game rotation stint.
out_time_real	numeric	Real-time clock value when the player exited the game rotation stint.
player_pts	integer	Scoring or score-margin metric for player points in the requested NBA or WNBA Stats split.
pt_diff	numeric	NBA or WNBA Stats value for pt diff in the gamerotation result set.
usg_pct	numeric	Percentage or rate for usage percentage in the requested NBA or WNBA Stats split.

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

Example

nba_stats_gamerotation(league_id='00')

Last validated n/a.

nba_stats_infographicfanduelplayer

GET /stats/infographicfanduelplayer

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

Valid URL: https://stats.nba.com/stats/infographicfanduelplayer

API Parameter	Python	Pattern	Required	Nullable	Description
GameID	game_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
player_id	integer	Unique player identifier.
player_name	character	Player name.
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
jersey_num	character	Jersey number worn by the player.
player_position	character	Position of the player accordinng to NGS
location	character	Location.
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.
usg_pct	numeric	Percentage or rate for usage percentage in the requested NBA or WNBA Stats split.
min	numeric	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	integer	Three-point field goals made.
fg3a	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.
tov	integer	Turnovers.
stl	integer	Steals.
blk	integer	Blocks.
blka	integer	Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pf	integer	Personal fouls.
pfd	integer	Personal fouls drawn for the requested NBA or WNBA Stats split.
pts	integer	Points scored.
plus_minus	integer	Plus/minus point differential while on court.

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

Example

nba_stats_infographicfanduelplayer()

Last validated n/a.

nba_stats_leaguedashlineups

GET /stats/leaguedashlineups

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

Valid URL: https://stats.nba.com/stats/leaguedashlineups?LeagueID=00

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
GroupQuantity	group_quantity			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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_id	character	ESPN group id.
group_name	character	Group name (conference / division).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
sum_time_played	integer	Time value for sum time played in the NBA or WNBA Stats result set.

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

Example

nba_stats_leaguedashlineups(league_id='00')

Last validated n/a.

nba_stats_leaguedashoppptshot

GET /stats/leaguedashoppptshot

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

Valid URL: https://stats.nba.com/stats/leaguedashoppptshot?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
CloseDefDistRange	close_def_dist_range_nullable			Y
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_nullable			Y
DribbleRange	dribble_range_nullable			Y
GameSegment	game_segment_nullable			Y
GeneralRange	general_range_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple			Y
Period	period_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
ShotDistRange	shot_dist_range_nullable			Y
TeamID	team_id_nullable			Y
TouchTimeRange	touch_time_range_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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
gp	integer	Games played.
g	integer	Games played.
fga_frequency	numeric	Shooting metric for fga frequency in the requested NBA or WNBA Stats split.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
efg_pct	numeric	Percentage or rate for efg percentage in the requested NBA or WNBA Stats split.
fg2a_frequency	numeric	Shooting metric for fg2a frequency in the requested NBA or WNBA Stats split.
fg2m	numeric	Shooting metric for fg2m in the requested NBA or WNBA Stats split.
fg2a	numeric	Shooting metric for fg2a in the requested NBA or WNBA Stats split.
fg2_pct	numeric	Percentage or rate for two-point field goals percentage in the requested NBA or WNBA Stats split.
fg3a_frequency	numeric	Shooting metric for fg3a frequency in the requested NBA or WNBA Stats split.
fg3m	numeric	Three-point field goals made.
fg3a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).

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

Example

nba_stats_leaguedashoppptshot(league_id='00')

Last validated n/a.

nba_stats_leaguedashplayerbiostats

GET /stats/leaguedashplayerbiostats

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

Valid URL: https://stats.nba.com/stats/leaguedashplayerbiostats?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
College	college_nullable			Y
Conference	conference_nullable			Y
Country	country_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftYear	draft_year_nullable			Y
GameScope	game_scope_simple_nullable			Y
GameSegment	game_segment_nullable			Y
Height	height_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple			Y
Period	period_nullable			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
Weight	weight_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
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').
age	numeric	Player age (in years).
player_height	character	Participant height (e.g. "6' 5"").
player_height_inches	integer	NBA or WNBA Stats value for player height inches in the leaguedashplayerbiostats result set.
player_weight	character	Participant weight in pounds.
college	character	College.
country	character	Venue country.
draft_year	character	Draft year (4-digit).
draft_round	character	Round of the draft selection.
draft_number	character	The number pick that was used to select a given player.
gp	integer	Games played.
pts	numeric	Points scored.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
net_rating	numeric	Net rating (off rating - def rating).
oreb_pct	numeric	Percentage or rate for offensive rebounds percentage in the requested NBA or WNBA Stats split.
dreb_pct	numeric	Percentage or rate for defensive rebounds percentage in the requested NBA or WNBA Stats split.
usg_pct	numeric	Percentage or rate for usage percentage in the requested NBA or WNBA Stats split.
ts_pct	numeric	True shooting percentage (0-1).
ast_pct	numeric	Assist percentage.

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

Example

nba_stats_leaguedashplayerbiostats(league_id='00')

Last validated n/a.

nba_stats_leaguedashplayerclutch

GET /stats/leaguedashplayerclutch

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

Valid URL: https://stats.nba.com/stats/leaguedashplayerclutch?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
AheadBehind	ahead_behind			Y
ClutchTime	clutch_time			Y
College	college_nullable			Y
Conference	conference_nullable			Y
Country	country_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftYear	draft_year_nullable			Y
GameScope	game_scope_simple_nullable			Y
GameSegment	game_segment_nullable			Y
Height	height_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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
PlusMinus	plus_minus			Y
PointDiff	point_diff			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
Weight	weight_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
group_set	character
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').
age	numeric	Player age (in years).
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
nba_fantasy_pts	numeric
dd2	integer
td3	integer
wnba_fantasy_pts	numeric
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer
nba_fantasy_pts_rank	integer
dd2_rank	integer
td3_rank	integer
wnba_fantasy_pts_rank	integer
team_count	integer

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

Example

nba_stats_leaguedashplayerclutch(league_id='00')

Last validated n/a.

nba_stats_leaguedashplayerptshot

GET /stats/leaguedashplayerptshot

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

Valid URL: https://stats.nba.com/stats/leaguedashplayerptshot?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
CloseDefDistRange	close_def_dist_range_nullable			Y
College	college_nullable			Y
Conference	conference_nullable			Y
Country	country_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftYear	draft_year_nullable			Y
DribbleRange	dribble_range_nullable			Y
GameSegment	game_segment_nullable			Y
GeneralRange	general_range_nullable			Y
Height	height_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple			Y
Period	period_nullable			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
ShotDistRange	shot_dist_range_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
TouchTimeRange	touch_time_range_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
Weight	weight_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
player_id	integer	Unique player identifier.
player_name	character	Player name.
player_last_team_id	integer	Stats API identifier for player last team identifier associated with this NBA or WNBA Stats row.
player_last_team_abbreviation	character	NBA or WNBA Stats value for player last team abbreviation in the leaguedashplayerptshot result set.
age	numeric	Player age (in years).
gp	integer	Games played.
g	integer	Games played.
fga_frequency	numeric	Shooting metric for fga frequency in the requested NBA or WNBA Stats split.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
efg_pct	numeric	Percentage or rate for efg percentage in the requested NBA or WNBA Stats split.
fg2a_frequency	numeric	Shooting metric for fg2a frequency in the requested NBA or WNBA Stats split.
fg2m	numeric	Shooting metric for fg2m in the requested NBA or WNBA Stats split.
fg2a	numeric	Shooting metric for fg2a in the requested NBA or WNBA Stats split.
fg2_pct	numeric	Percentage or rate for two-point field goals percentage in the requested NBA or WNBA Stats split.
fg3a_frequency	numeric	Shooting metric for fg3a frequency in the requested NBA or WNBA Stats split.
fg3m	numeric	Three-point field goals made.
fg3a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).

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

Example

nba_stats_leaguedashplayerptshot(league_id='00')

Last validated n/a.

nba_stats_leaguedashplayershotlocations

GET /stats/leaguedashplayershotlocations

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

Valid URL: https://stats.nba.com/stats/leaguedashplayershotlocations?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
College	college_nullable			Y
Conference	conference_nullable			Y
Country	country_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
DistanceRange	distance_range			Y
Division	division_simple_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftYear	draft_year_nullable			Y
GameScope	game_scope_simple_nullable			Y
GameSegment	game_segment_nullable			Y
Height	height_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_simple			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
Weight	weight_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
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').
age	numeric	Player age (in years).
nickname	character	Team or athlete nickname.
less_than_5_ft_fgm	numeric
less_than_5_ft_fga	numeric
less_than_5_ft_fg_pct	numeric
5-9_ft_fgm	numeric
5-9_ft_fga	numeric
5-9_ft_fg_pct	numeric
10-14_ft_fgm	numeric
10-14_ft_fga	numeric
10-14_ft_fg_pct	numeric
15-19_ft_fgm	numeric
15-19_ft_fga	numeric
15-19_ft_fg_pct	numeric
20-24_ft_fgm	numeric
20-24_ft_fga	numeric
20-24_ft_fg_pct	numeric
25-29_ft_fgm	numeric
25-29_ft_fga	numeric
25-29_ft_fg_pct	numeric
30-34_ft_fgm	numeric
30-34_ft_fga	numeric
30-34_ft_fg_pct	numeric
35-39_ft_fgm	numeric
35-39_ft_fga	numeric
35-39_ft_fg_pct	numeric
40+_ft_fgm	numeric
40+_ft_fga	numeric
40+_ft_fg_pct	numeric

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

Example

nba_stats_leaguedashplayershotlocations(league_id='00')

Last validated n/a.

nba_stats_leaguedashplayerstats

GET /stats/leaguedashplayerstats

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

Valid URL: https://stats.nba.com/stats/leaguedashplayerstats?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
College	college_nullable			Y
Conference	conference_nullable			Y
Country	country_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftYear	draft_year_nullable			Y
GameScope	game_scope_simple_nullable			Y
GameSegment	game_segment_nullable			Y
Height	height_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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
TwoWay	two_way_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
Weight	weight_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
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').
age	numeric	Player age (in years).
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).
fg3m	numeric	Three-point field goals made.
fg3a	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 shot attempts against the player — shots the player attempted that were blocked by opponents.
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn — fouls committed by opponents against this player.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
nba_fantasy_pts	numeric	NBA fantasy points accrued under the standard NBA fantasy scoring formula.
dd2	integer	Number of double-doubles recorded over the span.
td3	integer	Number of triple-doubles recorded over the span.
wnba_fantasy_pts	numeric	WNBA fantasy points accrued under the standard WNBA fantasy scoring formula.
gp_rank	integer	Player's league rank for games played among qualified players (1 = most games).
w_rank	integer	Player's league rank for wins (1 = most wins while active).
l_rank	integer	Player's league rank for losses (1 = most losses while active).
w_pct_rank	integer	Player's league rank for win percentage (1 = highest win pct).
min_rank	integer	Player's league rank for minutes played (1 = most minutes).
fgm_rank	integer	Player's league rank for field goals made (1 = most made).
fga_rank	integer	Player's league rank for field goal attempts (1 = most attempts).
fg_pct_rank	integer	Player's league rank for field goal percentage (1 = highest pct).
fg3m_rank	integer	Player's league rank for three-point field goals made (1 = most made).
fg3a_rank	integer	Player's league rank for three-point field goal attempts (1 = most attempts).
fg3_pct_rank	integer	Player's league rank for three-point percentage (1 = highest pct).
ftm_rank	integer	Player's league rank for free throws made (1 = most made).
fta_rank	integer	Player's league rank for free throw attempts (1 = most attempts).
ft_pct_rank	integer	Player's league rank for free throw percentage (1 = highest pct).
oreb_rank	integer	Player's league rank for offensive rebounds (1 = most offensive rebounds).
dreb_rank	integer	Player's league rank for defensive rebounds (1 = most defensive rebounds).
reb_rank	integer	Player's league rank for total rebounds (1 = most rebounds).
ast_rank	integer	Player's league rank for assists (1 = most assists).
tov_rank	integer	Player's league rank for turnovers — note: lower turnovers is typically better.
stl_rank	integer	Player's league rank for steals (1 = most steals).
blk_rank	integer	Player's league rank for blocked shots (1 = most blocks).
blka_rank	integer	Player's league rank for shots blocked by opponents (1 = most blocked).
pf_rank	integer	Player's league rank for personal fouls committed (1 = most fouls).
pfd_rank	integer	Player's league rank for personal fouls drawn from opponents (1 = most drawn).
pts_rank	integer	Player's league rank for points scored (1 = league leader).
plus_minus_rank	integer	Player's league rank for plus/minus rating (1 = best differential).
nba_fantasy_pts_rank	integer	Player's league rank for NBA fantasy points scored (1 = most fantasy points).
dd2_rank	integer	Player's league rank for double-doubles recorded (1 = most double-doubles).
td3_rank	integer	Player's league rank for triple-doubles recorded (1 = most triple-doubles).
wnba_fantasy_pts_rank	integer	Player's league rank for WNBA fantasy points scored (1 = most fantasy points).
team_count	integer	Number of teams the player appeared for within the span.

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

Example

nba_stats_leaguedashplayerstats(league_id='00')

Last validated n/a.

nba_stats_leaguedashptdefend

GET /stats/leaguedashptdefend

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

Valid URL: https://stats.nba.com/stats/leaguedashptdefend?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
College	college_nullable			Y
Conference	conference_nullable			Y
Country	country_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
DefenseCategory	defense_category			Y
Division	division_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftYear	draft_year_nullable			Y
GameSegment	game_segment_nullable			Y
Height	height_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple			Y
Period	period_nullable			Y
PlayerExperience	player_experience_nullable			Y
PlayerID	player_id_nullable			Y
PlayerPosition	player_position_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
Weight	weight_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
close_def_person_id	integer	Stats API identifier for close defensive person identifier associated with this NBA or WNBA Stats row.
player_name	character	Player name.
player_last_team_id	integer	Stats API identifier for player last team identifier associated with this NBA or WNBA Stats row.
player_last_team_abbreviation	character	NBA or WNBA Stats value for player last team abbreviation in the leaguedashptdefend result set.
player_position	character	Position of the player accordinng to NGS
age	numeric	Player age (in years).
gp	integer	Games played.
g	integer	Games played.
freq	numeric	NBA or WNBA Stats value for freq in the leaguedashptdefend result set.
d_fgm	numeric	Shooting metric for d fgm in the requested NBA or WNBA Stats split.
d_fga	numeric	Shooting metric for d fga in the requested NBA or WNBA Stats split.
d_fg_pct	numeric	Percentage or rate for d field goals percentage in the requested NBA or WNBA Stats split.
normal_fg_pct	numeric	Percentage or rate for normal field goals percentage in the requested NBA or WNBA Stats split.
pct_plusminus	numeric	Percentage share of plusminus for the requested NBA or WNBA Stats split.

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

Example

nba_stats_leaguedashptdefend(league_id='00')

Last validated n/a.

nba_stats_leaguedashptstats

GET /stats/leaguedashptstats

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

Valid URL: https://stats.nba.com/stats/leaguedashptstats?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
College	college_nullable			Y	College query parameter.
Conference	conference_nullable			Y	Conference query parameter.
Country	country_nullable			Y	Country query parameter.
DateFrom	date_from_nullable			Y	DateFrom query parameter.
DateTo	date_to_nullable			Y	DateTo query parameter.
Division	division_simple_nullable			Y	Division query parameter.
DraftPick	draft_pick_nullable			Y	DraftPick query parameter.
DraftYear	draft_year_nullable			Y	DraftYear query parameter.
GameScope	game_scope_simple_nullable			Y	GameScope query parameter.
Height	height_nullable			Y	Height query parameter.
LastNGames	last_n_games			Y	LastNGames query parameter.
LeagueID	league_id			Y	LeagueID query parameter.
Location	location_nullable			Y	Location query parameter.
Month	month			Y	Month query parameter.
OpponentTeamID	opponent_team_id			Y	OpponentTeamID query parameter.
Outcome	outcome_nullable			Y	Outcome query parameter.
PORound	po_round_nullable			Y	PORound query parameter.
PerMode	per_mode_simple			Y	PerMode query parameter.
PlayerExperience	player_experience_nullable			Y	PlayerExperience query parameter.
PlayerOrTeam	player_or_team			Y	PlayerOrTeam query parameter.
PlayerPosition	player_position_abbreviation_nullable			Y	PlayerPosition query parameter.
PtMeasureType	pt_measure_type			Y	PtMeasureType query parameter.
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y	SeasonSegment query parameter.
SeasonType	season_type_all_star			Y	SeasonType query parameter.
StarterBench	starter_bench_nullable			Y	StarterBench query parameter.
TeamID	team_id_nullable			Y	TeamID query parameter.
VsConference	vs_conference_nullable			Y	VsConference query parameter.
VsDivision	vs_division_nullable			Y	VsDivision query parameter.
Weight	weight_nullable			Y	Weight query parameter.

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.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
min	numeric	Minutes played.
dist_feet	numeric	NBA or WNBA Stats value for dist feet in the leaguedashptstats result set.
dist_miles	numeric	NBA or WNBA Stats value for dist miles in the leaguedashptstats result set.
dist_miles_off	numeric	NBA or WNBA Stats value for dist miles offensive in the leaguedashptstats result set.
dist_miles_def	numeric	NBA or WNBA Stats value for dist miles defensive in the leaguedashptstats result set.
avg_speed	numeric	NBA or WNBA Stats value for average speed in the leaguedashptstats result set.
avg_speed_off	numeric	NBA or WNBA Stats value for average speed offensive in the leaguedashptstats result set.
avg_speed_def	numeric	NBA or WNBA Stats value for average speed defensive in the leaguedashptstats result set.

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

Example

nba_stats_leaguedashptstats(league_id='00')

Last validated n/a.

nba_stats_leaguedashptteamdefend

GET /stats/leaguedashptteamdefend

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

Valid URL: https://stats.nba.com/stats/leaguedashptteamdefend?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
DefenseCategory	defense_category			Y
Division	division_nullable			Y
GameSegment	game_segment_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple			Y
Period	period_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
gp	integer	Games played.
g	integer	Games played.
freq	numeric	NBA or WNBA Stats value for freq in the leaguedashptteamdefend result set.
d_fgm	numeric	Shooting metric for d fgm in the requested NBA or WNBA Stats split.
d_fga	numeric	Shooting metric for d fga in the requested NBA or WNBA Stats split.
d_fg_pct	numeric	Percentage or rate for d field goals percentage in the requested NBA or WNBA Stats split.
normal_fg_pct	numeric	Percentage or rate for normal field goals percentage in the requested NBA or WNBA Stats split.
pct_plusminus	numeric	Percentage share of plusminus for the requested NBA or WNBA Stats split.

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

Example

nba_stats_leaguedashptteamdefend(league_id='00')

Last validated n/a.

nba_stats_leaguedashteamclutch

GET /stats/leaguedashteamclutch

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

Valid URL: https://stats.nba.com/stats/leaguedashteamclutch?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
AheadBehind	ahead_behind			Y
ClutchTime	clutch_time			Y
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
GameScope	game_scope_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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
PlusMinus	plus_minus			Y
PointDiff	point_diff			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
StarterBench	starter_bench_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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer

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

Example

nba_stats_leaguedashteamclutch(league_id='00')

Last validated n/a.

nba_stats_leaguedashteamptshot

GET /stats/leaguedashteamptshot

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

Valid URL: https://stats.nba.com/stats/leaguedashteamptshot?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
CloseDefDistRange	close_def_dist_range_nullable			Y
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_nullable			Y
DribbleRange	dribble_range_nullable			Y
GameSegment	game_segment_nullable			Y
GeneralRange	general_range_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PerMode	per_mode_simple			Y
Period	period_nullable			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
ShotDistRange	shot_dist_range_nullable			Y
TeamID	team_id_nullable			Y
TouchTimeRange	touch_time_range_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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
gp	integer	Games played.
g	integer	Games played.
fga_frequency	numeric	Shooting metric for fga frequency in the requested NBA or WNBA Stats split.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
efg_pct	numeric	Percentage or rate for efg percentage in the requested NBA or WNBA Stats split.
fg2a_frequency	numeric	Shooting metric for fg2a frequency in the requested NBA or WNBA Stats split.
fg2m	numeric	Shooting metric for fg2m in the requested NBA or WNBA Stats split.
fg2a	numeric	Shooting metric for fg2a in the requested NBA or WNBA Stats split.
fg2_pct	numeric	Percentage or rate for two-point field goals percentage in the requested NBA or WNBA Stats split.
fg3a_frequency	numeric	Shooting metric for fg3a frequency in the requested NBA or WNBA Stats split.
fg3m	numeric	Three-point field goals made.
fg3a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).

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

Example

nba_stats_leaguedashteamptshot(league_id='00')

Last validated n/a.

nba_stats_leaguedashteamshotlocations

GET /stats/leaguedashteamshotlocations

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

Valid URL: https://stats.nba.com/stats/leaguedashteamshotlocations?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
DistanceRange	distance_range			Y
Division	division_simple_nullable			Y
GameScope	game_scope_simple_nullable			Y
GameSegment	game_segment_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_simple			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
StarterBench	starter_bench_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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
less_than_5_ft_fgm	numeric
less_than_5_ft_fga	numeric
less_than_5_ft_fg_pct	numeric
5-9_ft_fgm	numeric
5-9_ft_fga	numeric
5-9_ft_fg_pct	numeric
10-14_ft_fgm	numeric
10-14_ft_fga	numeric
10-14_ft_fg_pct	numeric
15-19_ft_fgm	numeric
15-19_ft_fga	numeric
15-19_ft_fg_pct	numeric
20-24_ft_fgm	numeric
20-24_ft_fga	numeric
20-24_ft_fg_pct	numeric
25-29_ft_fgm	numeric
25-29_ft_fga	numeric
25-29_ft_fg_pct	numeric
30-34_ft_fgm	numeric
30-34_ft_fga	numeric
30-34_ft_fg_pct	numeric
35-39_ft_fgm	numeric
35-39_ft_fga	numeric
35-39_ft_fg_pct	numeric
40+_ft_fgm	numeric
40+_ft_fga	numeric
40+_ft_fg_pct	numeric

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

Example

nba_stats_leaguedashteamshotlocations(league_id='00')

Last validated n/a.

nba_stats_leaguedashteamstats

GET /stats/leaguedashteamstats

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

Valid URL: https://stats.nba.com/stats/leaguedashteamstats?LeagueID=00

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
GameScope	game_scope_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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerExperience	player_experience_nullable			Y
PlayerPosition	player_position_abbreviation_nullable			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
TwoWay	two_way_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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.

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

Example

nba_stats_leaguedashteamstats(league_id='00')

Last validated n/a.

nba_stats_leaguegamefinder

GET /stats/leaguegamefinder

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

Valid URL: https://stats.nba.com/stats/leaguegamefinder?LeagueID=00

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
DraftNumber	draft_number_nullable			Y
DraftRound	draft_round_nullable			Y
DraftTeamID	draft_team_id_nullable			Y
DraftYear	draft_year_nullable			Y
EqAST	eq_ast_nullable			Y
EqBLK	eq_blk_nullable			Y
EqDD	eq_dd_nullable			Y
EqDREB	eq_dreb_nullable			Y
EqFG3A	eq_fg3a_nullable			Y
EqFG3M	eq_fg3m_nullable			Y
EqFG3_PCT	eq_fg3_pct_nullable			Y
EqFGA	eq_fga_nullable			Y
EqFGM	eq_fgm_nullable			Y
EqFG_PCT	eq_fg_pct_nullable			Y
EqFTA	eq_fta_nullable			Y
EqFTM	eq_ftm_nullable			Y
EqFT_PCT	eq_ft_pct_nullable			Y
EqMINUTES	eq_minutes_nullable			Y
EqOREB	eq_oreb_nullable			Y
EqPF	eq_pf_nullable			Y
EqPTS	eq_pts_nullable			Y
EqREB	eq_reb_nullable			Y
EqSTL	eq_stl_nullable			Y
EqTD	eq_td_nullable			Y
EqTOV	eq_tov_nullable			Y
GameID	game_id_nullable			Y
GtAST	gt_ast_nullable			Y
GtBLK	gt_blk_nullable			Y
GtDD	gt_dd_nullable			Y
GtDREB	gt_dreb_nullable			Y
GtFG3A	gt_fg3a_nullable			Y
GtFG3M	gt_fg3m_nullable			Y
GtFG3_PCT	gt_fg3_pct_nullable			Y
GtFGA	gt_fga_nullable			Y
GtFGM	gt_fgm_nullable			Y
GtFG_PCT	gt_fg_pct_nullable			Y
GtFTA	gt_fta_nullable			Y
GtFTM	gt_ftm_nullable			Y
GtFT_PCT	gt_ft_pct_nullable			Y
GtMINUTES	gt_minutes_nullable			Y
GtOREB	gt_oreb_nullable			Y
GtPF	gt_pf_nullable			Y
GtPTS	gt_pts_nullable			Y
GtREB	gt_reb_nullable			Y
GtSTL	gt_stl_nullable			Y
GtTD	gt_td_nullable			Y
GtTOV	gt_tov_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
LtAST	lt_ast_nullable			Y
LtBLK	lt_blk_nullable			Y
LtDD	lt_dd_nullable			Y
LtDREB	lt_dreb_nullable			Y
LtFG3A	lt_fg3a_nullable			Y
LtFG3M	lt_fg3m_nullable			Y
LtFG3_PCT	lt_fg3_pct_nullable			Y
LtFGA	lt_fga_nullable			Y
LtFGM	lt_fgm_nullable			Y
LtFG_PCT	lt_fg_pct_nullable			Y
LtFTA	lt_fta_nullable			Y
LtFTM	lt_ftm_nullable			Y
LtFT_PCT	lt_ft_pct_nullable			Y
LtMINUTES	lt_minutes_nullable			Y
LtOREB	lt_oreb_nullable			Y
LtPF	lt_pf_nullable			Y
LtPTS	lt_pts_nullable			Y
LtREB	lt_reb_nullable			Y
LtSTL	lt_stl_nullable			Y
LtTD	lt_td_nullable			Y
LtTOV	lt_tov_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PlayerID	player_id_nullable			Y
PlayerOrTeam	player_or_team_abbreviation			Y
RookieYear	rookie_year_nullable			Y
Season	season_nullable			Y
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsTeamID	vs_team_id_nullable			Y
YearsExperience	years_experience_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_id	character	Unique season identifier.
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	integer	Minutes played.
pts	integer	Points scored.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	integer	Three-point field goals made.
fg3a	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.
plus_minus	numeric	Plus/minus point differential while on court.

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

Example

nba_stats_leaguegamefinder(league_id='00')

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?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
Counter	counter			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Direction	direction			Y
LeagueID	league_id			Y
PlayerOrTeam	player_or_team_abbreviation			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_all_star			Y
Sorter	sorter			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_id	character	Unique season identifier.
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	integer	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	integer	Three-point field goals made.
fg3a	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_leaguegamelog(league_id='00')

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?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
ActiveFlag	active_flag_nullable			Y
LeagueID	league_id			Y
PerMode	per_mode48			Y
Scope	scope			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_all_star			Y
StatCategory	stat_category_abbreviation			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
player_id	integer	Unique player identifier.
rank	integer	Rank.
player	character	Player name.
team_id	integer	Unique team identifier.
team	character	Team-side label or team identifier.
gp	integer	Games played.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	numeric	Three-point field goals made.
fg3a	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.
pts	numeric	Points scored.
eff	numeric	Eff.
nickname	character	Team or athlete nickname.

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

Example

nba_stats_leagueleaders(league_id='00')

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?LeagueID=00

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
GroupQuantity	group_quantity			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed_defense			Y
MinutesMin	minutes_min			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
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
group_id	character	ESPN group id.
group_name	character	Group name (conference / division).
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
min	numeric	Minutes played.
off_rating	numeric
def_rating	numeric
net_rating	numeric	Net rating (off rating - def rating).
pace	numeric	Possessions per 48 minutes.
ts_pct	numeric	True shooting percentage (0-1).
fta_rate	numeric
tm_ast_pct	numeric
pct_fga_2pt	numeric
pct_fga_3pt	numeric
pct_pts_2pt_mr	numeric
pct_pts_fb	numeric
pct_pts_ft	numeric
pct_pts_paint	numeric
pct_ast_fgm	numeric
pct_uast_fgm	numeric
opp_fg3_pct	numeric
opp_efg_pct	numeric
opp_fta_rate	numeric
opp_tov_pct	numeric
sum_tm_min	numeric

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

Example

nba_stats_leaguelineupviz(league_id='00')

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?LeagueID=00

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			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
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
group_set	character	Name of the grouping family used for this dashboard or split row.
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').
vs_player_id	integer	Stats API identifier for vs player identifier associated with this NBA or WNBA Stats row.
vs_player_name	character	Display name for vs player name associated with this NBA or WNBA Stats row.
court_status	character	Indicates whether the compared player was on court or off court for the split row.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.

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

Example

nba_stats_leagueplayerondetails(league_id='00')

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?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DefPlayerID	def_player_id_nullable			Y
DefTeamID	def_team_id_nullable			Y
LeagueID	league_id			Y
OffPlayerID	off_player_id_nullable			Y
OffTeamID	off_team_id_nullable			Y
PerMode	per_mode_simple			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_playoffs			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_id	character	Unique season identifier.
off_player_id	integer	Stats API identifier for offensive player identifier associated with this NBA or WNBA Stats row.
off_player_name	character	Display name for offensive player name associated with this NBA or WNBA Stats row.
def_player_id	integer	Stats API identifier for defensive player identifier associated with this NBA or WNBA Stats row.
def_player_name	character	Display name for defensive player name associated with this NBA or WNBA Stats row.
gp	integer	Games played.
matchup_min	numeric	NBA or WNBA Stats value for matchup minutes in the leagueseasonmatchups result set.
partial_poss	numeric	Estimated partial possessions credited to the stint or rotation interval.
player_pts	numeric	Scoring or score-margin metric for player points in the requested NBA or WNBA Stats split.
team_pts	numeric	Scoring or score-margin metric for team points in the requested NBA or WNBA Stats split.
matchup_ast	numeric	NBA or WNBA Stats value for matchup assists in the leagueseasonmatchups result set.
matchup_tov	numeric	Turnover or loose-ball metric for matchup turnovers in the requested NBA or WNBA Stats split.
matchup_blk	numeric	NBA or WNBA Stats value for matchup blocks in the leagueseasonmatchups result set.
matchup_fgm	numeric	Shooting metric for matchup fgm in the requested NBA or WNBA Stats split.
matchup_fga	numeric	Shooting metric for matchup fga in the requested NBA or WNBA Stats split.
matchup_fg_pct	numeric	Percentage or rate for matchup field goals percentage in the requested NBA or WNBA Stats split.
matchup_fg3m	numeric	Shooting metric for matchup fg3m in the requested NBA or WNBA Stats split.
matchup_fg3a	numeric	Shooting metric for matchup fg3a in the requested NBA or WNBA Stats split.
matchup_fg3_pct	numeric	Percentage or rate for matchup three-point field goals percentage in the requested NBA or WNBA Stats split.
help_blk	integer	NBA or WNBA Stats value for help blocks in the leagueseasonmatchups result set.
help_fgm	integer	Shooting metric for help fgm in the requested NBA or WNBA Stats split.
help_fga	integer	Shooting metric for help fga in the requested NBA or WNBA Stats split.
help_fg_perc	integer	Shooting metric for help field goals perc in the requested NBA or WNBA Stats split.
matchup_ftm	numeric	NBA or WNBA Stats value for matchup ftm in the leagueseasonmatchups result set.
matchup_fta	numeric	NBA or WNBA Stats value for matchup fta in the leagueseasonmatchups result set.
sfl	numeric	NBA 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')

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

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
SeasonYear	season_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
leagueid	character	League identifier used in compact NBA Stats schedule and scoreboard result sets.
seasonid	character	Stats API identifier for seasonid associated with this NBA or WNBA Stats row.
teamid	integer	Teamid.
teamcity	character	Teamcity.
teamname	character	Teamname.
conference	character	Conference name.
conferencerecord	character	NBA or WNBA Stats value for conferencerecord in the leaguestandings result set.
playoffrank	integer	NBA or WNBA Stats value for playoffrank in the leaguestandings result set.
clinchindicator	character	NBA or WNBA Stats value for clinchindicator in the leaguestandings result set.
division	character	Team division.
divisionrecord	character	NBA or WNBA Stats value for divisionrecord in the leaguestandings result set.
divisionrank	integer	NBA or WNBA Stats value for divisionrank in the leaguestandings result set.
wins	integer	Total wins.
losses	integer	Total losses.
winpct	numeric	Winning percentage for the team or split represented by this row.
leaguerank	integer	NBA or WNBA Stats value for leaguerank in the leaguestandings result set.
record	character	Overall win-loss record.
home	character	Home.
road	character	Road.
l10	character	Last-ten record.
last10home	character	NBA or WNBA Stats value for last10home in the leaguestandings result set.
last10road	character	NBA or WNBA Stats value for last10road in the leaguestandings result set.
ot	character	Ot.
threeptsorless	character	Scoring or score-margin metric for threeptsorless in the requested NBA or WNBA Stats split.
tenptsormore	character	Scoring or score-margin metric for tenptsormore in the requested NBA or WNBA Stats split.
longhomestreak	integer	NBA or WNBA Stats value for longhomestreak in the leaguestandings result set.
strlonghomestreak	character	NBA or WNBA Stats value for strlonghomestreak in the leaguestandings result set.
longroadstreak	integer	NBA or WNBA Stats value for longroadstreak in the leaguestandings result set.
strlongroadstreak	character	NBA or WNBA Stats value for strlongroadstreak in the leaguestandings result set.
longwinstreak	integer	NBA or WNBA Stats value for longwinstreak in the leaguestandings result set.
longlossstreak	integer	NBA or WNBA Stats value for longlossstreak in the leaguestandings result set.
currenthomestreak	integer	NBA or WNBA Stats value for currenthomestreak in the leaguestandings result set.
strcurrenthomestreak	character	NBA or WNBA Stats value for strcurrenthomestreak in the leaguestandings result set.
currentroadstreak	integer	NBA or WNBA Stats value for currentroadstreak in the leaguestandings result set.
strcurrentroadstreak	character	NBA or WNBA Stats value for strcurrentroadstreak in the leaguestandings result set.
currentstreak	integer	NBA or WNBA Stats value for currentstreak in the leaguestandings result set.
strcurrentstreak	character	Strcurrentstreak.
conferencegamesback	numeric	NBA or WNBA Stats value for conferencegamesback in the leaguestandings result set.
divisiongamesback	numeric	NBA or WNBA Stats value for divisiongamesback in the leaguestandings result set.
clinchedconferencetitle	integer	Flag indicating clinchedconferencetitle for the requested NBA or WNBA Stats context.
clincheddivisiontitle	integer	Flag indicating clincheddivisiontitle for the requested NBA or WNBA Stats context.
clinchedplayoffbirth	integer	Flag indicating clinchedplayoffbirth for the requested NBA or WNBA Stats context.
eliminatedconference	integer	Flag indicating eliminatedconference for the requested NBA or WNBA Stats context.
eliminateddivision	integer	Flag indicating eliminateddivision for the requested NBA or WNBA Stats context.
aheadathalf	character	NBA or WNBA Stats value for aheadathalf in the leaguestandings result set.
behindathalf	character	NBA or WNBA Stats value for behindathalf in the leaguestandings result set.
tiedathalf	character	NBA or WNBA Stats value for tiedathalf in the leaguestandings result set.
aheadatthird	character	NBA or WNBA Stats value for aheadatthird in the leaguestandings result set.
behindatthird	character	NBA or WNBA Stats value for behindatthird in the leaguestandings result set.
tiedatthird	character	NBA or WNBA Stats value for tiedatthird in the leaguestandings result set.
score100pts	character	Scoring or score-margin metric for score100pts in the requested NBA or WNBA Stats split.
oppscore100pts	character	Scoring or score-margin metric for oppscore100pts in the requested NBA or WNBA Stats split.
oppover500	character	NBA or WNBA Stats value for oppover500 in the leaguestandings result set.
leadinfgpct	character	Shooting metric for leadinfgpct in the requested NBA or WNBA Stats split.
leadinreb	character	Rebounding metric for leadinreb in the requested NBA or WNBA Stats split.
fewerturnovers	character	Turnover or loose-ball metric for fewerturnovers in the requested NBA or WNBA Stats split.
pointspg	numeric	Scoring or score-margin metric for pointspg in the requested NBA or WNBA Stats split.
opppointspg	numeric	Scoring or score-margin metric for opppointspg in the requested NBA or WNBA Stats split.
diffpointspg	numeric	Scoring or score-margin metric for diffpointspg in the requested NBA or WNBA Stats split.
vseast	character	NBA or WNBA Stats value for vseast in the leaguestandings result set.
vsatlantic	character	NBA or WNBA Stats value for vsatlantic in the leaguestandings result set.
vscentral	character	NBA or WNBA Stats value for vscentral in the leaguestandings result set.
vssoutheast	character	NBA or WNBA Stats value for vssoutheast in the leaguestandings result set.
vswest	character	NBA or WNBA Stats value for vswest in the leaguestandings result set.
vsnorthwest	character	NBA or WNBA Stats value for vsnorthwest in the leaguestandings result set.
vspacific	character	NBA or WNBA Stats value for vspacific in the leaguestandings result set.
vssouthwest	character	NBA or WNBA Stats value for vssouthwest in the leaguestandings result set.
jan	character	Value for January in the endpoint's monthly NBA or WNBA Stats split.
feb	character	Value for February in the endpoint's monthly NBA or WNBA Stats split.
mar	character	Value for March in the endpoint's monthly NBA or WNBA Stats split.
apr	character	Value for April in the endpoint's monthly NBA or WNBA Stats split.
may	character	Value for May in the endpoint's monthly NBA or WNBA Stats split.
jun	character	Value for June in the endpoint's monthly NBA or WNBA Stats split.
jul	character	Value for July in the endpoint's monthly NBA or WNBA Stats split.
aug	character	Value for August in the endpoint's monthly NBA or WNBA Stats split.
sep	character	Value for September in the endpoint's monthly NBA or WNBA Stats split.
oct	character	Value for October in the endpoint's monthly NBA or WNBA Stats split.
nov	character	Value for November in the endpoint's monthly NBA or WNBA Stats split.
dec	character	Value for December in the endpoint's monthly NBA or WNBA Stats split.
preas	character	NBA or WNBA Stats value for preas in the leaguestandings result set.
postas	character	NBA 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')

Last validated n/a.

nba_stats_leaguestandingsv3

GET /stats/leaguestandingsv3

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

Valid URL: https://stats.nba.com/stats/leaguestandingsv3?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
SeasonYear	season_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
leagueid	character	League identifier used in compact NBA Stats schedule and scoreboard result sets.
seasonid	character	Stats API identifier for seasonid associated with this NBA or WNBA Stats row.
teamid	integer	Teamid.
teamcity	character	Teamcity.
teamname	character	Teamname.
teamslug	character	URL slug for teamslug used by NBA or WNBA Stats pages.
conference	character	Conference name.
conferencerecord	character	NBA or WNBA Stats value for conferencerecord in the leaguestandingsv3 result set.
playoffrank	integer	NBA or WNBA Stats value for playoffrank in the leaguestandingsv3 result set.
clinchindicator	character	NBA or WNBA Stats value for clinchindicator in the leaguestandingsv3 result set.
division	character	Team division.
divisionrecord	character	NBA or WNBA Stats value for divisionrecord in the leaguestandingsv3 result set.
divisionrank	integer	NBA or WNBA Stats value for divisionrank in the leaguestandingsv3 result set.
wins	integer	Total wins.
losses	integer	Total losses.
winpct	numeric	Winning percentage for the team or split represented by this row.
leaguerank	integer	NBA or WNBA Stats value for leaguerank in the leaguestandingsv3 result set.
record	character	Overall win-loss record.
home	character	Home.
road	character	Road.
l10	character	Last-ten record.
last10home	character	NBA or WNBA Stats value for last10home in the leaguestandingsv3 result set.
last10road	character	NBA or WNBA Stats value for last10road in the leaguestandingsv3 result set.
ot	character	Ot.
threeptsorless	character	Scoring or score-margin metric for threeptsorless in the requested NBA or WNBA Stats split.
tenptsormore	character	Scoring or score-margin metric for tenptsormore in the requested NBA or WNBA Stats split.
longhomestreak	integer	NBA or WNBA Stats value for longhomestreak in the leaguestandingsv3 result set.
strlonghomestreak	character	NBA or WNBA Stats value for strlonghomestreak in the leaguestandingsv3 result set.
longroadstreak	integer	NBA or WNBA Stats value for longroadstreak in the leaguestandingsv3 result set.
strlongroadstreak	character	NBA or WNBA Stats value for strlongroadstreak in the leaguestandingsv3 result set.
longwinstreak	integer	NBA or WNBA Stats value for longwinstreak in the leaguestandingsv3 result set.
longlossstreak	integer	NBA or WNBA Stats value for longlossstreak in the leaguestandingsv3 result set.
currenthomestreak	integer	NBA or WNBA Stats value for currenthomestreak in the leaguestandingsv3 result set.
strcurrenthomestreak	character	NBA or WNBA Stats value for strcurrenthomestreak in the leaguestandingsv3 result set.
currentroadstreak	integer	NBA or WNBA Stats value for currentroadstreak in the leaguestandingsv3 result set.
strcurrentroadstreak	character	NBA or WNBA Stats value for strcurrentroadstreak in the leaguestandingsv3 result set.
currentstreak	integer	NBA or WNBA Stats value for currentstreak in the leaguestandingsv3 result set.
strcurrentstreak	character	Strcurrentstreak.
conferencegamesback	numeric	NBA or WNBA Stats value for conferencegamesback in the leaguestandingsv3 result set.
divisiongamesback	numeric	NBA or WNBA Stats value for divisiongamesback in the leaguestandingsv3 result set.
clinchedconferencetitle	integer	Flag indicating clinchedconferencetitle for the requested NBA or WNBA Stats context.
clincheddivisiontitle	integer	Flag indicating clincheddivisiontitle for the requested NBA or WNBA Stats context.
clinchedplayoffbirth	integer	Flag indicating clinchedplayoffbirth for the requested NBA or WNBA Stats context.
clinchedplayin	integer	Flag indicating clinchedplayin for the requested NBA or WNBA Stats context.
eliminatedconference	integer	Flag indicating eliminatedconference for the requested NBA or WNBA Stats context.
eliminateddivision	integer	Flag indicating eliminateddivision for the requested NBA or WNBA Stats context.
aheadathalf	character	NBA or WNBA Stats value for aheadathalf in the leaguestandingsv3 result set.
behindathalf	character	NBA or WNBA Stats value for behindathalf in the leaguestandingsv3 result set.
tiedathalf	character	NBA or WNBA Stats value for tiedathalf in the leaguestandingsv3 result set.
aheadatthird	character	NBA or WNBA Stats value for aheadatthird in the leaguestandingsv3 result set.
behindatthird	character	NBA or WNBA Stats value for behindatthird in the leaguestandingsv3 result set.
tiedatthird	character	NBA or WNBA Stats value for tiedatthird in the leaguestandingsv3 result set.
score100pts	character	Scoring or score-margin metric for score100pts in the requested NBA or WNBA Stats split.
oppscore100pts	character	Scoring or score-margin metric for oppscore100pts in the requested NBA or WNBA Stats split.
oppover500	character	NBA or WNBA Stats value for oppover500 in the leaguestandingsv3 result set.
leadinfgpct	character	Shooting metric for leadinfgpct in the requested NBA or WNBA Stats split.
leadinreb	character	Rebounding metric for leadinreb in the requested NBA or WNBA Stats split.
fewerturnovers	character	Turnover or loose-ball metric for fewerturnovers in the requested NBA or WNBA Stats split.
pointspg	numeric	Scoring or score-margin metric for pointspg in the requested NBA or WNBA Stats split.
opppointspg	numeric	Scoring or score-margin metric for opppointspg in the requested NBA or WNBA Stats split.
diffpointspg	numeric	Scoring or score-margin metric for diffpointspg in the requested NBA or WNBA Stats split.
vseast	character	NBA or WNBA Stats value for vseast in the leaguestandingsv3 result set.
vsatlantic	character	NBA or WNBA Stats value for vsatlantic in the leaguestandingsv3 result set.
vscentral	character	NBA or WNBA Stats value for vscentral in the leaguestandingsv3 result set.
vssoutheast	character	NBA or WNBA Stats value for vssoutheast in the leaguestandingsv3 result set.
vswest	character	NBA or WNBA Stats value for vswest in the leaguestandingsv3 result set.
vsnorthwest	character	NBA or WNBA Stats value for vsnorthwest in the leaguestandingsv3 result set.
vspacific	character	NBA or WNBA Stats value for vspacific in the leaguestandingsv3 result set.
vssouthwest	character	NBA or WNBA Stats value for vssouthwest in the leaguestandingsv3 result set.
jan	character	Value for January in the endpoint's monthly NBA or WNBA Stats split.
feb	character	Value for February in the endpoint's monthly NBA or WNBA Stats split.
mar	character	Value for March in the endpoint's monthly NBA or WNBA Stats split.
apr	character	Value for April in the endpoint's monthly NBA or WNBA Stats split.
may	character	Value for May in the endpoint's monthly NBA or WNBA Stats split.
jun	character	Value for June in the endpoint's monthly NBA or WNBA Stats split.
jul	character	Value for July in the endpoint's monthly NBA or WNBA Stats split.
aug	character	Value for August in the endpoint's monthly NBA or WNBA Stats split.
sep	character	Value for September in the endpoint's monthly NBA or WNBA Stats split.
oct	character	Value for October in the endpoint's monthly NBA or WNBA Stats split.
nov	character	Value for November in the endpoint's monthly NBA or WNBA Stats split.
dec	character	Value for December in the endpoint's monthly NBA or WNBA Stats split.
score_80_plus	character	Scoring or score-margin metric for score 80 plus in the requested NBA or WNBA Stats split.
opp_score_80_plus	character	Opponent score 80 plus for the requested NBA or WNBA team, player, lineup, or game split.
score_below_80	character	Scoring or score-margin metric for score below 80 in the requested NBA or WNBA Stats split.
opp_score_below_80	character	Opponent score below 80 for the requested NBA or WNBA team, player, lineup, or game split.
totalpoints	integer	Scoring or score-margin metric for totalpoints in the requested NBA or WNBA Stats split.
opptotalpoints	integer	Scoring or score-margin metric for opptotalpoints in the requested NBA or WNBA Stats split.
difftotalpoints	integer	Scoring or score-margin metric for difftotalpoints in the requested NBA or WNBA Stats split.
leaguegamesback	numeric	NBA or WNBA Stats value for leaguegamesback in the leaguestandingsv3 result set.
playoffseeding	integer	NBA or WNBA Stats value for playoffseeding in the leaguestandingsv3 result set.
clinchedpostseason	integer	Flag indicating clinchedpostseason for the requested NBA or WNBA Stats context.
neutral	character	Neutral.

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

Example

nba_stats_leaguestandingsv3(league_id='00')

Last validated n/a.

nba_stats_matchupsrollup

GET /stats/matchupsrollup

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

Valid URL: https://stats.nba.com/stats/matchupsrollup?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DefPlayerID	def_player_id_nullable			Y
DefTeamID	def_team_id_nullable			Y
LeagueID	league_id			Y
OffPlayerID	off_player_id_nullable			Y
OffTeamID	off_team_id_nullable			Y
PerMode	per_mode_simple			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_playoffs			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_id	character	Unique season identifier.
position	character	Listed roster position (G, F, C, etc.).
percent_of_time	numeric	Time value for percent of time in the NBA or WNBA Stats result set.
def_player_id	integer	Stats API identifier for defensive player identifier associated with this NBA or WNBA Stats row.
def_player_name	character	Display name for defensive player name associated with this NBA or WNBA Stats row.
gp	integer	Games played.
matchup_min	numeric	NBA or WNBA Stats value for matchup minutes in the matchupsrollup result set.
partial_poss	numeric	Estimated partial possessions credited to the stint or rotation interval.
player_pts	numeric	Scoring or score-margin metric for player points in the requested NBA or WNBA Stats split.
team_pts	numeric	Scoring or score-margin metric for team points in the requested NBA or WNBA Stats split.
matchup_ast	numeric	NBA or WNBA Stats value for matchup assists in the matchupsrollup result set.
matchup_tov	numeric	Turnover or loose-ball metric for matchup turnovers in the requested NBA or WNBA Stats split.
matchup_blk	numeric	NBA or WNBA Stats value for matchup blocks in the matchupsrollup result set.
matchup_fgm	numeric	Shooting metric for matchup fgm in the requested NBA or WNBA Stats split.
matchup_fga	numeric	Shooting metric for matchup fga in the requested NBA or WNBA Stats split.
matchup_fg_pct	numeric	Percentage or rate for matchup field goals percentage in the requested NBA or WNBA Stats split.
matchup_fg3m	numeric	Shooting metric for matchup fg3m in the requested NBA or WNBA Stats split.
matchup_fg3a	numeric	Shooting metric for matchup fg3a in the requested NBA or WNBA Stats split.
matchup_fg3_pct	numeric	Percentage or rate for matchup three-point field goals percentage in the requested NBA or WNBA Stats split.
matchup_ftm	numeric	NBA or WNBA Stats value for matchup ftm in the matchupsrollup result set.
matchup_fta	numeric	NBA or WNBA Stats value for matchup fta in the matchupsrollup result set.
sfl	numeric	NBA or WNBA Stats value for sfl in the matchupsrollup result set.

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

Example

nba_stats_matchupsrollup(league_id='00')

Last validated n/a.

nba_stats_playbyplayv3

GET /stats/playbyplayv3

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

Valid URL: https://stats.nba.com/stats/playbyplayv3

API Parameter	Python	Pattern	Required	Nullable	Description
EndPeriod	end_period			Y
GameID	game_id			Y
StartPeriod	start_period			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
actionid	integer	NBA or WNBA Stats action identifier for the play event.
actionnumber	integer	Sequential action number for the play within the game feed.
actiontype	character	Normalized play action type reported by NBA or WNBA Stats.
clock	character	Game clock value.
description	character	Long-form description text.
gameid	character	Unique NBA or WNBA Stats game identifier for the play event.
isfieldgoal	integer	Flag indicating whether the play event is a field-goal attempt.
location	character	Location.
period	integer	Period of the game (1-4 quarters; 5+ for OT).
personid	integer	NBA or WNBA Stats player identifier associated with the play, when present.
playername	character	Full display name for the player associated with the play event.
playernamei	character	Abbreviated player display name used by the play feed.
pointstotal	integer	Running points total credited to the player after the play, when reported.
scoreaway	character	Away team's score after the play, when reported by the feed.
scorehome	character	Home team's score after the play, when reported by the feed.
shotdistance	integer	Shot distance in feet for shot attempts, when available.
shotresult	character	Result of the shot attempt, such as made or missed.
shotvalue	integer	Point value of the shot attempt, usually two or three points.
subtype	character	Secondary play subtype reported by NBA or WNBA Stats.
teamid	integer	Teamid.
teamtricode	character	Three-letter code for the team associated with the play event.
videoavailable	integer	Flag indicating whether video is available for the play or game row.
xlegacy	integer	Legacy NBA Stats x-coordinate for shot-location play events.
ylegacy	integer	Legacy NBA Stats y-coordinate for shot-location play events.

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

Example

nba_stats_playbyplayv3()

Last validated n/a.

nba_stats_playerawards

GET /stats/playerawards

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

Valid URL: https://stats.nba.com/stats/playerawards

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_playercareerstats

GET /stats/playercareerstats

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

Valid URL: https://stats.nba.com/stats/playercareerstats?LeagueID=00

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 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.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.

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?LeagueID=00

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
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 tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_name	type	description
group_set	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
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_playerdashboardbyclutch

GET /stats/playerdashboardbyclutch

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

Valid URL: https://stats.nba.com/stats/playerdashboardbyclutch?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerID	player_id			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
ShotClockRange	shot_clock_range_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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
team_count	integer	NBA or WNBA Stats value for team count in the playerdashboardbyclutch result set.

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

Example

nba_stats_playerdashboardbyclutch(league_id='00')

Last validated n/a.

nba_stats_playerdashboardbygamesplits

GET /stats/playerdashboardbygamesplits

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

Valid URL: https://stats.nba.com/stats/playerdashboardbygamesplits?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerID	player_id			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
ShotClockRange	shot_clock_range_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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
team_count	integer	NBA or WNBA Stats value for team count in the playerdashboardbygamesplits result set.

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

Example

nba_stats_playerdashboardbygamesplits(league_id='00')

Last validated n/a.

nba_stats_playerdashboardbygeneralsplits

GET /stats/playerdashboardbygeneralsplits

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

Valid URL: https://stats.nba.com/stats/playerdashboardbygeneralsplits?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerID	player_id			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
ShotClockRange	shot_clock_range_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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
team_count	integer	NBA or WNBA Stats value for team count in the playerdashboardbygeneralsplits result set.

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

Example

nba_stats_playerdashboardbygeneralsplits(league_id='00')

Last validated n/a.

nba_stats_playerdashboardbylastngames

GET /stats/playerdashboardbylastngames

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

Valid URL: https://stats.nba.com/stats/playerdashboardbylastngames?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerID	player_id			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
ShotClockRange	shot_clock_range_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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
team_count	integer	NBA or WNBA Stats value for team count in the playerdashboardbylastngames result set.

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

Example

nba_stats_playerdashboardbylastngames(league_id='00')

Last validated n/a.

nba_stats_playerdashboardbyopponent

GET /stats/playerdashboardbyopponent

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

Valid URL: https://stats.nba.com/stats/playerdashboardbyopponent?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from			Y
DateTo	date_to			Y
GameSegment	game_segment			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location			Y
MeasureType	measure_type			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome			Y
PORound	po_round			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
Period	period			Y
PlayerID	player_id			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
ShotClockRange	shot_clock_range			Y
VsConference	vs_conference			Y
VsDivision	vs_division			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
group_set	character
group_value	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
nba_fantasy_pts	numeric
dd2	integer
td3	integer
wnba_fantasy_pts	numeric
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer
nba_fantasy_pts_rank	integer
dd2_rank	integer
td3_rank	integer
wnba_fantasy_pts_rank	integer
team_count	integer

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

Example

nba_stats_playerdashboardbyopponent(league_id='00')

Last validated n/a.

nba_stats_playerdashboardbyshootingsplits

GET /stats/playerdashboardbyshootingsplits

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

Valid URL: https://stats.nba.com/stats/playerdashboardbyshootingsplits?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerID	player_id			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
ShotClockRange	shot_clock_range_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
group_set	character	Name of the grouping family used for this dashboard or split row.
player_id	integer	Unique player identifier.
player_name	character	Player name.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	integer	Three-point field goals made.
fg3a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
efg_pct	numeric	Percentage or rate for efg percentage in the requested NBA or WNBA Stats split.
blka	integer	Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pct_ast_2pm	numeric	Percentage share of assists 2pm for the requested NBA or WNBA Stats split.
pct_uast_2pm	numeric	Percentage share of uast 2pm for the requested NBA or WNBA Stats split.
pct_ast_3pm	numeric	Percentage share of assists 3pm for the requested NBA or WNBA Stats split.
pct_uast_3pm	numeric	Percentage share of uast 3pm for the requested NBA or WNBA Stats split.
pct_ast_fgm	numeric	Percentage share of assists fgm for the requested NBA or WNBA Stats split.
pct_uast_fgm	numeric	Percentage share of uast fgm for the requested NBA or WNBA Stats split.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
efg_pct_rank	integer	Rank for effective field-goal percentage 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.
pct_ast_2pm_rank	integer	Rank for percentage assists 2pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_uast_2pm_rank	integer	Rank for percentage uast 2pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_ast_3pm_rank	integer	Rank for percentage assists 3pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_uast_3pm_rank	integer	Rank for percentage uast 3pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_ast_fgm_rank	integer	Rank for percentage assists fgm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_uast_fgm_rank	integer	Rank for percentage uast fgm 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_playerdashboardbyshootingsplits(league_id='00')

Last validated n/a.

nba_stats_playerdashboardbyteamperformance

GET /stats/playerdashboardbyteamperformance

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

Valid URL: https://stats.nba.com/stats/playerdashboardbyteamperformance?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerID	player_id			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
ShotClockRange	shot_clock_range_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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value_order	integer	Sort order assigned to the grouping value in NBA or WNBA Stats dashboards.
group_value	character	Specific grouping value for this dashboard or split row.
group_value_2	character	Secondary grouping value for dashboards that return paired split dimensions.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
team_count	integer	NBA or WNBA Stats value for team count in the playerdashboardbyteamperformance result set.

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

Example

nba_stats_playerdashboardbyteamperformance(league_id='00')

Last validated n/a.

nba_stats_playerdashboardbyyearoveryear

GET /stats/playerdashboardbyyearoveryear

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

Valid URL: https://stats.nba.com/stats/playerdashboardbyyearoveryear?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlayerID	player_id			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
ShotClockRange	shot_clock_range_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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
max_game_date	character	Date or timestamp for maximum game date in the NBA or WNBA Stats result set.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
team_count	integer	NBA or WNBA Stats value for team count in the playerdashboardbyyearoveryear result set.

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

Example

nba_stats_playerdashboardbyyearoveryear(league_id='00')

Last validated n/a.

nba_stats_playerdashptpass

GET /stats/playerdashptpass

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

Valid URL: https://stats.nba.com/stats/playerdashptpass?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PerMode	per_mode_simple			Y
PlayerID	player_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
player_id	integer	Unique player identifier.
player_name_last_first	character	Player display name formatted as Last, First for sorting in NBA or WNBA Stats tables.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
pass_type	character	Passing or assist metric for pass type in the requested NBA or WNBA Stats split.
g	integer	Games played.
pass_from	character	Passing or assist metric for pass from in the requested NBA or WNBA Stats split.
pass_teammate_player_id	integer	Stats API identifier for pass teammate player identifier associated with this NBA or WNBA Stats row.
frequency	numeric	NBA or WNBA Stats value for frequency in the playerdashptpass result set.
pass	numeric	Binary indicator if the play was a pass play (sacks and scrambles included).
ast	numeric	Assists.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg2m	numeric	Shooting metric for fg2m in the requested NBA or WNBA Stats split.
fg2a	numeric	Shooting metric for fg2a in the requested NBA or WNBA Stats split.
fg2_pct	numeric	Percentage or rate for two-point field goals percentage in the requested NBA or WNBA Stats split.
fg3m	numeric	Three-point field goals made.
fg3a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).

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

Example

nba_stats_playerdashptpass(league_id='00')

Last validated n/a.

nba_stats_playerdashptreb

GET /stats/playerdashptreb

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

Valid URL: https://stats.nba.com/stats/playerdashptreb?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PerMode	per_mode_simple			Y
Period	period			Y
PlayerID	player_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
player_id	integer	Unique player identifier.
player_name_last_first	character	Player display name formatted as Last, First for sorting in NBA or WNBA Stats tables.
sort_order	integer	Display sort order for the sport.
g	integer	Games played.
shot_type_range	character	Shooting metric for shot type range in the requested NBA or WNBA Stats split.
reb_frequency	numeric	Rebounding metric for rebounds frequency in the requested NBA or WNBA Stats split.
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
c_oreb	numeric	Rebounding metric for c offensive rebounds in the requested NBA or WNBA Stats split.
c_dreb	numeric	Rebounding metric for c defensive rebounds in the requested NBA or WNBA Stats split.
c_reb	numeric	Rebounding metric for c rebounds in the requested NBA or WNBA Stats split.
c_reb_pct	numeric	Percentage or rate for c rebounds percentage in the requested NBA or WNBA Stats split.
uc_oreb	numeric	Rebounding metric for uc offensive rebounds in the requested NBA or WNBA Stats split.
uc_dreb	numeric	Rebounding metric for uc defensive rebounds in the requested NBA or WNBA Stats split.
uc_reb	numeric	Rebounding metric for uc rebounds in the requested NBA or WNBA Stats split.
uc_reb_pct	numeric	Percentage or rate for uc rebounds percentage in the requested NBA or WNBA Stats split.

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

Example

nba_stats_playerdashptreb(league_id='00')

Last validated n/a.

nba_stats_playerdashptshotdefend

GET /stats/playerdashptshotdefend

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

Valid URL: https://stats.nba.com/stats/playerdashptshotdefend?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PerMode	per_mode_simple			Y
Period	period			Y
PlayerID	player_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
matchupid	integer	Stats API identifier for matchupid associated with this NBA or WNBA Stats row.
gp	integer	Games played.
g	integer	Games played.
defense_category	character	NBA or WNBA Stats value for defense category in the playerdashptshotdefend result set.
freq	numeric	NBA or WNBA Stats value for freq in the playerdashptshotdefend result set.
d_fgm	numeric	Shooting metric for d fgm in the requested NBA or WNBA Stats split.
d_fga	numeric	Shooting metric for d fga in the requested NBA or WNBA Stats split.
d_fg_pct	numeric	Percentage or rate for d field goals percentage in the requested NBA or WNBA Stats split.
normal_fg_pct	numeric	Percentage or rate for normal field goals percentage in the requested NBA or WNBA Stats split.
pct_plusminus	numeric	Percentage share of plusminus for the requested NBA or WNBA Stats split.

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

Example

nba_stats_playerdashptshotdefend(league_id='00')

Last validated n/a.

nba_stats_playerdashptshots

GET /stats/playerdashptshots

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

Valid URL: https://stats.nba.com/stats/playerdashptshots?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PerMode	per_mode_simple			Y
Period	period			Y
PlayerID	player_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
player_id	integer	Unique player identifier.
player_name_last_first	character	Player display name formatted as Last, First for sorting in NBA or WNBA Stats tables.
sort_order	integer	Display sort order for the sport.
gp	integer	Games played.
g	integer	Games played.
touch_time_range	character	Time value for touch time range in the NBA or WNBA Stats result set.
fga_frequency	numeric	Shooting metric for fga frequency in the requested NBA or WNBA Stats split.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
efg_pct	numeric	Percentage or rate for efg percentage in the requested NBA or WNBA Stats split.
fg2a_frequency	numeric	Shooting metric for fg2a frequency in the requested NBA or WNBA Stats split.
fg2m	numeric	Shooting metric for fg2m in the requested NBA or WNBA Stats split.
fg2a	numeric	Shooting metric for fg2a in the requested NBA or WNBA Stats split.
fg2_pct	numeric	Percentage or rate for two-point field goals percentage in the requested NBA or WNBA Stats split.
fg3a_frequency	numeric	Shooting metric for fg3a frequency in the requested NBA or WNBA Stats split.
fg3m	numeric	Three-point field goals made.
fg3a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).

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

Example

nba_stats_playerdashptshots(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

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.

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')

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

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 year (e.g. 2024).
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.

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
group_set	character
group_value	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
dd2	integer
td3	integer
fan_duel_pts	numeric
nba_fantasy_pts	numeric

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

Example

nba_stats_playerfantasyprofile(league_id='00')

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

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PlayerID	player_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_all_star_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
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.
fg3m	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')

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?LeagueID=00

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 year (e.g. 2024).
SeasonType	season_type_all_star			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_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).
fg3m	integer	Three-point field goals made.
fg3a	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')

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?LeagueID=00

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
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_nullable			Y
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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')

Last validated n/a.

nba_stats_playergamestreakfinder

GET /stats/playergamestreakfinder

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

Valid URL: https://stats.nba.com/stats/playergamestreakfinder?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
ActiveStreaksOnly	active_streaks_only_nullable			Y
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
DraftNumber	draft_number_nullable			Y
DraftRound	draft_round_nullable			Y
DraftTeamID	draft_team_id_nullable			Y
DraftYear	draft_year_nullable			Y
EqAST	eq_ast_nullable			Y
EqBLK	eq_blk_nullable			Y
EqDD	eq_dd_nullable			Y
EqDREB	eq_dreb_nullable			Y
EqFG3A	eq_fg3a_nullable			Y
EqFG3M	eq_fg3m_nullable			Y
EqFG3_PCT	eq_fg3_pct_nullable			Y
EqFGA	eq_fga_nullable			Y
EqFGM	eq_fgm_nullable			Y
EqFG_PCT	eq_fg_pct_nullable			Y
EqFTA	eq_fta_nullable			Y
EqFTM	eq_ftm_nullable			Y
EqFT_PCT	eq_ft_pct_nullable			Y
EqMINUTES	eq_minutes_nullable			Y
EqOREB	eq_oreb_nullable			Y
EqPF	eq_pf_nullable			Y
EqPTS	eq_pts_nullable			Y
EqREB	eq_reb_nullable			Y
EqSTL	eq_stl_nullable			Y
EqTD	eq_td_nullable			Y
EqTOV	eq_tov_nullable			Y
GameID	game_id_nullable			Y
GtAST	gt_ast_nullable			Y
GtBLK	gt_blk_nullable			Y
GtDD	gt_dd_nullable			Y
GtDREB	gt_dreb_nullable			Y
GtFG3A	gt_fg3a_nullable			Y
GtFG3M	gt_fg3m_nullable			Y
GtFG3_PCT	gt_fg3_pct_nullable			Y
GtFGA	gt_fga_nullable			Y
GtFGM	gt_fgm_nullable			Y
GtFG_PCT	gt_fg_pct_nullable			Y
GtFTA	gt_fta_nullable			Y
GtFTM	gt_ftm_nullable			Y
GtFT_PCT	gt_ft_pct_nullable			Y
GtMINUTES	gt_minutes_nullable			Y
GtOREB	gt_oreb_nullable			Y
GtPF	gt_pf_nullable			Y
GtPTS	gt_pts_nullable			Y
GtREB	gt_reb_nullable			Y
GtSTL	gt_stl_nullable			Y
GtTD	gt_td_nullable			Y
GtTOV	gt_tov_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
LtAST	lt_ast_nullable			Y
LtBLK	lt_blk_nullable			Y
LtDD	lt_dd_nullable			Y
LtDREB	lt_dreb_nullable			Y
LtFG3A	lt_fg3a_nullable			Y
LtFG3M	lt_fg3m_nullable			Y
LtFG3_PCT	lt_fg3_pct_nullable			Y
LtFGA	lt_fga_nullable			Y
LtFGM	lt_fgm_nullable			Y
LtFG_PCT	lt_fg_pct_nullable			Y
LtFTA	lt_fta_nullable			Y
LtFTM	lt_ftm_nullable			Y
LtFT_PCT	lt_ft_pct_nullable			Y
LtMINUTES	lt_minutes_nullable			Y
LtOREB	lt_oreb_nullable			Y
LtPF	lt_pf_nullable			Y
LtPTS	lt_pts_nullable			Y
LtREB	lt_reb_nullable			Y
LtSTL	lt_stl_nullable			Y
LtTD	lt_td_nullable			Y
LtTOV	lt_tov_nullable			Y
MinGames	min_games_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PlayerID	player_id_nullable			Y
RookieYear	rookie_year_nullable			Y
Season	season_nullable			Y
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_nullable			Y
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsTeamID	vs_team_id_nullable			Y
YearsExperience	years_experience_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
player_name_last_first	character	Player display name formatted as Last, First for sorting in NBA or WNBA Stats tables.
player_id	integer	Unique player identifier.
gamestreak	integer	NBA or WNBA Stats value for gamestreak in the playergamestreakfinder result set.
startdate	character	Date or timestamp for startdate in the NBA or WNBA Stats result set.
enddate	character	Date or timestamp for enddate in the NBA or WNBA Stats result set.
activestreak	integer	NBA or WNBA Stats value for activestreak in the playergamestreakfinder result set.
numseasons	integer	NBA or WNBA Stats value for numseasons in the playergamestreakfinder result set.
lastseason	character	NBA or WNBA Stats value for lastseason in the playergamestreakfinder result set.
firstseason	character	NBA or WNBA Stats value for firstseason in the playergamestreakfinder result set.

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

Example

nba_stats_playergamestreakfinder(league_id='00')

Last validated n/a.

nba_stats_playerindex

GET /stats/playerindex

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

Valid URL: https://stats.nba.com/stats/playerindex?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
Active	active_nullable			Y
AllStar	allstar_nullable			Y
College	college_nullable			Y
Country	country_nullable			Y
DraftPick	draft_pick_nullable			Y
DraftRound	draft_round_nullable			Y
DraftYear	draft_year_nullable			Y
Height	height_nullable			Y
Historical	historical_nullable			Y
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
TeamID	team_id_nullable			Y
Weight	weight_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
person_id	integer	Unique player identifier (V3 endpoints).
player_last_name	character	Participant last name.
player_first_name	character	Participant first name.
player_slug	character	URL-safe player identifier.
team_id	integer	Unique team identifier.
team_slug	character	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
is_defunct	integer	Flag indicating is defunct for the requested NBA or WNBA Stats context.
team_city	character	Team city or region (e.g. 'Las Vegas').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
jersey_number	character	Jersey number.
position	character	Listed roster position (G, F, C, etc.).
height	character	Player height (string e.g. '6-2' or inches).
weight	character	Player weight in pounds.
college	character	College.
country	character	Venue country.
draft_year	integer	Draft year (4-digit).
draft_round	integer	Round of the draft selection.
draft_number	integer	The number pick that was used to select a given player.
roster_status	numeric	Payroll table the row came from: Active, IL, or Retained Salary.
from_year	character	First season.
to_year	character	Most recent season.
pts	numeric	Points scored.
reb	numeric	Rebounds per game.
ast	numeric	Assists.
stats_timeframe	character	Time value for stats timeframe in the NBA or WNBA Stats result set.

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

Example

nba_stats_playerindex(league_id='00')

Last validated n/a.

nba_stats_playerprofilev2

GET /stats/playerprofilev2

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

Valid URL: https://stats.nba.com/stats/playerprofilev2?LeagueID=00

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 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.
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 playerprofilev2 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).
fg3m	numeric	Three-point field goals made.
fg3a	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.

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

Example

nba_stats_playerprofilev2(league_id='00')

Last validated n/a.

nba_stats_playervsplayer

GET /stats/playervsplayer

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

Valid URL: https://stats.nba.com/stats/playervsplayer?LeagueID=00

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			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
PlayerID	player_id			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
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsPlayerID	vs_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
group_set	character
player_id	integer	Unique player identifier.
player_name	character	Player name.
vs_player_id	integer
vs_player_name	character
court_status	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
nba_fantasy_pts	numeric

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

Example

nba_stats_playervsplayer(league_id='00')

Last validated n/a.

nba_stats_playoffpicture

GET /stats/playoffpicture

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

Valid URL: https://stats.nba.com/stats/playoffpicture?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
SeasonID	season_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
conference	character	Conference name.
rank	integer	Rank.
team	character	Team-side label or team identifier.
team_slug	character	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_id	integer	Unique team identifier.
wins	integer	Total wins.
losses	integer	Total losses.
pct	numeric	Win percentage.
div	character
conf	character	character.
home	character	Home.
away	character	Away record.
gb	numeric	Games behind the conference leader.
gr_over_500	integer
gr_over_500_home	integer
gr_over_500_away	integer
gr_under_500	integer
gr_under_500_home	integer
gr_under_500_away	integer
ranking_criteria	integer
clinched_playoffs	integer
clinched_conference	integer
clinched_division	integer
eliminated_playoffs	integer
sosa_remaining	character

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

Example

nba_stats_playoffpicture(league_id='00')

Last validated n/a.

nba_stats_scheduleleaguev2

GET /stats/scheduleleaguev2

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

Valid URL: https://stats.nba.com/stats/scheduleleaguev2?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).

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
arenacity	character	Schedule metadata for arenacity in the NBA or WNBA Stats schedule feed.
arenaname	character	Display name for arenaname associated with this NBA or WNBA Stats row.
arenastate	character	Schedule metadata for arenastate in the NBA or WNBA Stats schedule feed.
awayteamtime	character	Time value for awayteamtime in the NBA or WNBA Stats result set.
awayteam_losses	integer	Losses for the away team in this NBA or WNBA Stats row.
awayteam_score	integer	Score for the away team in this NBA or WNBA Stats row.
awayteam_seed	integer	Seed for the away team in this NBA or WNBA Stats row.
awayteam_teamcity	character	Teamcity for the away team in this NBA or WNBA Stats row.
awayteam_teamid	integer	Teamid for the away team in this NBA or WNBA Stats row.
awayteam_teamname	character	Teamname for the away team in this NBA or WNBA Stats row.
awayteam_teamslug	character	Teamslug for the away team in this NBA or WNBA Stats row.
awayteam_teamtricode	character	Teamtricode for the away team in this NBA or WNBA Stats row.
awayteam_wins	integer	Wins for the away team in this NBA or WNBA Stats row.
branchlink	character	NBA or WNBA Stats value for branchlink in the scheduleleaguev2 result set.
day	character	Day number within the month.
gamecode	character	Gamecode.
gamedate	character	Game date as parsed from the source feed.
gamedateest	character	Date or timestamp for gamedateest in the NBA or WNBA Stats result set.
gamedatetimeest	character	Date or timestamp for gamedatetimeest in the NBA or WNBA Stats result set.
gamedatetimeutc	character	Date or timestamp for gamedatetimeutc in the NBA or WNBA Stats result set.
gamedateutc	character	Date or timestamp for gamedateutc in the NBA or WNBA Stats result set.
gameid	character	Unique stats.nba.com game identifier in endpoints that use compact schedule field names.
gamelabel	character	Schedule metadata for gamelabel in the NBA or WNBA Stats schedule feed.
gamesequence	integer	Schedule metadata for gamesequence in the NBA or WNBA Stats schedule feed.
gamestatus	integer	Schedule metadata for gamestatus in the NBA or WNBA Stats schedule feed.
gamestatustext	character	Schedule metadata for gamestatustext in the NBA or WNBA Stats schedule feed.
gamesublabel	character	Schedule metadata for gamesublabel in the NBA or WNBA Stats schedule feed.
gamesubtype	character	Schedule metadata for gamesubtype in the NBA or WNBA Stats schedule feed.
gametimeest	character	Time value for gametimeest in the NBA or WNBA Stats result set.
gametimeutc	character	Time value for gametimeutc in the NBA or WNBA Stats result set.
hometeamtime	character	Time value for hometeamtime in the NBA or WNBA Stats result set.
hometeam_losses	integer	Losses for the home team in this NBA or WNBA Stats row.
hometeam_score	integer	Score for the home team in this NBA or WNBA Stats row.
hometeam_seed	integer	Seed for the home team in this NBA or WNBA Stats row.
hometeam_teamcity	character	Teamcity for the home team in this NBA or WNBA Stats row.
hometeam_teamid	integer	Teamid for the home team in this NBA or WNBA Stats row.
hometeam_teamname	character	Teamname for the home team in this NBA or WNBA Stats row.
hometeam_teamslug	character	Teamslug for the home team in this NBA or WNBA Stats row.
hometeam_teamtricode	character	Teamtricode for the home team in this NBA or WNBA Stats row.
hometeam_wins	integer	Wins for the home team in this NBA or WNBA Stats row.
ifnecessary	character	NBA or WNBA Stats value for ifnecessary in the scheduleleaguev2 result set.
isneutral	logical	Flag indicating isneutral for the requested NBA or WNBA Stats context.
monthnum	integer	NBA or WNBA Stats value for monthnum in the scheduleleaguev2 result set.
postponedstatus	character	NBA or WNBA Stats value for postponedstatus in the scheduleleaguev2 result set.
seriesgamenumber	character	Schedule metadata for seriesgamenumber in the NBA or WNBA Stats schedule feed.
seriestext	character	NBA or WNBA Stats value for seriestext in the scheduleleaguev2 result set.
weekname	character	Display name for weekname associated with this NBA or WNBA Stats row.
weeknumber	integer	Schedule metadata for weeknumber in the NBA or WNBA Stats schedule feed.

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

Example

nba_stats_scheduleleaguev2(league_id='00')

Last validated n/a.

nba_stats_scheduleleaguev2int

GET /stats/scheduleleaguev2int

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

Valid URL: https://stats.nba.com/stats/scheduleleaguev2int?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).

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
arenacity	character	Schedule metadata for arenacity in the NBA or WNBA Stats schedule feed.
arenaname	character	Display name for arenaname associated with this NBA or WNBA Stats row.
arenastate	character	Schedule metadata for arenastate in the NBA or WNBA Stats schedule feed.
awayteamtime	character	Time value for awayteamtime in the NBA or WNBA Stats result set.
awayteam_losses	integer	Losses for the away team in this NBA or WNBA Stats row.
awayteam_score	integer	Score for the away team in this NBA or WNBA Stats row.
awayteam_seed	integer	Seed for the away team in this NBA or WNBA Stats row.
awayteam_teamcity	character	Teamcity for the away team in this NBA or WNBA Stats row.
awayteam_teamid	integer	Teamid for the away team in this NBA or WNBA Stats row.
awayteam_teamname	character	Teamname for the away team in this NBA or WNBA Stats row.
awayteam_teamslug	character	Teamslug for the away team in this NBA or WNBA Stats row.
awayteam_teamtricode	character	Teamtricode for the away team in this NBA or WNBA Stats row.
awayteam_wins	integer	Wins for the away team in this NBA or WNBA Stats row.
branchlink	character	NBA or WNBA Stats value for branchlink in the scheduleleaguev2 result set.
day	character	Day number within the month.
gamecode	character	Gamecode.
gamedate	character	Game date as parsed from the source feed.
gamedateest	character	Date or timestamp for gamedateest in the NBA or WNBA Stats result set.
gamedatetimeest	character	Date or timestamp for gamedatetimeest in the NBA or WNBA Stats result set.
gamedatetimeutc	character	Date or timestamp for gamedatetimeutc in the NBA or WNBA Stats result set.
gamedateutc	character	Date or timestamp for gamedateutc in the NBA or WNBA Stats result set.
gameid	character	Unique stats.nba.com game identifier in endpoints that use compact schedule field names.
gamelabel	character	Schedule metadata for gamelabel in the NBA or WNBA Stats schedule feed.
gamesequence	integer	Schedule metadata for gamesequence in the NBA or WNBA Stats schedule feed.
gamestatus	integer	Schedule metadata for gamestatus in the NBA or WNBA Stats schedule feed.
gamestatustext	character	Schedule metadata for gamestatustext in the NBA or WNBA Stats schedule feed.
gamesublabel	character	Schedule metadata for gamesublabel in the NBA or WNBA Stats schedule feed.
gamesubtype	character	Schedule metadata for gamesubtype in the NBA or WNBA Stats schedule feed.
gametimeest	character	Time value for gametimeest in the NBA or WNBA Stats result set.
gametimeutc	character	Time value for gametimeutc in the NBA or WNBA Stats result set.
hometeamtime	character	Time value for hometeamtime in the NBA or WNBA Stats result set.
hometeam_losses	integer	Losses for the home team in this NBA or WNBA Stats row.
hometeam_score	integer	Score for the home team in this NBA or WNBA Stats row.
hometeam_seed	integer	Seed for the home team in this NBA or WNBA Stats row.
hometeam_teamcity	character	Teamcity for the home team in this NBA or WNBA Stats row.
hometeam_teamid	integer	Teamid for the home team in this NBA or WNBA Stats row.
hometeam_teamname	character	Teamname for the home team in this NBA or WNBA Stats row.
hometeam_teamslug	character	Teamslug for the home team in this NBA or WNBA Stats row.
hometeam_teamtricode	character	Teamtricode for the home team in this NBA or WNBA Stats row.
hometeam_wins	integer	Wins for the home team in this NBA or WNBA Stats row.
ifnecessary	character	NBA or WNBA Stats value for ifnecessary in the scheduleleaguev2 result set.
isneutral	logical	Flag indicating isneutral for the requested NBA or WNBA Stats context.
monthnum	integer	NBA or WNBA Stats value for monthnum in the scheduleleaguev2 result set.
postponedstatus	character	NBA or WNBA Stats value for postponedstatus in the scheduleleaguev2 result set.
seriesgamenumber	character	Schedule metadata for seriesgamenumber in the NBA or WNBA Stats schedule feed.
seriestext	character	NBA or WNBA Stats value for seriestext in the scheduleleaguev2 result set.
weekname	character	Display name for weekname associated with this NBA or WNBA Stats row.
weeknumber	integer	Schedule metadata for weeknumber in the NBA or WNBA Stats schedule feed.

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

Example

nba_stats_scheduleleaguev2int(league_id='00')

Last validated n/a.

nba_stats_scoreboardv3

GET /stats/scoreboardv3

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

Valid URL: https://stats.nba.com/stats/scoreboardv3?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
GameDate	game_date			Y
LeagueID	league_id			Y

Returns

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

col_name	type	description
awayteam_inbonus	character
awayteam_losses	integer
awayteam_score	integer
awayteam_seed	integer
awayteam_teamcity	character
awayteam_teamid	integer
awayteam_teamname	character
awayteam_teamslug	character
awayteam_teamtricode	character
awayteam_timeoutsremaining	integer
awayteam_wins	integer
gameclock	character
gamecode	character	Gamecode.
gamedate	character	Game date as parsed from the source feed.
gameet	character
gameid	character
gamelabel	character
gameleaders_awayleaders_assists	integer
gameleaders_awayleaders_jerseynum	character
gameleaders_awayleaders_name	character
gameleaders_awayleaders_personid	integer
gameleaders_awayleaders_playerslug	character
gameleaders_awayleaders_points	integer
gameleaders_awayleaders_position	character
gameleaders_awayleaders_rebounds	integer
gameleaders_awayleaders_teamtricode	character
gameleaders_homeleaders_assists	integer
gameleaders_homeleaders_jerseynum	character
gameleaders_homeleaders_name	character
gameleaders_homeleaders_personid	integer
gameleaders_homeleaders_playerslug	character
gameleaders_homeleaders_points	integer
gameleaders_homeleaders_position	character
gameleaders_homeleaders_rebounds	integer
gameleaders_homeleaders_teamtricode	character
gamestatus	integer
gamestatustext	character
gamesublabel	character
gamesubtype	character
gametimeutc	character
hometeam_inbonus	character
hometeam_losses	integer
hometeam_score	integer
hometeam_seed	integer
hometeam_teamcity	character
hometeam_teamid	integer
hometeam_teamname	character
hometeam_teamslug	character
hometeam_teamtricode	character
hometeam_timeoutsremaining	integer
hometeam_wins	integer
ifnecessary	logical
isneutral	logical
leagueid	character
leaguename	character
period	integer	Period of the game (1-4 quarters; 5+ for OT).
porounddesc	character
regulationperiods	integer
seriesconference	character
seriesgamenumber	character
seriestext	character
teamleaders_awayleaders_assists	numeric
teamleaders_awayleaders_jerseynum	character
teamleaders_awayleaders_name	character
teamleaders_awayleaders_personid	integer
teamleaders_awayleaders_playerslug	character
teamleaders_awayleaders_points	numeric
teamleaders_awayleaders_position	character
teamleaders_awayleaders_rebounds	numeric
teamleaders_awayleaders_teamtricode	character
teamleaders_homeleaders_assists	numeric
teamleaders_homeleaders_jerseynum	character
teamleaders_homeleaders_name	character
teamleaders_homeleaders_personid	integer
teamleaders_homeleaders_playerslug	character
teamleaders_homeleaders_points	numeric
teamleaders_homeleaders_position	character
teamleaders_homeleaders_rebounds	numeric
teamleaders_homeleaders_teamtricode	character
teamleaders_seasonleadersflag	integer

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

Example

nba_stats_scoreboardv3(league_id='00')

Last validated n/a.

nba_stats_shotchartdetail

GET /stats/shotchartdetail

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

Valid URL: https://stats.nba.com/stats/shotchartdetail?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
AheadBehind	ahead_behind_nullable			Y
ClutchTime	clutch_time_nullable			Y
ContextFilter	context_filter_nullable			Y
ContextMeasure	context_measure_simple			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
EndPeriod	end_period_nullable			Y
EndRange	end_range_nullable			Y
GameID	game_id_nullable			Y
GameSegment	game_segment_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
Period	period			Y
PlayerID	player_id			Y
PlayerPosition	player_position_nullable			Y
PointDiff	point_diff_nullable			Y
Position	position_nullable			Y
RangeType	range_type_nullable			Y
RookieYear	rookie_year_nullable			Y
Season	season_nullable			Y
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
StartPeriod	start_period_nullable			Y
StartRange	start_range_nullable			Y
TeamID	team_id			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
grid_type	character
game_id	character	Unique game identifier.
game_event_id	character	Unique identifier for game event.
player_id	character	Unique player identifier.
player_name	character	Player name.
team_id	character	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
period	character	Period of the game (1-4 quarters; 5+ for OT).
minutes_remaining	character	Minutes remaining.
seconds_remaining	character	Seconds remaining in the period.
event_type	character	Event / play type code (V2 PBP).
action_type	character	Action type label (e.g. 'Made Shot', 'Substitution').
shot_type	character	Type of shot taken (e.g. wrist, snap, backhand).
shot_zone_basic	character	Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
shot_zone_area	character	Shot zone area ('Left Side', 'Right Side', 'Center').
shot_zone_range	character	Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
shot_distance	character	Shot distance from the basket, in feet.
loc_x	character	X coordinate on the court (units of inches; 0 = basket center).
loc_y	character	Y coordinate on the court (units of inches; baseline at 0).
shot_attempted_flag	character	1 if a shot was attempted on this event.
shot_made_flag	character	1 if the shot was made; 0 if missed.
game_date	character	Game date (YYYY-MM-DD).
htm	character
vtm	character

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

Example

nba_stats_shotchartdetail(league_id='00')

Last validated n/a.

nba_stats_shotchartleaguewide

GET /stats/shotchartleaguewide

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

Valid URL: https://stats.nba.com/stats/shotchartleaguewide?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).

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
grid_type	character	NBA or WNBA Stats value for grid type in the shotchartleaguewide result set.
shot_zone_basic	character	Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
shot_zone_area	character	Shot zone area ('Left Side', 'Right Side', 'Center').
shot_zone_range	character	Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
fga	integer	Field goal attempts.
fgm	integer	Field goals made.
fg_pct	numeric	Field goal percentage (0-1).

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

Example

nba_stats_shotchartleaguewide(league_id='00')

Last validated n/a.

nba_stats_shotchartlineupdetail

GET /stats/shotchartlineupdetail

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

Valid URL: https://stats.nba.com/stats/shotchartlineupdetail?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
ContextFilter	context_filter_nullable			Y
ContextMeasure	context_measure_detailed			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
GROUP_ID	group_id			Y
GameID	game_id_nullable			Y
GameSegment	game_segment_nullable			Y
LastNGames	last_n_games_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month_nullable			Y
OpponentTeamID	opponent_team_id_nullable			Y
Outcome	outcome_nullable			Y
Period	period			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			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
grid_type	character
game_id	character	Unique game identifier.
game_event_id	character	Unique identifier for game event.
group_id	character	ESPN group id.
group_name	character	Group name (conference / division).
player_id	character	Unique player identifier.
player_name	character	Player name.
team_id	character	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
period	character	Period of the game (1-4 quarters; 5+ for OT).
minutes_remaining	character	Minutes remaining.
seconds_remaining	character	Seconds remaining in the period.
event_type	character	Event / play type code (V2 PBP).
action_type	character	Action type label (e.g. 'Made Shot', 'Substitution').
shot_type	character	Type of shot taken (e.g. wrist, snap, backhand).
shot_zone_basic	character	Shot zone (e.g. 'Restricted Area', 'Mid-Range', 'Above the Break 3').
shot_zone_area	character	Shot zone area ('Left Side', 'Right Side', 'Center').
shot_zone_range	character	Shot zone range ('Less Than 8 ft.', '8-16 ft.', '16-24 ft.', etc.).
shot_distance	character	Shot distance from the basket, in feet.
loc_x	character	X coordinate on the court (units of inches; 0 = basket center).
loc_y	character	Y coordinate on the court (units of inches; baseline at 0).
shot_attempted_flag	character	1 if a shot was attempted on this event.
shot_made_flag	character	1 if the shot was made; 0 if missed.
game_date	character	Game date (YYYY-MM-DD).
htm	character
vtm	character

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

Example

nba_stats_shotchartlineupdetail(league_id='00')

Last validated n/a.

nba_stats_synergyplaytypes

GET /stats/synergyplaytypes

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

Valid URL: https://stats.nba.com/stats/synergyplaytypes?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode_simple			Y
PlayType	play_type_nullable			Y
PlayerOrTeam	player_or_team_abbreviation			Y
SeasonType	season_type_all_star			Y
SeasonYear	season			Y	Season year (e.g. 2024).
TypeGrouping	type_grouping_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_id	character	Unique season identifier.
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').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
play_type	character	Play type description.
type_grouping	character
percentile	numeric
gp	integer	Games played.
poss_pct	numeric	Poss percentage (0-1 decimal).
ppp	numeric
fg_pct	numeric	Field goal percentage (0-1).
ft_poss_pct	numeric
tov_poss_pct	numeric
sf_poss_pct	numeric
plusone_poss_pct	numeric
score_poss_pct	numeric
efg_pct	numeric
poss	numeric	Poss.
pts	numeric	Points scored.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fgmx	numeric

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

Example

nba_stats_synergyplaytypes(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbyclutch

GET /stats/teamdashboardbyclutch

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

Valid URL: https://stats.nba.com/stats/teamdashboardbyclutch?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from			Y
DateTo	date_to			Y
GameSegment	game_segment			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location			Y
MeasureType	measure_type			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome			Y
PORound	po_round			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
ShotClockRange	shot_clock_range			Y
TeamID	team_id			Y
VsConference	vs_conference			Y
VsDivision	vs_division			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
group_set	character
group_value	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer

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

Example

nba_stats_teamdashboardbyclutch(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbygamesplits

GET /stats/teamdashboardbygamesplits

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

Valid URL: https://stats.nba.com/stats/teamdashboardbygamesplits?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from			Y
DateTo	date_to			Y
GameSegment	game_segment			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location			Y
MeasureType	measure_type			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome			Y
PORound	po_round			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
ShotClockRange	shot_clock_range			Y
TeamID	team_id			Y
VsConference	vs_conference			Y
VsDivision	vs_division			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
group_set	character
group_value	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer

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

Example

nba_stats_teamdashboardbygamesplits(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbygeneralsplits

GET /stats/teamdashboardbygeneralsplits

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

Valid URL: https://stats.nba.com/stats/teamdashboardbygeneralsplits?LeagueID=00

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			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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
TeamID	team_id			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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
game_result	character	Game result for the player's team (W/L).
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.

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

Example

nba_stats_teamdashboardbygeneralsplits(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbylastngames

GET /stats/teamdashboardbylastngames

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

Valid URL: https://stats.nba.com/stats/teamdashboardbylastngames?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from			Y
DateTo	date_to			Y
GameSegment	game_segment			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location			Y
MeasureType	measure_type			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome			Y
PORound	po_round			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
ShotClockRange	shot_clock_range			Y
TeamID	team_id			Y
VsConference	vs_conference			Y
VsDivision	vs_division			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
group_set	character
group_value	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer

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

Example

nba_stats_teamdashboardbylastngames(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbyopponent

GET /stats/teamdashboardbyopponent

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

Valid URL: https://stats.nba.com/stats/teamdashboardbyopponent?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from			Y
DateTo	date_to			Y
GameSegment	game_segment			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location			Y
MeasureType	measure_type			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome			Y
PORound	po_round			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
ShotClockRange	shot_clock_range			Y
TeamID	team_id			Y
VsConference	vs_conference			Y
VsDivision	vs_division			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
group_set	character
group_value	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer

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

Example

nba_stats_teamdashboardbyopponent(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbyshootingsplits

GET /stats/teamdashboardbyshootingsplits

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

Valid URL: https://stats.nba.com/stats/teamdashboardbyshootingsplits?LeagueID=00

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			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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
TeamID	team_id			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
group_set	character	Name of the grouping family used for this dashboard or split row.
player_id	integer	Unique player identifier.
player_name	character	Player name.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	integer	Three-point field goals made.
fg3a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
efg_pct	numeric	Percentage or rate for efg percentage in the requested NBA or WNBA Stats split.
blka	integer	Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pct_ast_2pm	numeric	Percentage share of assists 2pm for the requested NBA or WNBA Stats split.
pct_uast_2pm	numeric	Percentage share of uast 2pm for the requested NBA or WNBA Stats split.
pct_ast_3pm	numeric	Percentage share of assists 3pm for the requested NBA or WNBA Stats split.
pct_uast_3pm	numeric	Percentage share of uast 3pm for the requested NBA or WNBA Stats split.
pct_ast_fgm	numeric	Percentage share of assists fgm for the requested NBA or WNBA Stats split.
pct_uast_fgm	numeric	Percentage share of uast fgm for the requested NBA or WNBA Stats split.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
efg_pct_rank	integer	Rank for effective field-goal percentage 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.
pct_ast_2pm_rank	integer	Rank for percentage assists 2pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_uast_2pm_rank	integer	Rank for percentage uast 2pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_ast_3pm_rank	integer	Rank for percentage assists 3pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_uast_3pm_rank	integer	Rank for percentage uast 3pm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_ast_fgm_rank	integer	Rank for percentage assists fgm within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pct_uast_fgm_rank	integer	Rank for percentage uast fgm 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_teamdashboardbyshootingsplits(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbyteamperformance

GET /stats/teamdashboardbyteamperformance

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

Valid URL: https://stats.nba.com/stats/teamdashboardbyteamperformance?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from			Y
DateTo	date_to			Y
GameSegment	game_segment			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location			Y
MeasureType	measure_type			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome			Y
PORound	po_round			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
ShotClockRange	shot_clock_range			Y
TeamID	team_id			Y
VsConference	vs_conference			Y
VsDivision	vs_division			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
group_set	character
group_value_order	integer
group_value	character
group_value_2	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer

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

Example

nba_stats_teamdashboardbyteamperformance(league_id='00')

Last validated n/a.

nba_stats_teamdashboardbyyearoveryear

GET /stats/teamdashboardbyyearoveryear

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

Valid URL: https://stats.nba.com/stats/teamdashboardbyyearoveryear?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from			Y
DateTo	date_to			Y
GameSegment	game_segment			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location			Y
MeasureType	measure_type			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome			Y
PORound	po_round			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment			Y
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
ShotClockRange	shot_clock_range			Y
TeamID	team_id			Y
VsConference	vs_conference			Y
VsDivision	vs_division			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
group_set	character
group_value	character
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer

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

Example

nba_stats_teamdashboardbyyearoveryear(league_id='00')

Last validated n/a.

nba_stats_teamdashlineups

GET /stats/teamdashlineups

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

Valid URL: https://stats.nba.com/stats/teamdashlineups?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
GameID	game_id_nullable			Y
GameSegment	game_segment_nullable			Y
GroupQuantity	group_quantity			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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
TeamID	team_id			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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
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').
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.

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

Example

nba_stats_teamdashlineups(league_id='00')

Last validated n/a.

nba_stats_teamdashptpass

GET /stats/teamdashptpass

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

Valid URL: https://stats.nba.com/stats/teamdashptpass?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PerMode	per_mode_simple			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
pass_type	character	Passing or assist metric for pass type in the requested NBA or WNBA Stats split.
g	integer	Games played.
pass_to	character	Passing or assist metric for pass to in the requested NBA or WNBA Stats split.
pass_teammate_player_id	integer	Stats API identifier for pass teammate player identifier associated with this NBA or WNBA Stats row.
frequency	numeric	NBA or WNBA Stats value for frequency in the teamdashptpass result set.
pass	numeric	Binary indicator if the play was a pass play (sacks and scrambles included).
ast	numeric	Assists.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg2m	numeric	Shooting metric for fg2m in the requested NBA or WNBA Stats split.
fg2a	numeric	Shooting metric for fg2a in the requested NBA or WNBA Stats split.
fg2_pct	numeric	Percentage or rate for two-point field goals percentage in the requested NBA or WNBA Stats split.
fg3m	numeric	Three-point field goals made.
fg3a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).

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

Example

nba_stats_teamdashptpass(league_id='00')

Last validated n/a.

nba_stats_teamdashptreb

GET /stats/teamdashptreb

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

Valid URL: https://stats.nba.com/stats/teamdashptreb?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PerMode	per_mode_simple			Y
Period	period			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
sort_order	integer	Display sort order for the sport.
g	integer	Games played.
shot_type_range	character	Shooting metric for shot type range in the requested NBA or WNBA Stats split.
reb_frequency	numeric	Rebounding metric for rebounds frequency in the requested NBA or WNBA Stats split.
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Rebounds per game.
c_oreb	numeric	Rebounding metric for c offensive rebounds in the requested NBA or WNBA Stats split.
c_dreb	numeric	Rebounding metric for c defensive rebounds in the requested NBA or WNBA Stats split.
c_reb	numeric	Rebounding metric for c rebounds in the requested NBA or WNBA Stats split.
c_reb_pct	numeric	Percentage or rate for c rebounds percentage in the requested NBA or WNBA Stats split.
uc_oreb	numeric	Rebounding metric for uc offensive rebounds in the requested NBA or WNBA Stats split.
uc_dreb	numeric	Rebounding metric for uc defensive rebounds in the requested NBA or WNBA Stats split.
uc_reb	numeric	Rebounding metric for uc rebounds in the requested NBA or WNBA Stats split.
uc_reb_pct	numeric	Percentage or rate for uc rebounds percentage in the requested NBA or WNBA Stats split.

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

Example

nba_stats_teamdashptreb(league_id='00')

Last validated n/a.

nba_stats_teamdashptshots

GET /stats/teamdashptshots

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

Valid URL: https://stats.nba.com/stats/teamdashptshots?LeagueID=00

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			Y
LeagueID	league_id			Y
Location	location_nullable			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PerMode	per_mode_simple			Y
Period	period			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
sort_order	integer	Display sort order for the sport.
g	integer	Games played.
touch_time_range	character	Time value for touch time range in the NBA or WNBA Stats result set.
fga_frequency	numeric	Shooting metric for fga frequency in the requested NBA or WNBA Stats split.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
efg_pct	numeric	Percentage or rate for efg percentage in the requested NBA or WNBA Stats split.
fg2a_frequency	numeric	Shooting metric for fg2a frequency in the requested NBA or WNBA Stats split.
fg2m	numeric	Shooting metric for fg2m in the requested NBA or WNBA Stats split.
fg2a	numeric	Shooting metric for fg2a in the requested NBA or WNBA Stats split.
fg2_pct	numeric	Percentage or rate for two-point field goals percentage in the requested NBA or WNBA Stats split.
fg3a_frequency	numeric	Shooting metric for fg3a frequency in the requested NBA or WNBA Stats split.
fg3m	numeric	Three-point field goals made.
fg3a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).

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

Example

nba_stats_teamdashptshots(league_id='00')

Last validated n/a.

nba_stats_teamdetails

GET /stats/teamdetails

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

Valid URL: https://stats.nba.com/stats/teamdetails

API Parameter	Python	Pattern	Required	Nullable	Description
TeamID	team_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
team_id	integer	Unique team identifier.
abbreviation	character	Short abbreviation.
nickname	character	Team or athlete nickname.
yearfounded	integer
city	character	Venue city.
arena	character	Arena.
arenacapacity	character
owner	character
generalmanager	character
headcoach	character
dleagueaffiliation	character

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

Example

nba_stats_teamdetails()

Last validated n/a.

nba_stats_teamestimatedmetrics

GET /stats/teamestimatedmetrics

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

Valid URL: https://stats.nba.com/stats/teamestimatedmetrics?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.

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
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_id	integer	Unique team identifier.
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_pace	numeric	Estimated pace 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_tm_tov_pct	numeric	Estimated team turnover percentage 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_tm_tov_pct_rank	integer	Rank for e team turnovers 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_teamestimatedmetrics(league_id='00')

Last validated n/a.

nba_stats_teamgamelog

GET /stats/teamgamelog

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

Valid URL: https://stats.nba.com/stats/teamgamelog?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
LeagueID	league_id			Y
Season	season			Y	Season year (e.g. 2024).
SeasonType	season_type_all_star			Y
TeamID	team_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
team_id	integer	Unique team identifier.
game_id	character	Unique game identifier.
game_date	character	Game date (YYYY-MM-DD).
matchup	character	Matchup.
wl	character	Wl.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	integer	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	integer	Three-point field goals made.
fg3a	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_teamgamelog(league_id='00')

Last validated n/a.

nba_stats_teamgamelogs

GET /stats/teamgamelogs

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

Valid URL: https://stats.nba.com/stats/teamgamelogs?LeagueID=00

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	opp_team_id_nullable			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
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_nullable			Y
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).
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
available_flag	integer	Flag indicating whether the requested NBA or WNBA Stats video or data asset is available.

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

Example

nba_stats_teamgamelogs(league_id='00')

Last validated n/a.

nba_stats_teaminfocommon

GET /stats/teaminfocommon

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

Valid URL: https://stats.nba.com/stats/teaminfocommon?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season_nullable			Y
SeasonType	season_type_nullable			Y
TeamID	team_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
team_id	integer	Unique team identifier.
season_year	character	Season year string ('YYYY-YY' format).
team_city	character	Team city or region (e.g. 'Las Vegas').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_conference	character
team_division	character
team_code	character	Internal team code.
team_slug	character	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
w	integer	Wins.
l	integer	Losses.
pct	numeric	Win percentage.
conf_rank	integer
div_rank	integer
min_year	character	Minimum year queried (echoes min_year).
max_year	character	Maximum year queried (echoes max_year).

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

Example

nba_stats_teaminfocommon(league_id='00')

Last validated n/a.

nba_stats_teamplayerdashboard

GET /stats/teamplayerdashboard

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

Valid URL: https://stats.nba.com/stats/teamplayerdashboard?LeagueID=00

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			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
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
ShotClockRange	shot_clock_range_nullable			Y
TeamID	team_id			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
group_set	character	Name of the grouping family used for this dashboard or split row.
player_id	integer	Unique player identifier.
player_name	character	Player name.
nickname	character	Team or athlete nickname.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.
team_count	integer	NBA or WNBA Stats value for team count in the teamplayerdashboard result set.

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

Example

nba_stats_teamplayerdashboard(league_id='00')

Last validated n/a.

nba_stats_teamplayeronoffdetails

GET /stats/teamplayeronoffdetails

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

Valid URL: https://stats.nba.com/stats/teamplayeronoffdetails?LeagueID=00

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			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
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
group_set	character	Name of the grouping family used for this dashboard or split row.
team_id	character	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
vs_player_id	character	Stats API identifier for vs player identifier associated with this NBA or WNBA Stats row.
vs_player_name	character	Display name for vs player name associated with this NBA or WNBA Stats row.
court_status	character	Indicates whether the compared player was on court or off court for the split row.
gp	character	Games played.
w	character	Wins.
l	character	Losses.
w_pct	character	Wins percentage (0-1 decimal).
min	character	Minutes played.
fgm	character	Field goals made.
fga	character	Field goal attempts.
fg_pct	character	Field goal percentage (0-1).
fg3m	character	Three-point field goals made.
fg3a	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.
tov	character	Turnovers.
stl	character	Steals.
blk	character	Blocks.
blka	character	Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pf	character	Personal fouls.
pfd	character	Personal fouls drawn for the requested NBA or WNBA Stats split.
pts	character	Points scored.
plus_minus	character	Plus/minus point differential while on court.
gp_rank	character	Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rank	character	Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rank	character	Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rank	character	Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rank	character	Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rank	character	Rank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rank	character	Rank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rank	character	Rank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3m_rank	character	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_rank	character	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	character	Rank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rank	character	Rank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rank	character	Rank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rank	character	Rank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rank	character	Rank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rank	character	Rank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rank	character	Rank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rank	character	Rank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rank	character	Rank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rank	character	Rank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rank	character	Rank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rank	character	Rank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rank	character	Rank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rank	character	Rank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rank	character	Rank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rank	character	Rank 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_teamplayeronoffdetails(league_id='00')

Last validated n/a.

nba_stats_teamplayeronoffsummary

GET /stats/teamplayeronoffsummary

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

Valid URL: https://stats.nba.com/stats/teamplayeronoffsummary?LeagueID=00

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			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
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year (e.g. 2024).
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_all_star			Y
TeamID	team_id			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
group_set	character	Name of the grouping family used for this dashboard or split row.
group_value	character	Specific grouping value for this dashboard or split row.
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').
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).
fg3m	numeric	Three-point field goals made.
fg3a	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.
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.
fg3m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3a_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.

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

Example

nba_stats_teamplayeronoffsummary(league_id='00')

Last validated n/a.

nba_stats_teamvsplayer

GET /stats/teamvsplayer

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

Valid URL: https://stats.nba.com/stats/teamvsplayer?LeagueID=00

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			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
PlayerID	player_id_nullable			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
TeamID	team_id			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsPlayerID	vs_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
group_set	character
group_value	character
player_id	integer	Unique player identifier.
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).
fg3m	numeric	Three-point field goals made.
fg3a	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
pf	numeric	Personal fouls.
pfd	numeric
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
nba_fantasy_pts	numeric
dd2	integer
td3	integer
wnba_fantasy_pts	numeric
gp_rank	integer
w_rank	integer
l_rank	integer
w_pct_rank	integer
min_rank	integer
fgm_rank	integer
fga_rank	integer
fg_pct_rank	integer
fg3m_rank	integer
fg3a_rank	integer
fg3_pct_rank	integer
ftm_rank	integer
fta_rank	integer
ft_pct_rank	integer
oreb_rank	integer
dreb_rank	integer
reb_rank	integer
ast_rank	integer
tov_rank	integer
stl_rank	integer
blk_rank	integer
blka_rank	integer
pf_rank	integer
pfd_rank	integer
pts_rank	integer
plus_minus_rank	integer
nba_fantasy_pts_rank	integer
dd2_rank	integer
td3_rank	integer
wnba_fantasy_pts_rank	integer
team_count	integer

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

Example

nba_stats_teamvsplayer(league_id='00')

Last validated n/a.

nba_stats_teamyearbyyearstats

GET /stats/teamyearbyyearstats

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

Valid URL: https://stats.nba.com/stats/teamyearbyyearstats?LeagueID=00

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
PerMode	per_mode_simple			Y
SeasonType	season_type_all_star			Y
TeamID	team_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
team_id	integer	Unique team identifier.
team_city	character	Team city or region (e.g. 'Las Vegas').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
year	character	4-digit year.
gp	integer	Games played.
wins	integer	Total wins.
losses	integer	Total losses.
win_pct	numeric	Win percentage (0-1 decimal).
conf_rank	integer
div_rank	integer
po_wins	integer
po_losses	integer
conf_count	integer
div_count	integer
nba_finals_appearance	character
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3m	numeric	Three-point field goals made.
fg3a	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.
pf	numeric	Personal fouls.
stl	numeric	Steals.
tov	numeric	Turnovers.
blk	numeric	Blocks.
pts	numeric	Points scored.
pts_rank	integer

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

Example

nba_stats_teamyearbyyearstats(league_id='00')

Last validated n/a.