Skip to main content

NBA G League — G League Stats API (stats.nba.com, LeagueID=20) — League dashboards

nbagl_stats_leaguedashlineups​

League dash lineups.

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

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

API ParameterPythonPatternRequiredNullableDescription
Conferenceconference_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
GameSegmentgame_segment_nullableY
GroupQuantitygroup_quantityY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

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

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
group_idString
group_nameStringThe lineup's five players as a ' - ' separated string of abbreviated names (e.g. 'K. Caldwell-Pope - A. Gordon - N. Jokic - ...').
team_idInt64
team_abbreviationString
gpInt64
wInt64
lInt64
w_pctFloat64
minFloat64
fgmFloat64
fgaFloat64
fg_pctFloat64
fg3_mFloat64Three-point field goals made.
fg3_aFloat64Three-point field goal attempts.
fg3_pctFloat64
ftmFloat64
ftaFloat64
ft_pctFloat64
orebFloat64
drebFloat64
rebFloat64
astFloat64
tovFloat64
stlFloat64
blkFloat64
blkaFloat64Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pfFloat64
pfdFloat64Personal fouls drawn for the requested NBA or WNBA Stats split.
ptsFloat64
plus_minusFloat64
gp_rankInt64Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rankInt64Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rankInt64Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rankInt64Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rankInt64Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rankInt64Rank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rankInt64Rank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rankInt64Rank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_m_rankInt64Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_a_rankInt64Rank for three-point field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_pct_rankInt64Rank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rankInt64Rank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rankInt64Rank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rankInt64Rank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rankInt64Rank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rankInt64Rank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rankInt64Rank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rankInt64Rank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rankInt64Rank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rankInt64Rank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rankInt64Rank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rankInt64Rank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rankInt64Rank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rankInt64Rank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rankInt64Rank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rankInt64Rank for plus-minus within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
sum_time_playedInt64Time value for sum time played in the NBA or WNBA Stats result set.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashlineups(league_id='20', season='2024-25')

nbagl_stats_leaguedashplayerbiostats​

League dash player bio stats.

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

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

API ParameterPythonPatternRequiredNullableDescription
Collegecollege_nullableY
Conferenceconference_nullableY
Countrycountry_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
DraftPickdraft_pick_nullableY
DraftYeardraft_year_nullableY
GameScopegame_scope_simple_nullableY
GameSegmentgame_segment_nullableY
Heightheight_nullableY
LastNGameslast_n_games_nullableY
LeagueIDleague_idY
Locationlocation_nullableY
Monthmonth_nullableY
OpponentTeamIDopponent_team_id_nullableY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PerModeper_mode_simpleY
Periodperiod_nullableY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_abbreviation_nullableY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY
Weightweight_nullableY

Returns​

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

col_nametypedescription
player_idInt64
player_nameString
team_idInt64
team_abbreviationString
ageFloat64
player_heightStringPlayer height as a feet-inches string (e.g. '6-4').
player_height_inchesInt64NBA or WNBA Stats value for player height inches in the leaguedashplayerbiostats result set.
player_weightStringPlayer weight in pounds, as a string.
collegeString
countryString
draft_yearString
draft_roundString
draft_numberStringOverall pick the player was selected with, as a string; 'Undrafted' when never drafted.
gpInt64
ptsFloat64
rebFloat64
astFloat64
net_ratingFloat64
oreb_pctFloat64Percentage or rate for offensive rebounds percentage in the requested NBA or WNBA Stats split.
dreb_pctFloat64Percentage or rate for defensive rebounds percentage in the requested NBA or WNBA Stats split.
usg_pctFloat64Percentage or rate for usage percentage in the requested NBA or WNBA Stats split.
ts_pctFloat64
ast_pctFloat64

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashplayerbiostats(league_id='20', season='2024-25')

nbagl_stats_leaguedashplayerclutch​

League dash player clutch.

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

Valid URL: https://stats.nba.com/stats/leaguedashplayerclutch?AheadBehind=Ahead+or+Behind&ClutchTime=Last+5+Minutes&College=&Conference=&Country=&DateFrom=&DateTo=&Division=&DraftPick=&DraftYear=&GameScope=&GameSegment=&Height=&LastNGames=0&LeagueID=20&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PORound=&PaceAdjust=N&PerMode=Totals&Period=0&PlayerExperience=&PlayerPosition=&PlusMinus=N&PointDiff=5&Rank=N&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&ShotClockRange=&StarterBench=&TeamID=0&VsConference=&VsDivision=&Weight=

API ParameterPythonPatternRequiredNullableDescription
AheadBehindahead_behindY
ClutchTimeclutch_timeY
Collegecollege_nullableY
Conferenceconference_nullableY
Countrycountry_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
DraftPickdraft_pick_nullableY
DraftYeardraft_year_nullableY
GameScopegame_scope_simple_nullableY
GameSegmentgame_segment_nullableY
Heightheight_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_abbreviation_nullableY
PlusMinusplus_minusY
PointDiffpoint_diffY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY
Weightweight_nullableY

Returns​

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

col_nametypedescription
group_setStringName of the split group the row belongs to (e.g. Overall, By Opponent, By Month).
player_idInt64
player_nameString
nicknameString
team_idInt64
team_abbreviationString
ageFloat64
gpInt64
wInt64
lInt64
w_pctFloat64
minFloat64
fgmFloat64
fgaFloat64
fg_pctFloat64
fg3_mFloat64Three-point field goals made.
fg3_aFloat64Three-point field goal attempts.
fg3_pctFloat64
ftmFloat64
ftaFloat64
ft_pctFloat64
orebFloat64
drebFloat64
rebFloat64
astFloat64
tovFloat64
stlFloat64
blkFloat64
blkaFloat64Shot attempts blocked by opponents (blocks against).
pfFloat64
pfdFloat64Personal fouls drawn.
ptsFloat64
plus_minusFloat64
nba_fantasy_ptsFloat64Fantasy points under the NBA's fantasy scoring formula.
dd2Int64Double-doubles recorded over the split.
td3Int64Triple-doubles recorded over the split.
wnba_fantasy_ptsFloat64Fantasy points under the WNBA's fantasy scoring formula.
gp_rankInt64League rank of the row's games played for the season and split.
w_rankInt64League rank of the row's wins for the season and split.
l_rankInt64League rank of the row's losses for the season and split.
w_pct_rankInt64League rank of the row's win percentage for the season and split.
min_rankInt64League rank of the row's minutes played for the season and split.
fgm_rankInt64League rank of the row's field goals made for the season and split.
fga_rankInt64League rank of the row's field goals attempted for the season and split.
fg_pct_rankInt64League rank of the row's field goal percentage for the season and split.
fg3_m_rankInt64League rank of the row's three-point field goals made for the season and split.
fg3_a_rankInt64League rank of the row's three-point field goals attempted for the season and split.
fg3_pct_rankInt64League rank of the row's three-point field goal percentage for the season and split.
ftm_rankInt64League rank of the row's free throws made for the season and split.
fta_rankInt64League rank of the row's free throws attempted for the season and split.
ft_pct_rankInt64League rank of the row's free throw percentage for the season and split.
oreb_rankInt64League rank of the row's offensive rebounds for the season and split.
dreb_rankInt64League rank of the row's defensive rebounds for the season and split.
reb_rankInt64League rank of the row's total rebounds for the season and split.
ast_rankInt64League rank of the row's assists for the season and split.
tov_rankInt64League rank of the row's turnovers for the season and split.
stl_rankInt64League rank of the row's steals for the season and split.
blk_rankInt64League rank of the row's blocked shots for the season and split.
blka_rankInt64League rank of the row's shot attempts blocked by opponents (blocks against) for the season and split.
pf_rankInt64League rank of the row's personal fouls committed for the season and split.
pfd_rankInt64League rank of the row's personal fouls drawn for the season and split.
pts_rankInt64League rank of the row's points scored for the season and split.
plus_minus_rankInt64League rank of the row's plus-minus point differential while on the floor for the season and split.
nba_fantasy_pts_rankInt64League rank of the row's NBA fantasy points (league scoring formula) for the season and split.
dd2_rankInt64League rank of the row's double-doubles for the season and split.
td3_rankInt64League rank of the row's triple-doubles for the season and split.
wnba_fantasy_pts_rankInt64League rank of the row's WNBA fantasy points (league scoring formula) for the season and split.
team_countInt64Number of distinct teams aggregated into the split row.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashplayerclutch(league_id='20', season='2024-25')

nbagl_stats_leaguedashplayershotlocations​

League dash player shot locations.

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

Valid URL: https://stats.nba.com/stats/leaguedashplayershotlocations?College=&Conference=&Country=&DateFrom=&DateTo=&DistanceRange=By+Zone&Division=&DraftPick=&DraftYear=&GameScope=&GameSegment=&Height=&LastNGames=0&LeagueID=20&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PORound=&PaceAdjust=N&PerMode=Totals&Period=0&PlayerExperience=&PlayerPosition=&PlusMinus=N&Rank=N&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&ShotClockRange=&StarterBench=&TeamID=0&VsConference=&VsDivision=&Weight=

API ParameterPythonPatternRequiredNullableDescription
Collegecollege_nullableY
Conferenceconference_nullableY
Countrycountry_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
DistanceRangedistance_rangeY
Divisiondivision_simple_nullableY
DraftPickdraft_pick_nullableY
DraftYeardraft_year_nullableY
GameScopegame_scope_simple_nullableY
GameSegmentgame_segment_nullableY
Heightheight_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_simpleY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_abbreviation_nullableY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY
Weightweight_nullableY

Returns​

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

col_nametypedescription
player_idInt64
player_nameString
team_idInt64
team_abbreviationString
ageFloat64
nicknameString
less_than_5_ft_fgmFloat64Field goals made from less than 5 feet.
less_than_5_ft_fgaFloat64Field goals attempted from less than 5 feet.
less_than_5_ft_fg_pctFloat64Field goal percentage on shots from less than 5 feet, as a decimal.
5_9_ft_fgmFloat64Field goals made from 5-9 feet.
5_9_ft_fgaFloat64Field goals attempted from 5-9 feet.
5_9_ft_fg_pctFloat64Field goal percentage on shots from 5-9-f feet, as a decimal.
10_14_ft_fgmFloat64Field goals made from 10-14 feet.
10_14_ft_fgaFloat64Field goals attempted from 10-14 feet.
10_14_ft_fg_pctFloat64Field goal percentage on shots from 10-14-f feet, as a decimal.
15_19_ft_fgmFloat64Field goals made from 15-19 feet.
15_19_ft_fgaFloat64Field goals attempted from 15-19 feet.
15_19_ft_fg_pctFloat64Field goal percentage on shots from 15-19-f feet, as a decimal.
20_24_ft_fgmFloat64Field goals made from 20-24 feet.
20_24_ft_fgaFloat64Field goals attempted from 20-24 feet.
20_24_ft_fg_pctFloat64Field goal percentage on shots from 20-24-f feet, as a decimal.
25_29_ft_fgmFloat64Field goals made from 25-29 feet.
25_29_ft_fgaFloat64Field goals attempted from 25-29 feet.
25_29_ft_fg_pctFloat64Field goal percentage on shots from 25-29-f feet, as a decimal.
30_34_ft_fgmFloat64Field goals made from 30-34 feet.
30_34_ft_fgaFloat64Field goals attempted from 30-34 feet.
30_34_ft_fg_pctFloat64Field goal percentage on shots from 30-34-f feet, as a decimal.
35_39_ft_fgmFloat64Field goals made from 35-39 feet.
35_39_ft_fgaFloat64Field goals attempted from 35-39 feet.
35_39_ft_fg_pctFloat64Field goal percentage on shots from 35-39-f feet, as a decimal.
40+_ft_fgmFloat64Field goals made from 40 feet and beyond, per the stats API's shot-location distance bands.
40+_ft_fgaFloat64Field goals attempted from 40 feet and beyond, per the stats API's shot-location distance bands.
40+_ft_fg_pctFloat64Field-goal percentage on attempts from 40 feet and beyond, as a decimal.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashplayershotlocations(league_id='20', season='2024-25')

nbagl_stats_leaguedashplayerstats​

League dash player stats.

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

Valid URL: https://stats.nba.com/stats/leaguedashplayerstats?College=&Conference=&Country=&DateFrom=&DateTo=&Division=&DraftPick=&DraftYear=&GameScope=&GameSegment=&Height=&LastNGames=0&LeagueID=20&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PORound=&PaceAdjust=N&PerMode=Totals&Period=0&PlayerExperience=&PlayerPosition=&PlusMinus=N&Rank=N&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&ShotClockRange=&StarterBench=&TeamID=0&TwoWay=&VsConference=&VsDivision=&Weight=

API ParameterPythonPatternRequiredNullableDescription
Collegecollege_nullableY
Conferenceconference_nullableY
Countrycountry_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
DraftPickdraft_pick_nullableY
DraftYeardraft_year_nullableY
GameScopegame_scope_simple_nullableY
GameSegmentgame_segment_nullableY
Heightheight_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_abbreviation_nullableY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
TwoWaytwo_way_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY
Weightweight_nullableY

Returns​

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

col_nametypedescription
player_idInt64
player_nameString
nicknameString
team_idInt64
team_abbreviationString
ageFloat64
gpInt64
wInt64
lInt64
w_pctFloat64
minFloat64
fgmFloat64
fgaFloat64
fg_pctFloat64
fg3_mFloat64Three-point field goals made.
fg3_aFloat64Three-point field goal attempts.
fg3_pctFloat64
ftmFloat64
ftaFloat64
ft_pctFloat64
orebFloat64
drebFloat64
rebFloat64
astFloat64
tovFloat64
stlFloat64
blkFloat64
blkaFloat64Blocked shot attempts against the player — shots the player attempted that were blocked by opponents.
pfFloat64
pfdFloat64Personal fouls drawn — fouls committed by opponents against this player.
ptsFloat64
plus_minusFloat64
nba_fantasy_ptsFloat64NBA fantasy points accrued under the standard NBA fantasy scoring formula.
dd2Int64Number of double-doubles recorded over the span.
td3Int64Number of triple-doubles recorded over the span.
wnba_fantasy_ptsFloat64WNBA fantasy points accrued under the standard WNBA fantasy scoring formula.
gp_rankInt64Player's league rank for games played among qualified players (1 = most games).
w_rankInt64Player's league rank for wins (1 = most wins while active).
l_rankInt64Player's league rank for losses (1 = most losses while active).
w_pct_rankInt64Player's league rank for win percentage (1 = highest win pct).
min_rankInt64Player's league rank for minutes played (1 = most minutes).
fgm_rankInt64Player's league rank for field goals made (1 = most made).
fga_rankInt64Player's league rank for field goal attempts (1 = most attempts).
fg_pct_rankInt64Player's league rank for field goal percentage (1 = highest pct).
fg3_m_rankInt64Player's league rank for three-point field goals made (1 = most made).
fg3_a_rankInt64Player's league rank for three-point field goal attempts (1 = most attempts).
fg3_pct_rankInt64Player's league rank for three-point percentage (1 = highest pct).
ftm_rankInt64Player's league rank for free throws made (1 = most made).
fta_rankInt64Player's league rank for free throw attempts (1 = most attempts).
ft_pct_rankInt64Player's league rank for free throw percentage (1 = highest pct).
oreb_rankInt64Player's league rank for offensive rebounds (1 = most offensive rebounds).
dreb_rankInt64Player's league rank for defensive rebounds (1 = most defensive rebounds).
reb_rankInt64Player's league rank for total rebounds (1 = most rebounds).
ast_rankInt64Player's league rank for assists (1 = most assists).
tov_rankInt64Player's league rank for turnovers — note: lower turnovers is typically better.
stl_rankInt64Player's league rank for steals (1 = most steals).
blk_rankInt64Player's league rank for blocked shots (1 = most blocks).
blka_rankInt64Player's league rank for shots blocked by opponents (1 = most blocked).
pf_rankInt64Player's league rank for personal fouls committed (1 = most fouls).
pfd_rankInt64Player's league rank for personal fouls drawn from opponents (1 = most drawn).
pts_rankInt64Player's league rank for points scored (1 = league leader).
plus_minus_rankInt64Player's league rank for plus/minus rating (1 = best differential).
nba_fantasy_pts_rankInt64Player's league rank for NBA fantasy points scored (1 = most fantasy points).
dd2_rankInt64Player's league rank for double-doubles recorded (1 = most double-doubles).
td3_rankInt64Player's league rank for triple-doubles recorded (1 = most triple-doubles).
wnba_fantasy_pts_rankInt64Player's league rank for WNBA fantasy points scored (1 = most fantasy points).
team_countInt64Number of teams the player appeared for within the span.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashplayerstats(league_id='20', season='2024-25')

nbagl_stats_leaguedashteamclutch​

League dash team clutch.

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

Valid URL: https://stats.nba.com/stats/leaguedashteamclutch?AheadBehind=Ahead+or+Behind&ClutchTime=Last+5+Minutes&Conference=&DateFrom=&DateTo=&Division=&GameScope=&GameSegment=&LastNGames=0&LeagueID=20&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PORound=&PaceAdjust=N&PerMode=Totals&Period=0&PlayerExperience=&PlayerPosition=&PlusMinus=N&PointDiff=5&Rank=N&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&ShotClockRange=&StarterBench=&TeamID=0&VsConference=&VsDivision=

API ParameterPythonPatternRequiredNullableDescription
AheadBehindahead_behindY
ClutchTimeclutch_timeY
Conferenceconference_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
GameScopegame_scope_simple_nullableY
GameSegmentgame_segment_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_abbreviation_nullableY
PlusMinusplus_minusY
PointDiffpoint_diffY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

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

col_nametypedescription
team_idInt64
team_nameString
gpInt64
wInt64
lInt64
w_pctFloat64
minFloat64
fgmFloat64
fgaFloat64
fg_pctFloat64
fg3_mFloat64Three-point field goals made.
fg3_aFloat64Three-point field goal attempts.
fg3_pctFloat64
ftmFloat64
ftaFloat64
ft_pctFloat64
orebFloat64
drebFloat64
rebFloat64
astFloat64
tovFloat64
stlFloat64
blkFloat64
blkaFloat64Shot attempts blocked by opponents (blocks against).
pfFloat64
pfdFloat64Personal fouls drawn.
ptsFloat64
plus_minusFloat64
gp_rankInt64League rank of the row's games played for the season and split.
w_rankInt64League rank of the row's wins for the season and split.
l_rankInt64League rank of the row's losses for the season and split.
w_pct_rankInt64League rank of the row's win percentage for the season and split.
min_rankInt64League rank of the row's minutes played for the season and split.
fgm_rankInt64League rank of the row's field goals made for the season and split.
fga_rankInt64League rank of the row's field goals attempted for the season and split.
fg_pct_rankInt64League rank of the row's field goal percentage for the season and split.
fg3_m_rankInt64League rank of the row's three-point field goals made for the season and split.
fg3_a_rankInt64League rank of the row's three-point field goals attempted for the season and split.
fg3_pct_rankInt64League rank of the row's three-point field goal percentage for the season and split.
ftm_rankInt64League rank of the row's free throws made for the season and split.
fta_rankInt64League rank of the row's free throws attempted for the season and split.
ft_pct_rankInt64League rank of the row's free throw percentage for the season and split.
oreb_rankInt64League rank of the row's offensive rebounds for the season and split.
dreb_rankInt64League rank of the row's defensive rebounds for the season and split.
reb_rankInt64League rank of the row's total rebounds for the season and split.
ast_rankInt64League rank of the row's assists for the season and split.
tov_rankInt64League rank of the row's turnovers for the season and split.
stl_rankInt64League rank of the row's steals for the season and split.
blk_rankInt64League rank of the row's blocked shots for the season and split.
blka_rankInt64League rank of the row's shot attempts blocked by opponents (blocks against) for the season and split.
pf_rankInt64League rank of the row's personal fouls committed for the season and split.
pfd_rankInt64League rank of the row's personal fouls drawn for the season and split.
pts_rankInt64League rank of the row's points scored for the season and split.
plus_minus_rankInt64League rank of the row's plus-minus point differential while on the floor for the season and split.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashteamclutch(league_id='20', season='2024-25')

nbagl_stats_leaguedashteamshotlocations​

League dash team shot locations.

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

Valid URL: https://stats.nba.com/stats/leaguedashteamshotlocations?Conference=&DateFrom=&DateTo=&DistanceRange=By+Zone&Division=&GameScope=&GameSegment=&LastNGames=0&LeagueID=20&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PORound=&PaceAdjust=N&PerMode=Totals&Period=0&PlayerExperience=&PlayerPosition=&PlusMinus=N&Rank=N&Season=2024-25&SeasonSegment=&SeasonType=Regular+Season&ShotClockRange=&StarterBench=&TeamID=0&VsConference=&VsDivision=

API ParameterPythonPatternRequiredNullableDescription
Conferenceconference_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
DistanceRangedistance_rangeY
Divisiondivision_simple_nullableY
GameScopegame_scope_simple_nullableY
GameSegmentgame_segment_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_simpleY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_abbreviation_nullableY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

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

col_nametypedescription
team_idInt64
team_nameString
less_than_5_ft_fgmFloat64Field goals made from less than 5 feet.
less_than_5_ft_fgaFloat64Field goals attempted from less than 5 feet.
less_than_5_ft_fg_pctFloat64Field goal percentage on shots from less than 5 feet, as a decimal.
5_9_ft_fgmFloat64Field goals made from 5-9 feet.
5_9_ft_fgaFloat64Field goals attempted from 5-9 feet.
5_9_ft_fg_pctFloat64Field goal percentage on shots from 5-9-f feet, as a decimal.
10_14_ft_fgmFloat64Field goals made from 10-14 feet.
10_14_ft_fgaFloat64Field goals attempted from 10-14 feet.
10_14_ft_fg_pctFloat64Field goal percentage on shots from 10-14-f feet, as a decimal.
15_19_ft_fgmFloat64Field goals made from 15-19 feet.
15_19_ft_fgaFloat64Field goals attempted from 15-19 feet.
15_19_ft_fg_pctFloat64Field goal percentage on shots from 15-19-f feet, as a decimal.
20_24_ft_fgmFloat64Field goals made from 20-24 feet.
20_24_ft_fgaFloat64Field goals attempted from 20-24 feet.
20_24_ft_fg_pctFloat64Field goal percentage on shots from 20-24-f feet, as a decimal.
25_29_ft_fgmFloat64Field goals made from 25-29 feet.
25_29_ft_fgaFloat64Field goals attempted from 25-29 feet.
25_29_ft_fg_pctFloat64Field goal percentage on shots from 25-29-f feet, as a decimal.
30_34_ft_fgmFloat64Field goals made from 30-34 feet.
30_34_ft_fgaFloat64Field goals attempted from 30-34 feet.
30_34_ft_fg_pctFloat64Field goal percentage on shots from 30-34-f feet, as a decimal.
35_39_ft_fgmFloat64Field goals made from 35-39 feet.
35_39_ft_fgaFloat64Field goals attempted from 35-39 feet.
35_39_ft_fg_pctFloat64Field goal percentage on shots from 35-39-f feet, as a decimal.
40+_ft_fgmFloat64Team field goals made from 40 feet and beyond, per the stats API's shot-location distance bands.
40+_ft_fgaFloat64Team field goals attempted from 40 feet and beyond, per the stats API's shot-location distance bands.
40+_ft_fg_pctFloat64Team field-goal percentage on attempts from 40 feet and beyond, as a decimal.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashteamshotlocations(league_id='20', season='2024-25')

nbagl_stats_leaguedashteamstats​

League dash team stats.

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

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

API ParameterPythonPatternRequiredNullableDescription
Conferenceconference_nullableY
DateFromdate_from_nullableY
DateTodate_to_nullableY
Divisiondivision_simple_nullableY
GameScopegame_scope_simple_nullableY
GameSegmentgame_segment_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PORoundpo_round_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlayerExperienceplayer_experience_nullableY
PlayerPositionplayer_position_abbreviation_nullableY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. A G League regular season starts in late December and becomes the default in January (2025-26 from January 2026); a draft combine (May) in June. With season type Playoffs (or commonplayoffseries) it rolls over in May, after the late-March playoffs start; the G League has no All-Star rows. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.nba.com answers an empty HTTP 500 or every season summed.
SeasonSegmentseason_segment_nullableY
SeasonTypeseason_type_all_starYSeason type, a label: Regular Season, Pre Season or Playoffs (each endpoint takes a subset; the G League has no All Star rows). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in May.
ShotClockRangeshot_clock_range_nullableY
StarterBenchstarter_bench_nullableY
TeamIDteam_id_nullableY
TwoWaytwo_way_nullableY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

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

col_nametypedescription
team_idInt64
team_nameString
gpInt64
wInt64
lInt64
w_pctFloat64
minFloat64
fgmFloat64
fgaFloat64
fg_pctFloat64
fg3_mFloat64Three-point field goals made.
fg3_aFloat64Three-point field goal attempts.
fg3_pctFloat64
ftmFloat64
ftaFloat64
ft_pctFloat64
orebFloat64
drebFloat64
rebFloat64
astFloat64
tovFloat64
stlFloat64
blkFloat64
blkaFloat64Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pfFloat64
pfdFloat64Personal fouls drawn for the requested NBA or WNBA Stats split.
ptsFloat64
plus_minusFloat64
gp_rankInt64Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rankInt64Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rankInt64Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rankInt64Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rankInt64Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rankInt64Rank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rankInt64Rank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rankInt64Rank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_m_rankInt64Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_a_rankInt64Rank for three-point field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_pct_rankInt64Rank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rankInt64Rank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rankInt64Rank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rankInt64Rank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rankInt64Rank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rankInt64Rank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rankInt64Rank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rankInt64Rank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rankInt64Rank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rankInt64Rank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rankInt64Rank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rankInt64Rank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rankInt64Rank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rankInt64Rank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rankInt64Rank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rankInt64Rank 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.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_leaguedashteamstats(league_id='20', season='2024-25')