Skip to main content

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

nbagl_stats_teamplayerdashboard​

Team player dashboard.

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

Valid URL: https://stats.nba.com/stats/teamplayerdashboard?DateFrom=&DateTo=&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=&TeamID=1612709914&VsConference=&VsDivision=

API ParameterPythonPatternRequiredNullableDescription
DateFromdate_from_nullableY
DateTodate_to_nullableY
GameSegmentgame_segment_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
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_idY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

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

TeamOverall

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
team_idInt64
team_nameString
group_valueString
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.

PlayersSeasonTotals

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
player_idInt64
player_nameString
nicknameString
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
nba_fantasy_ptsFloat64Nba fantasy points for the requested NBA or WNBA Stats split.
dd2Int64Double-doubles for the requested NBA or WNBA Stats split.
td3Int64Triple-doubles for the requested NBA or WNBA Stats split.
wnba_fantasy_ptsFloat64Wnba fantasy points for the requested NBA or WNBA Stats split.
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.
nba_fantasy_pts_rankInt64Rank for NBA fantasy points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dd2_rankInt64Rank for double-doubles within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
td3_rankInt64Rank for triple-doubles within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
wnba_fantasy_pts_rankInt64Rank for WNBA fantasy points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
team_countInt64NBA or WNBA Stats value for team count in the teamplayerdashboard 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_teamplayerdashboard(league_id='20', season='2024-25')

nbagl_stats_teamplayeronoffdetails​

Team player on off details.

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

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

API ParameterPythonPatternRequiredNullableDescription
DateFromdate_from_nullableY
DateTodate_to_nullableY
GameSegmentgame_segment_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. 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.
TeamIDteam_idY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

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

OverallTeamPlayerOnOffDetails

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
group_valueString
team_idInt64
team_abbreviationString
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.

PlayersOnCourtTeamPlayerOnOffDetails

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
team_idString
team_abbreviationString
team_nameString
vs_player_idStringStats API identifier for vs player identifier associated with this NBA or WNBA Stats row.
vs_player_nameStringDisplay name for vs player name associated with this NBA or WNBA Stats row.
court_statusStringIndicates whether the compared player was on court or off court for the split row.
gpString
wString
lString
w_pctString
minString
fgmString
fgaString
fg_pctString
fg3_mStringThree-point field goals made.
fg3_aStringThree-point field goal attempts.
fg3_pctString
ftmString
ftaString
ft_pctString
orebString
drebString
rebString
astString
tovString
stlString
blkString
blkaStringBlocked field-goal attempts against for the requested NBA or WNBA Stats split.
pfString
pfdStringPersonal fouls drawn for the requested NBA or WNBA Stats split.
ptsString
plus_minusString
gp_rankStringRank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rankStringRank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rankStringRank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rankStringRank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rankStringRank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rankStringRank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rankStringRank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rankStringRank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_m_rankStringRank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_a_rankStringRank for three-point field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_pct_rankStringRank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rankStringRank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rankStringRank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rankStringRank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rankStringRank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rankStringRank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rankStringRank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rankStringRank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rankStringRank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rankStringRank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rankStringRank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rankStringRank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rankStringRank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rankStringRank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rankStringRank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rankStringRank for plus-minus within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.

PlayersOffCourtTeamPlayerOnOffDetails

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
team_idString
team_abbreviationString
team_nameString
vs_player_idStringStats API identifier for vs player identifier associated with this NBA or WNBA Stats row.
vs_player_nameStringDisplay name for vs player name associated with this NBA or WNBA Stats row.
court_statusStringIndicates whether the compared player was on court or off court for the split row.
gpString
wString
lString
w_pctString
minString
fgmString
fgaString
fg_pctString
fg3_mStringThree-point field goals made.
fg3_aStringThree-point field goal attempts.
fg3_pctString
ftmString
ftaString
ft_pctString
orebString
drebString
rebString
astString
tovString
stlString
blkString
blkaStringBlocked field-goal attempts against for the requested NBA or WNBA Stats split.
pfString
pfdStringPersonal fouls drawn for the requested NBA or WNBA Stats split.
ptsString
plus_minusString
gp_rankStringRank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rankStringRank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rankStringRank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rankStringRank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rankStringRank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rankStringRank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rankStringRank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rankStringRank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_m_rankStringRank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_a_rankStringRank for three-point field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_pct_rankStringRank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rankStringRank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rankStringRank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rankStringRank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rankStringRank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rankStringRank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rankStringRank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rankStringRank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rankStringRank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rankStringRank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rankStringRank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rankStringRank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rankStringRank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rankStringRank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rankStringRank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rankStringRank 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_teamplayeronoffdetails(league_id='20', season='2024-25')

nbagl_stats_teamplayeronoffsummary​

Team player on off summary.

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

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

API ParameterPythonPatternRequiredNullableDescription
DateFromdate_from_nullableY
DateTodate_to_nullableY
GameSegmentgame_segment_nullableY
LastNGameslast_n_gamesY
LeagueIDleague_idY
Locationlocation_nullableY
MeasureTypemeasure_type_detailed_defenseY
MonthmonthY
OpponentTeamIDopponent_team_idY
Outcomeoutcome_nullableY
PaceAdjustpace_adjustY
PerModeper_mode_detailedY
PeriodperiodY
PlusMinusplus_minusY
RankrankY
SeasonseasonYSeason label, e.g. 2024-25. Defaults at call time by a calendar cutoff, the month after a season's first games, so it can lag the newest rows by a few weeks. 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.
TeamIDteam_idY
VsConferencevs_conference_nullableY
VsDivisionvs_division_nullableY

Returns​

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

OverallTeamPlayerOnOffSummary

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
group_valueStringSpecific grouping value for this dashboard or split row.
team_idInt64
team_abbreviationString
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.

PlayersOnCourtTeamPlayerOnOffSummary

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
team_idString
team_abbreviationString
team_nameString
vs_player_idString
vs_player_nameString
court_statusString
gpString
minString
plus_minusString
off_ratingStringOffensive rating (points produced per 100 possessions).
def_ratingStringDefensive rating (points allowed per 100 possessions).
net_ratingString

PlayersOffCourtTeamPlayerOnOffSummary

col_nametypedescription
group_setStringName of the grouping family used for this dashboard or split row.
team_idString
team_abbreviationString
team_nameString
vs_player_idString
vs_player_nameString
court_statusString
gpString
minString
plus_minusString
off_ratingStringOffensive rating (points produced per 100 possessions).
def_ratingStringDefensive rating (points allowed per 100 possessions).
net_ratingString

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_teamplayeronoffsummary(league_id='20', season='2024-25')