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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | String | Name of the grouping family used for this dashboard or split row. |
group_id | String | |
group_name | String | The lineup's five players as a ' - ' separated string of abbreviated names (e.g. 'K. Caldwell-Pope - A. Gordon - N. Jokic - ...'). |
team_id | Int64 | |
team_abbreviation | String | |
gp | Int64 | |
w | Int64 | |
l | Int64 | |
w_pct | Float64 | |
min | Float64 | |
fgm | Float64 | |
fga | Float64 | |
fg_pct | Float64 | |
fg3_m | Float64 | Three-point field goals made. |
fg3_a | Float64 | Three-point field goal attempts. |
fg3_pct | Float64 | |
ftm | Float64 | |
fta | Float64 | |
ft_pct | Float64 | |
oreb | Float64 | |
dreb | Float64 | |
reb | Float64 | |
ast | Float64 | |
tov | Float64 | |
stl | Float64 | |
blk | Float64 | |
blka | Float64 | Blocked field-goal attempts against for the requested NBA or WNBA Stats split. |
pf | Float64 | |
pfd | Float64 | Personal fouls drawn for the requested NBA or WNBA Stats split. |
pts | Float64 | |
plus_minus | Float64 | |
gp_rank | Int64 | Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
w_rank | Int64 | Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
l_rank | Int64 | Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
w_pct_rank | Int64 | Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
min_rank | Int64 | Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fgm_rank | Int64 | Rank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fga_rank | Int64 | Rank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fg_pct_rank | Int64 | Rank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fg3_m_rank | Int64 | Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fg3_a_rank | Int64 | 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 | Int64 | Rank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
ftm_rank | Int64 | Rank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fta_rank | Int64 | Rank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
ft_pct_rank | Int64 | Rank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
oreb_rank | Int64 | Rank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
dreb_rank | Int64 | Rank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
reb_rank | Int64 | Rank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
ast_rank | Int64 | Rank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
tov_rank | Int64 | Rank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
stl_rank | Int64 | Rank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
blk_rank | Int64 | Rank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
blka_rank | Int64 | Rank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
pf_rank | Int64 | Rank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
pfd_rank | Int64 | Rank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
pts_rank | Int64 | Rank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
plus_minus_rank | Int64 | Rank for plus-minus within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
sum_time_played | Int64 | Time value for sum time played in the NBA or WNBA Stats result set. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | Int64 | |
player_name | String | |
team_id | Int64 | |
team_abbreviation | String | |
age | Float64 | |
player_height | String | Player height as a feet-inches string (e.g. '6-4'). |
player_height_inches | Int64 | NBA or WNBA Stats value for player height inches in the leaguedashplayerbiostats result set. |
player_weight | String | Player weight in pounds, as a string. |
college | String | |
country | String | |
draft_year | String | |
draft_round | String | |
draft_number | String | Overall pick the player was selected with, as a string; 'Undrafted' when never drafted. |
gp | Int64 | |
pts | Float64 | |
reb | Float64 | |
ast | Float64 | |
net_rating | Float64 | |
oreb_pct | Float64 | Percentage or rate for offensive rebounds percentage in the requested NBA or WNBA Stats split. |
dreb_pct | Float64 | Percentage or rate for defensive rebounds percentage in the requested NBA or WNBA Stats split. |
usg_pct | Float64 | Percentage or rate for usage percentage in the requested NBA or WNBA Stats split. |
ts_pct | Float64 | |
ast_pct | Float64 |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | String | Name of the split group the row belongs to (e.g. Overall, By Opponent, By Month). |
player_id | Int64 | |
player_name | String | |
nickname | String | |
team_id | Int64 | |
team_abbreviation | String | |
age | Float64 | |
gp | Int64 | |
w | Int64 | |
l | Int64 | |
w_pct | Float64 | |
min | Float64 | |
fgm | Float64 | |
fga | Float64 | |
fg_pct | Float64 | |
fg3_m | Float64 | Three-point field goals made. |
fg3_a | Float64 | Three-point field goal attempts. |
fg3_pct | Float64 | |
ftm | Float64 | |
fta | Float64 | |
ft_pct | Float64 | |
oreb | Float64 | |
dreb | Float64 | |
reb | Float64 | |
ast | Float64 | |
tov | Float64 | |
stl | Float64 | |
blk | Float64 | |
blka | Float64 | Shot attempts blocked by opponents (blocks against). |
pf | Float64 | |
pfd | Float64 | Personal fouls drawn. |
pts | Float64 | |
plus_minus | Float64 | |
nba_fantasy_pts | Float64 | Fantasy points under the NBA's fantasy scoring formula. |
dd2 | Int64 | Double-doubles recorded over the split. |
td3 | Int64 | Triple-doubles recorded over the split. |
wnba_fantasy_pts | Float64 | Fantasy points under the WNBA's fantasy scoring formula. |
gp_rank | Int64 | League rank of the row's games played for the season and split. |
w_rank | Int64 | League rank of the row's wins for the season and split. |
l_rank | Int64 | League rank of the row's losses for the season and split. |
w_pct_rank | Int64 | League rank of the row's win percentage for the season and split. |
min_rank | Int64 | League rank of the row's minutes played for the season and split. |
fgm_rank | Int64 | League rank of the row's field goals made for the season and split. |
fga_rank | Int64 | League rank of the row's field goals attempted for the season and split. |
fg_pct_rank | Int64 | League rank of the row's field goal percentage for the season and split. |
fg3_m_rank | Int64 | League rank of the row's three-point field goals made for the season and split. |
fg3_a_rank | Int64 | League rank of the row's three-point field goals attempted for the season and split. |
fg3_pct_rank | Int64 | League rank of the row's three-point field goal percentage for the season and split. |
ftm_rank | Int64 | League rank of the row's free throws made for the season and split. |
fta_rank | Int64 | League rank of the row's free throws attempted for the season and split. |
ft_pct_rank | Int64 | League rank of the row's free throw percentage for the season and split. |
oreb_rank | Int64 | League rank of the row's offensive rebounds for the season and split. |
dreb_rank | Int64 | League rank of the row's defensive rebounds for the season and split. |
reb_rank | Int64 | League rank of the row's total rebounds for the season and split. |
ast_rank | Int64 | League rank of the row's assists for the season and split. |
tov_rank | Int64 | League rank of the row's turnovers for the season and split. |
stl_rank | Int64 | League rank of the row's steals for the season and split. |
blk_rank | Int64 | League rank of the row's blocked shots for the season and split. |
blka_rank | Int64 | League rank of the row's shot attempts blocked by opponents (blocks against) for the season and split. |
pf_rank | Int64 | League rank of the row's personal fouls committed for the season and split. |
pfd_rank | Int64 | League rank of the row's personal fouls drawn for the season and split. |
pts_rank | Int64 | League rank of the row's points scored for the season and split. |
plus_minus_rank | Int64 | League rank of the row's plus-minus point differential while on the floor for the season and split. |
nba_fantasy_pts_rank | Int64 | League rank of the row's NBA fantasy points (league scoring formula) for the season and split. |
dd2_rank | Int64 | League rank of the row's double-doubles for the season and split. |
td3_rank | Int64 | League rank of the row's triple-doubles for the season and split. |
wnba_fantasy_pts_rank | Int64 | League rank of the row's WNBA fantasy points (league scoring formula) for the season and split. |
team_count | Int64 | Number of distinct teams aggregated into the split row. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | Int64 | |
player_name | String | |
team_id | Int64 | |
team_abbreviation | String | |
age | Float64 | |
nickname | String | |
less_than_5_ft_fgm | Float64 | Field goals made from less than 5 feet. |
less_than_5_ft_fga | Float64 | Field goals attempted from less than 5 feet. |
less_than_5_ft_fg_pct | Float64 | Field goal percentage on shots from less than 5 feet, as a decimal. |
5_9_ft_fgm | Float64 | Field goals made from 5-9 feet. |
5_9_ft_fga | Float64 | Field goals attempted from 5-9 feet. |
5_9_ft_fg_pct | Float64 | Field goal percentage on shots from 5-9-f feet, as a decimal. |
10_14_ft_fgm | Float64 | Field goals made from 10-14 feet. |
10_14_ft_fga | Float64 | Field goals attempted from 10-14 feet. |
10_14_ft_fg_pct | Float64 | Field goal percentage on shots from 10-14-f feet, as a decimal. |
15_19_ft_fgm | Float64 | Field goals made from 15-19 feet. |
15_19_ft_fga | Float64 | Field goals attempted from 15-19 feet. |
15_19_ft_fg_pct | Float64 | Field goal percentage on shots from 15-19-f feet, as a decimal. |
20_24_ft_fgm | Float64 | Field goals made from 20-24 feet. |
20_24_ft_fga | Float64 | Field goals attempted from 20-24 feet. |
20_24_ft_fg_pct | Float64 | Field goal percentage on shots from 20-24-f feet, as a decimal. |
25_29_ft_fgm | Float64 | Field goals made from 25-29 feet. |
25_29_ft_fga | Float64 | Field goals attempted from 25-29 feet. |
25_29_ft_fg_pct | Float64 | Field goal percentage on shots from 25-29-f feet, as a decimal. |
30_34_ft_fgm | Float64 | Field goals made from 30-34 feet. |
30_34_ft_fga | Float64 | Field goals attempted from 30-34 feet. |
30_34_ft_fg_pct | Float64 | Field goal percentage on shots from 30-34-f feet, as a decimal. |
35_39_ft_fgm | Float64 | Field goals made from 35-39 feet. |
35_39_ft_fga | Float64 | Field goals attempted from 35-39 feet. |
35_39_ft_fg_pct | Float64 | Field goal percentage on shots from 35-39-f feet, as a decimal. |
40+_ft_fgm | Float64 | Field goals made from 40 feet and beyond, per the stats API's shot-location distance bands. |
40+_ft_fga | Float64 | Field goals attempted from 40 feet and beyond, per the stats API's shot-location distance bands. |
40+_ft_fg_pct | Float64 | Field-goal percentage on attempts from 40 feet and beyond, as a decimal. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | Int64 | |
player_name | String | |
nickname | String | |
team_id | Int64 | |
team_abbreviation | String | |
age | Float64 | |
gp | Int64 | |
w | Int64 | |
l | Int64 | |
w_pct | Float64 | |
min | Float64 | |
fgm | Float64 | |
fga | Float64 | |
fg_pct | Float64 | |
fg3_m | Float64 | Three-point field goals made. |
fg3_a | Float64 | Three-point field goal attempts. |
fg3_pct | Float64 | |
ftm | Float64 | |
fta | Float64 | |
ft_pct | Float64 | |
oreb | Float64 | |
dreb | Float64 | |
reb | Float64 | |
ast | Float64 | |
tov | Float64 | |
stl | Float64 | |
blk | Float64 | |
blka | Float64 | Blocked shot attempts against the player — shots the player attempted that were blocked by opponents. |
pf | Float64 | |
pfd | Float64 | Personal fouls drawn — fouls committed by opponents against this player. |
pts | Float64 | |
plus_minus | Float64 | |
nba_fantasy_pts | Float64 | NBA fantasy points accrued under the standard NBA fantasy scoring formula. |
dd2 | Int64 | Number of double-doubles recorded over the span. |
td3 | Int64 | Number of triple-doubles recorded over the span. |
wnba_fantasy_pts | Float64 | WNBA fantasy points accrued under the standard WNBA fantasy scoring formula. |
gp_rank | Int64 | Player's league rank for games played among qualified players (1 = most games). |
w_rank | Int64 | Player's league rank for wins (1 = most wins while active). |
l_rank | Int64 | Player's league rank for losses (1 = most losses while active). |
w_pct_rank | Int64 | Player's league rank for win percentage (1 = highest win pct). |
min_rank | Int64 | Player's league rank for minutes played (1 = most minutes). |
fgm_rank | Int64 | Player's league rank for field goals made (1 = most made). |
fga_rank | Int64 | Player's league rank for field goal attempts (1 = most attempts). |
fg_pct_rank | Int64 | Player's league rank for field goal percentage (1 = highest pct). |
fg3_m_rank | Int64 | Player's league rank for three-point field goals made (1 = most made). |
fg3_a_rank | Int64 | Player's league rank for three-point field goal attempts (1 = most attempts). |
fg3_pct_rank | Int64 | Player's league rank for three-point percentage (1 = highest pct). |
ftm_rank | Int64 | Player's league rank for free throws made (1 = most made). |
fta_rank | Int64 | Player's league rank for free throw attempts (1 = most attempts). |
ft_pct_rank | Int64 | Player's league rank for free throw percentage (1 = highest pct). |
oreb_rank | Int64 | Player's league rank for offensive rebounds (1 = most offensive rebounds). |
dreb_rank | Int64 | Player's league rank for defensive rebounds (1 = most defensive rebounds). |
reb_rank | Int64 | Player's league rank for total rebounds (1 = most rebounds). |
ast_rank | Int64 | Player's league rank for assists (1 = most assists). |
tov_rank | Int64 | Player's league rank for turnovers — note: lower turnovers is typically better. |
stl_rank | Int64 | Player's league rank for steals (1 = most steals). |
blk_rank | Int64 | Player's league rank for blocked shots (1 = most blocks). |
blka_rank | Int64 | Player's league rank for shots blocked by opponents (1 = most blocked). |
pf_rank | Int64 | Player's league rank for personal fouls committed (1 = most fouls). |
pfd_rank | Int64 | Player's league rank for personal fouls drawn from opponents (1 = most drawn). |
pts_rank | Int64 | Player's league rank for points scored (1 = league leader). |
plus_minus_rank | Int64 | Player's league rank for plus/minus rating (1 = best differential). |
nba_fantasy_pts_rank | Int64 | Player's league rank for NBA fantasy points scored (1 = most fantasy points). |
dd2_rank | Int64 | Player's league rank for double-doubles recorded (1 = most double-doubles). |
td3_rank | Int64 | Player's league rank for triple-doubles recorded (1 = most triple-doubles). |
wnba_fantasy_pts_rank | Int64 | Player's league rank for WNBA fantasy points scored (1 = most fantasy points). |
team_count | Int64 | Number of teams the player appeared for within the span. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | Int64 | |
team_name | String | |
gp | Int64 | |
w | Int64 | |
l | Int64 | |
w_pct | Float64 | |
min | Float64 | |
fgm | Float64 | |
fga | Float64 | |
fg_pct | Float64 | |
fg3_m | Float64 | Three-point field goals made. |
fg3_a | Float64 | Three-point field goal attempts. |
fg3_pct | Float64 | |
ftm | Float64 | |
fta | Float64 | |
ft_pct | Float64 | |
oreb | Float64 | |
dreb | Float64 | |
reb | Float64 | |
ast | Float64 | |
tov | Float64 | |
stl | Float64 | |
blk | Float64 | |
blka | Float64 | Shot attempts blocked by opponents (blocks against). |
pf | Float64 | |
pfd | Float64 | Personal fouls drawn. |
pts | Float64 | |
plus_minus | Float64 | |
gp_rank | Int64 | League rank of the row's games played for the season and split. |
w_rank | Int64 | League rank of the row's wins for the season and split. |
l_rank | Int64 | League rank of the row's losses for the season and split. |
w_pct_rank | Int64 | League rank of the row's win percentage for the season and split. |
min_rank | Int64 | League rank of the row's minutes played for the season and split. |
fgm_rank | Int64 | League rank of the row's field goals made for the season and split. |
fga_rank | Int64 | League rank of the row's field goals attempted for the season and split. |
fg_pct_rank | Int64 | League rank of the row's field goal percentage for the season and split. |
fg3_m_rank | Int64 | League rank of the row's three-point field goals made for the season and split. |
fg3_a_rank | Int64 | League rank of the row's three-point field goals attempted for the season and split. |
fg3_pct_rank | Int64 | League rank of the row's three-point field goal percentage for the season and split. |
ftm_rank | Int64 | League rank of the row's free throws made for the season and split. |
fta_rank | Int64 | League rank of the row's free throws attempted for the season and split. |
ft_pct_rank | Int64 | League rank of the row's free throw percentage for the season and split. |
oreb_rank | Int64 | League rank of the row's offensive rebounds for the season and split. |
dreb_rank | Int64 | League rank of the row's defensive rebounds for the season and split. |
reb_rank | Int64 | League rank of the row's total rebounds for the season and split. |
ast_rank | Int64 | League rank of the row's assists for the season and split. |
tov_rank | Int64 | League rank of the row's turnovers for the season and split. |
stl_rank | Int64 | League rank of the row's steals for the season and split. |
blk_rank | Int64 | League rank of the row's blocked shots for the season and split. |
blka_rank | Int64 | League rank of the row's shot attempts blocked by opponents (blocks against) for the season and split. |
pf_rank | Int64 | League rank of the row's personal fouls committed for the season and split. |
pfd_rank | Int64 | League rank of the row's personal fouls drawn for the season and split. |
pts_rank | Int64 | League rank of the row's points scored for the season and split. |
plus_minus_rank | Int64 | League 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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | Int64 | |
team_name | String | |
less_than_5_ft_fgm | Float64 | Field goals made from less than 5 feet. |
less_than_5_ft_fga | Float64 | Field goals attempted from less than 5 feet. |
less_than_5_ft_fg_pct | Float64 | Field goal percentage on shots from less than 5 feet, as a decimal. |
5_9_ft_fgm | Float64 | Field goals made from 5-9 feet. |
5_9_ft_fga | Float64 | Field goals attempted from 5-9 feet. |
5_9_ft_fg_pct | Float64 | Field goal percentage on shots from 5-9-f feet, as a decimal. |
10_14_ft_fgm | Float64 | Field goals made from 10-14 feet. |
10_14_ft_fga | Float64 | Field goals attempted from 10-14 feet. |
10_14_ft_fg_pct | Float64 | Field goal percentage on shots from 10-14-f feet, as a decimal. |
15_19_ft_fgm | Float64 | Field goals made from 15-19 feet. |
15_19_ft_fga | Float64 | Field goals attempted from 15-19 feet. |
15_19_ft_fg_pct | Float64 | Field goal percentage on shots from 15-19-f feet, as a decimal. |
20_24_ft_fgm | Float64 | Field goals made from 20-24 feet. |
20_24_ft_fga | Float64 | Field goals attempted from 20-24 feet. |
20_24_ft_fg_pct | Float64 | Field goal percentage on shots from 20-24-f feet, as a decimal. |
25_29_ft_fgm | Float64 | Field goals made from 25-29 feet. |
25_29_ft_fga | Float64 | Field goals attempted from 25-29 feet. |
25_29_ft_fg_pct | Float64 | Field goal percentage on shots from 25-29-f feet, as a decimal. |
30_34_ft_fgm | Float64 | Field goals made from 30-34 feet. |
30_34_ft_fga | Float64 | Field goals attempted from 30-34 feet. |
30_34_ft_fg_pct | Float64 | Field goal percentage on shots from 30-34-f feet, as a decimal. |
35_39_ft_fgm | Float64 | Field goals made from 35-39 feet. |
35_39_ft_fga | Float64 | Field goals attempted from 35-39 feet. |
35_39_ft_fg_pct | Float64 | Field goal percentage on shots from 35-39-f feet, as a decimal. |
40+_ft_fgm | Float64 | Team field goals made from 40 feet and beyond, per the stats API's shot-location distance bands. |
40+_ft_fga | Float64 | Team field goals attempted from 40 feet and beyond, per the stats API's shot-location distance bands. |
40+_ft_fg_pct | Float64 | Team field-goal percentage on attempts from 40 feet and beyond, as a decimal. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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
| 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 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. | ||
SeasonSegment | season_segment_nullable | Y | |||
SeasonType | season_type_all_star | Y | Season 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. | ||
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 | Int64 | |
team_name | String | |
gp | Int64 | |
w | Int64 | |
l | Int64 | |
w_pct | Float64 | |
min | Float64 | |
fgm | Float64 | |
fga | Float64 | |
fg_pct | Float64 | |
fg3_m | Float64 | Three-point field goals made. |
fg3_a | Float64 | Three-point field goal attempts. |
fg3_pct | Float64 | |
ftm | Float64 | |
fta | Float64 | |
ft_pct | Float64 | |
oreb | Float64 | |
dreb | Float64 | |
reb | Float64 | |
ast | Float64 | |
tov | Float64 | |
stl | Float64 | |
blk | Float64 | |
blka | Float64 | Blocked field-goal attempts against for the requested NBA or WNBA Stats split. |
pf | Float64 | |
pfd | Float64 | Personal fouls drawn for the requested NBA or WNBA Stats split. |
pts | Float64 | |
plus_minus | Float64 | |
gp_rank | Int64 | Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
w_rank | Int64 | Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
l_rank | Int64 | Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
w_pct_rank | Int64 | Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
min_rank | Int64 | Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fgm_rank | Int64 | Rank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fga_rank | Int64 | Rank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fg_pct_rank | Int64 | Rank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fg3_m_rank | Int64 | Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fg3_a_rank | Int64 | 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 | Int64 | Rank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
ftm_rank | Int64 | Rank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
fta_rank | Int64 | Rank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
ft_pct_rank | Int64 | Rank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
oreb_rank | Int64 | Rank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
dreb_rank | Int64 | Rank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
reb_rank | Int64 | Rank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
ast_rank | Int64 | Rank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
tov_rank | Int64 | Rank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
stl_rank | Int64 | Rank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
blk_rank | Int64 | Rank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
blka_rank | Int64 | Rank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
pf_rank | Int64 | Rank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
pfd_rank | Int64 | Rank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
pts_rank | Int64 | Rank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader. |
plus_minus_rank | Int64 | 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.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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. |
ImportError | curl_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')