WNBA — WNBA Stats API (stats.wnba.com) — League

wnba_stats_leaguegamefinder

GET /stats/leaguegamefinder

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

Valid URL: https://stats.wnba.com/stats/leaguegamefinder?Conference=&DateFrom=&DateTo=&Division=&DraftNumber=&DraftRound=&DraftTeamID=0&DraftYear=&EqAST=&EqBLK=&EqDD=&EqDREB=&EqFG3A=&EqFG3M=&EqFG3_PCT=&EqFGA=&EqFGM=&EqFG_PCT=&EqFTA=&EqFTM=&EqFT_PCT=&EqMINUTES=&EqOREB=&EqPF=&EqPTS=&EqREB=&EqSTL=&EqTD=&EqTOV=&GameID=&GtAST=&GtBLK=&GtDD=&GtDREB=&GtFG3A=&GtFG3M=&GtFG3_PCT=&GtFGA=&GtFGM=&GtFG_PCT=&GtFTA=&GtFTM=&GtFT_PCT=&GtMINUTES=&GtOREB=&GtPF=&GtPTS=&GtREB=&GtSTL=&GtTD=&GtTOV=&LeagueID=10&Location=&LtAST=&LtBLK=&LtDD=&LtDREB=&LtFG3A=&LtFG3M=&LtFG3_PCT=&LtFGA=&LtFGM=&LtFG_PCT=&LtFTA=&LtFTM=&LtFT_PCT=&LtMINUTES=&LtOREB=&LtPF=&LtPTS=&LtREB=&LtSTL=&LtTD=&LtTOV=&Outcome=&PORound=&PlayerID=&PlayerOrTeam=T&RookieYear=&Season=2024&SeasonSegment=&SeasonType=Regular+Season&StarterBench=&TeamID=0&VsConference=&VsDivision=&VsTeamID=0&YearsExperience=

API Parameter	Python	Pattern	Required	Nullable	Description
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
DraftNumber	draft_number_nullable			Y
DraftRound	draft_round_nullable			Y
DraftTeamID	draft_team_id_nullable			Y
DraftYear	draft_year_nullable			Y
EqAST	eq_ast_nullable			Y
EqBLK	eq_blk_nullable			Y
EqDD	eq_dd_nullable			Y
EqDREB	eq_dreb_nullable			Y
EqFG3A	eq_fg3a_nullable			Y
EqFG3M	eq_fg3m_nullable			Y
EqFG3_PCT	eq_fg3_pct_nullable			Y
EqFGA	eq_fga_nullable			Y
EqFGM	eq_fgm_nullable			Y
EqFG_PCT	eq_fg_pct_nullable			Y
EqFTA	eq_fta_nullable			Y
EqFTM	eq_ftm_nullable			Y
EqFT_PCT	eq_ft_pct_nullable			Y
EqMINUTES	eq_minutes_nullable			Y
EqOREB	eq_oreb_nullable			Y
EqPF	eq_pf_nullable			Y
EqPTS	eq_pts_nullable			Y
EqREB	eq_reb_nullable			Y
EqSTL	eq_stl_nullable			Y
EqTD	eq_td_nullable			Y
EqTOV	eq_tov_nullable			Y
GameID	game_id_nullable			Y
GtAST	gt_ast_nullable			Y
GtBLK	gt_blk_nullable			Y
GtDD	gt_dd_nullable			Y
GtDREB	gt_dreb_nullable			Y
GtFG3A	gt_fg3a_nullable			Y
GtFG3M	gt_fg3m_nullable			Y
GtFG3_PCT	gt_fg3_pct_nullable			Y
GtFGA	gt_fga_nullable			Y
GtFGM	gt_fgm_nullable			Y
GtFG_PCT	gt_fg_pct_nullable			Y
GtFTA	gt_fta_nullable			Y
GtFTM	gt_ftm_nullable			Y
GtFT_PCT	gt_ft_pct_nullable			Y
GtMINUTES	gt_minutes_nullable			Y
GtOREB	gt_oreb_nullable			Y
GtPF	gt_pf_nullable			Y
GtPTS	gt_pts_nullable			Y
GtREB	gt_reb_nullable			Y
GtSTL	gt_stl_nullable			Y
GtTD	gt_td_nullable			Y
GtTOV	gt_tov_nullable			Y
LeagueID	league_id			Y
Location	location_nullable			Y
LtAST	lt_ast_nullable			Y
LtBLK	lt_blk_nullable			Y
LtDD	lt_dd_nullable			Y
LtDREB	lt_dreb_nullable			Y
LtFG3A	lt_fg3a_nullable			Y
LtFG3M	lt_fg3m_nullable			Y
LtFG3_PCT	lt_fg3_pct_nullable			Y
LtFGA	lt_fga_nullable			Y
LtFGM	lt_fgm_nullable			Y
LtFG_PCT	lt_fg_pct_nullable			Y
LtFTA	lt_fta_nullable			Y
LtFTM	lt_ftm_nullable			Y
LtFT_PCT	lt_ft_pct_nullable			Y
LtMINUTES	lt_minutes_nullable			Y
LtOREB	lt_oreb_nullable			Y
LtPF	lt_pf_nullable			Y
LtPTS	lt_pts_nullable			Y
LtREB	lt_reb_nullable			Y
LtSTL	lt_stl_nullable			Y
LtTD	lt_td_nullable			Y
LtTOV	lt_tov_nullable			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PlayerID	player_id_nullable			Y
PlayerOrTeam	player_or_team_abbreviation			Y
RookieYear	rookie_year_nullable			Y
Season	season_nullable			Y	Season year, e.g. 2024. 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 WNBA season tips off in mid-May and becomes the default in June (2025 through May 2026, 2026 from June 2026); a draft (drafthistory, mid-April) in May. With season type Playoffs (or commonplayoffseries) the WNBA rolls over in October, after its mid-September playoffs start; with All Star in August, after the July game. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.wnba.com answers an empty HTTP 500 or every season summed.
SeasonSegment	season_segment_nullable			Y
SeasonType	season_type_nullable			Y	Season type, a label: Regular Season, Pre Season, Playoffs or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in October, All Star in August.
StarterBench	starter_bench_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y
VsTeamID	vs_team_id_nullable			Y
YearsExperience	years_experience_nullable			Y

Returns

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

col_name	type	description
season_id	character	Unique season identifier.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
game_id	character	Unique game identifier.
game_date	character	Game date (YYYY-MM-DD).
matchup	character	Matchup.
wl	character	Wl.
min	integer	Minutes played.
pts	integer	Points scored.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	integer	Three-point field goals made.
fg3_a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Total rebounds.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
plus_minus	numeric	Plus/minus point differential while on court.

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

Example

wnba_stats_leaguegamefinder(league_id='10', season_nullable='2024')

Last validated n/a.

wnba_stats_leaguegamelog

GET /stats/leaguegamelog

Endpoint URL: GET https://stats.wnba.com/stats/leaguegamelog

Valid URL: https://stats.wnba.com/stats/leaguegamelog?Counter=0&DateFrom=&DateTo=&Direction=ASC&LeagueID=10&PlayerOrTeam=T&Season=2024&SeasonType=Regular+Season&Sorter=DATE

API Parameter	Python	Pattern	Required	Nullable	Description
Counter	counter			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Direction	direction			Y
LeagueID	league_id			Y
PlayerOrTeam	player_or_team_abbreviation			Y
Season	season			Y	Season year, e.g. 2024. 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 WNBA season tips off in mid-May and becomes the default in June (2025 through May 2026, 2026 from June 2026); a draft (drafthistory, mid-April) in May. With season type Playoffs (or commonplayoffseries) the WNBA rolls over in October, after its mid-September playoffs start; with All Star in August, after the July game. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.wnba.com answers an empty HTTP 500 or every season summed.
SeasonType	season_type_all_star			Y	Season type, a label: Regular Season, Pre Season, Playoffs or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in October, All Star in August.
Sorter	sorter			Y

Returns

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

col_name	type	description
season_id	character	Unique season identifier.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
game_id	character	Unique game identifier.
game_date	character	Game date (YYYY-MM-DD).
matchup	character	Matchup.
wl	character	Wl.
min	integer	Minutes played.
fgm	integer	Field goals made.
fga	integer	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	integer	Three-point field goals made.
fg3_a	integer	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	integer	Free throws made.
fta	integer	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	integer	Offensive rebounds.
dreb	integer	Defensive rebounds.
reb	integer	Total rebounds.
ast	integer	Assists.
stl	integer	Steals.
blk	integer	Blocks.
tov	integer	Turnovers.
pf	integer	Personal fouls.
pts	integer	Points scored.
plus_minus	integer	Plus/minus point differential while on court.
video_available	integer	Video available.

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

Example

wnba_stats_leaguegamelog(league_id='10', season='2024')

Last validated n/a.

wnba_stats_leagueleaders

GET /stats/leagueleaders

Endpoint URL: GET https://stats.wnba.com/stats/leagueleaders

Valid URL: https://stats.wnba.com/stats/leagueleaders?ActiveFlag=&LeagueID=10&PerMode=Totals&Scope=S&Season=2024&SeasonType=Regular+Season&StatCategory=PTS

API Parameter	Python	Pattern	Required	Nullable	Description
ActiveFlag	active_flag_nullable			Y
LeagueID	league_id			Y
PerMode	per_mode48			Y
Scope	scope			Y
Season	season			Y	Season year, e.g. 2024. 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 WNBA season tips off in mid-May and becomes the default in June (2025 through May 2026, 2026 from June 2026); a draft (drafthistory, mid-April) in May. With season type Playoffs (or commonplayoffseries) the WNBA rolls over in October, after its mid-September playoffs start; with All Star in August, after the July game. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.wnba.com answers an empty HTTP 500 or every season summed.
SeasonType	season_type_all_star			Y	Season type, a label: Regular Season, Pre Season, Playoffs or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in October, All Star in August.
StatCategory	stat_category_abbreviation			Y

Returns

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

col_name	type	description
player_id	integer	Unique player identifier.
rank	integer	Rank of the row within the returned leaderboard (1 = best) for the stat the endpoint sorts by.
player	character	Player name.
team_id	integer	Unique team identifier.
team	character	Team-side label or team identifier.
gp	integer	Games played.
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Total rebounds.
ast	numeric	Assists.
stl	numeric	Steals.
blk	numeric	Blocks.
tov	numeric	Turnovers.
pts	numeric	Points scored.
eff	numeric	Eff.

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

Example

wnba_stats_leagueleaders(league_id='10', season='2024')

Last validated n/a.

wnba_stats_leaguelineupviz

GET /stats/leaguelineupviz

Endpoint URL: GET https://stats.wnba.com/stats/leaguelineupviz

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

API Parameter	Python	Pattern	Required	Nullable	Description
Conference	conference_nullable			Y
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
Division	division_simple_nullable			Y
GameSegment	game_segment_nullable			Y
GroupQuantity	group_quantity			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed_defense			Y
MinutesMin	minutes_min			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PORound	po_round_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year, e.g. 2024. 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 WNBA season tips off in mid-May and becomes the default in June (2025 through May 2026, 2026 from June 2026); a draft (drafthistory, mid-April) in May. With season type Playoffs (or commonplayoffseries) the WNBA rolls over in October, after its mid-September playoffs start; with All Star in August, after the July game. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.wnba.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, Playoffs or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in October, All Star in August.
ShotClockRange	shot_clock_range_nullable			Y
TeamID	team_id_nullable			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y

Returns

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

col_name	type	description
group_id	character	ESPN group id.
group_name	character	The lineup's five players as a ' - ' separated string of abbreviated names.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
min	numeric	Minutes played.
off_rating	numeric	Points scored per 100 possessions with the lineup on the floor (offensive rating).
def_rating	numeric	Points allowed per 100 possessions with the lineup on the floor (defensive rating).
net_rating	numeric	Net rating (off rating - def rating).
pace	numeric	Possessions per 48 minutes.
ts_pct	numeric	True shooting percentage (0-1).
fta_rate	numeric	Free throw attempts per field goal attempt for the lineup.
tm_ast_pct	numeric	Percentage of the lineup's made field goals that were assisted, as a decimal.
pct_fga_2_pt	numeric	Share of field goal attempts taken as two-pointers, as a decimal.
pct_fga_3_pt	numeric	Share of field goal attempts taken as three-pointers, as a decimal.
pct_pts_2_pt_mr	numeric	Share of points scored on mid-range two-pointers, as a decimal.
pct_pts_fb	numeric	Share of points scored on fast breaks, as a decimal.
pct_pts_ft	numeric	Share of points scored at the free throw line, as a decimal.
pct_pts_paint	numeric	Share of points scored in the paint, as a decimal.
pct_ast_fgm	numeric	Percentage of made field goals that were assisted, as a decimal.
pct_uast_fgm	numeric	Percentage of made field goals that were unassisted, as a decimal.
opp_fg3_pct	numeric	Opponent three-point percentage against the lineup, as a decimal.
opp_efg_pct	numeric	Opponent effective field goal percentage against the lineup, as a decimal.
opp_fta_rate	numeric	Opponent free throw attempt rate against the lineup.
opp_tov_pct	numeric	Opponent turnover percentage forced by the lineup.
sum_tm_min	numeric	Total team minutes summed across the lineup's stints on the floor.

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

Example

wnba_stats_leaguelineupviz(league_id='10', season='2024')

Last validated n/a.

wnba_stats_leagueplayerondetails

GET /stats/leagueplayerondetails

Endpoint URL: GET https://stats.wnba.com/stats/leagueplayerondetails

Valid URL: https://stats.wnba.com/stats/leagueplayerondetails?DateFrom=&DateTo=&GameSegment=&LastNGames=0&LeagueID=10&Location=&MeasureType=Base&Month=0&OpponentTeamID=0&Outcome=&PaceAdjust=N&PerMode=Totals&Period=0&PlusMinus=N&Rank=N&Season=2024&SeasonSegment=&SeasonType=Regular+Season&TeamID=1611661313&VsConference=&VsDivision=

API Parameter	Python	Pattern	Required	Nullable	Description
DateFrom	date_from_nullable			Y
DateTo	date_to_nullable			Y
GameSegment	game_segment_nullable			Y
LastNGames	last_n_games			Y
LeagueID	league_id			Y
Location	location_nullable			Y
MeasureType	measure_type_detailed_defense			Y
Month	month			Y
OpponentTeamID	opponent_team_id			Y
Outcome	outcome_nullable			Y
PaceAdjust	pace_adjust			Y
PerMode	per_mode_detailed			Y
Period	period			Y
PlusMinus	plus_minus			Y
Rank	rank			Y
Season	season			Y	Season year, e.g. 2024. 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 WNBA season tips off in mid-May and becomes the default in June (2025 through May 2026, 2026 from June 2026); a draft (drafthistory, mid-April) in May. With season type Playoffs (or commonplayoffseries) the WNBA rolls over in October, after its mid-September playoffs start; with All Star in August, after the July game. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.wnba.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, Playoffs or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in October, All Star in August.
TeamID	team_id			Y
VsConference	vs_conference_nullable			Y
VsDivision	vs_division_nullable			Y

Returns

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

col_name	type	description
group_set	character	Name of the grouping family used for this dashboard or split row.
team_id	integer	Unique team identifier.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
vs_player_id	integer	Stats API identifier for vs player identifier associated with this NBA or WNBA Stats row.
vs_player_name	character	Display name for vs player name associated with this NBA or WNBA Stats row.
court_status	character	Indicates whether the compared player was on court or off court for the split row.
gp	integer	Games played.
w	integer	Wins.
l	integer	Losses.
w_pct	numeric	Wins percentage (0-1 decimal).
min	numeric	Minutes played.
fgm	numeric	Field goals made.
fga	numeric	Field goal attempts.
fg_pct	numeric	Field goal percentage (0-1).
fg3_m	numeric	Three-point field goals made.
fg3_a	numeric	Three-point field goal attempts.
fg3_pct	numeric	Three-point field goal percentage (0-1).
ftm	numeric	Free throws made.
fta	numeric	Free throw attempts.
ft_pct	numeric	Free throw percentage (0-1).
oreb	numeric	Offensive rebounds.
dreb	numeric	Defensive rebounds.
reb	numeric	Total rebounds.
ast	numeric	Assists.
tov	numeric	Turnovers.
stl	numeric	Steals.
blk	numeric	Blocks.
blka	numeric	Blocked field-goal attempts against for the requested NBA or WNBA Stats split.
pf	numeric	Personal fouls.
pfd	numeric	Personal fouls drawn for the requested NBA or WNBA Stats split.
pts	numeric	Points scored.
plus_minus	numeric	Plus/minus point differential while on court.
gp_rank	integer	Rank for games played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_rank	integer	Rank for wins within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
l_rank	integer	Rank for losses within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
w_pct_rank	integer	Rank for winning percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
min_rank	integer	Rank for minutes played within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fgm_rank	integer	Rank for field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fga_rank	integer	Rank for field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg_pct_rank	integer	Rank for field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_m_rank	integer	Rank for three-point field goals made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_a_rank	integer	Rank for three-point field goals attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fg3_pct_rank	integer	Rank for three-point field-goal percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ftm_rank	integer	Rank for free throws made within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
fta_rank	integer	Rank for free throws attempted within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ft_pct_rank	integer	Rank for free-throw percentage within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
oreb_rank	integer	Rank for offensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
dreb_rank	integer	Rank for defensive rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
reb_rank	integer	Rank for total rebounds within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
ast_rank	integer	Rank for assists within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
tov_rank	integer	Rank for turnovers within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
stl_rank	integer	Rank for steals within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blk_rank	integer	Rank for blocks within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
blka_rank	integer	Rank for blocked field-goal attempts against within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pf_rank	integer	Rank for personal fouls within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pfd_rank	integer	Rank for personal fouls drawn within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
pts_rank	integer	Rank for points within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.
plus_minus_rank	integer	Rank for plus-minus within the requested NBA or WNBA Stats leaderboard or split, where 1 is the leader.

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

Example

wnba_stats_leagueplayerondetails(league_id='10', season='2024')

Last validated n/a.

wnba_stats_leagueseasonmatchups

GET /stats/leagueseasonmatchups

Endpoint URL: GET https://stats.wnba.com/stats/leagueseasonmatchups

Valid URL: https://stats.wnba.com/stats/leagueseasonmatchups?DefPlayerID=&DefTeamID=0&LeagueID=10&OffPlayerID=&OffTeamID=0&PerMode=Totals&Season=2024&SeasonType=Regular+Season

API Parameter	Python	Pattern	Required	Nullable	Description
DefPlayerID	def_player_id_nullable			Y
DefTeamID	def_team_id_nullable			Y
LeagueID	league_id			Y
OffPlayerID	off_player_id_nullable			Y
OffTeamID	off_team_id_nullable			Y
PerMode	per_mode_simple			Y
Season	season			Y	Season year, e.g. 2024. 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 WNBA season tips off in mid-May and becomes the default in June (2025 through May 2026, 2026 from June 2026); a draft (drafthistory, mid-April) in May. With season type Playoffs (or commonplayoffseries) the WNBA rolls over in October, after its mid-September playoffs start; with All Star in August, after the July game. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.wnba.com answers an empty HTTP 500 or every season summed.
SeasonType	season_type_playoffs			Y	Season type, a label: Regular Season, Pre Season, Playoffs or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in October, All Star in August.

Returns

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

col_name	type	description
season_id	character	Unique season identifier.
off_player_id	integer	Stats API identifier for offensive player identifier associated with this NBA or WNBA Stats row.
off_player_name	character	Display name for offensive player name associated with this NBA or WNBA Stats row.
def_player_id	integer	Stats API identifier for defensive player identifier associated with this NBA or WNBA Stats row.
def_player_name	character	Display name for defensive player name associated with this NBA or WNBA Stats row.
gp	integer	Games played.
matchup_min	numeric	NBA or WNBA Stats value for matchup minutes in the leagueseasonmatchups result set.
partial_poss	numeric	Estimated partial possessions credited to the stint or rotation interval.
player_pts	numeric	Scoring or score-margin metric for player points in the requested NBA or WNBA Stats split.
team_pts	numeric	Scoring or score-margin metric for team points in the requested NBA or WNBA Stats split.
matchup_ast	numeric	NBA or WNBA Stats value for matchup assists in the leagueseasonmatchups result set.
matchup_tov	numeric	Turnover or loose-ball metric for matchup turnovers in the requested NBA or WNBA Stats split.
matchup_blk	numeric	NBA or WNBA Stats value for matchup blocks in the leagueseasonmatchups result set.
matchup_fgm	numeric	Shooting metric for matchup fgm in the requested NBA or WNBA Stats split.
matchup_fga	numeric	Shooting metric for matchup fga in the requested NBA or WNBA Stats split.
matchup_fg_pct	numeric	Percentage or rate for matchup field goals percentage in the requested NBA or WNBA Stats split.
matchup_fg3_m	numeric	Shooting metric for matchup fg3m in the requested NBA or WNBA Stats split.
matchup_fg3_a	numeric	Shooting metric for matchup fg3a in the requested NBA or WNBA Stats split.
matchup_fg3_pct	numeric	Percentage or rate for matchup three-point field goals percentage in the requested NBA or WNBA Stats split.
help_blk	integer	NBA or WNBA Stats value for help blocks in the leagueseasonmatchups result set.
help_fgm	integer	Shooting metric for help fgm in the requested NBA or WNBA Stats split.
help_fga	integer	Shooting metric for help fga in the requested NBA or WNBA Stats split.
help_fg_perc	integer	Shooting metric for help field goals perc in the requested NBA or WNBA Stats split.
matchup_ftm	numeric	NBA or WNBA Stats value for matchup ftm in the leagueseasonmatchups result set.
matchup_fta	numeric	NBA or WNBA Stats value for matchup fta in the leagueseasonmatchups result set.
sfl	numeric	NBA or WNBA Stats value for sfl in the leagueseasonmatchups result set.

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

Example

wnba_stats_leagueseasonmatchups(league_id='10', season='2024')

Last validated n/a.

wnba_stats_leaguestandingsv3

GET /stats/leaguestandingsv3

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

Valid URL: https://stats.wnba.com/stats/leaguestandingsv3?LeagueID=10&Season=2024&SeasonType=Regular+Season&SeasonYear=

API Parameter	Python	Pattern	Required	Nullable	Description
LeagueID	league_id			Y
Season	season			Y	Season year, e.g. 2024. 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 WNBA season tips off in mid-May and becomes the default in June (2025 through May 2026, 2026 from June 2026); a draft (drafthistory, mid-April) in May. With season type Playoffs (or commonplayoffseries) the WNBA rolls over in October, after its mid-September playoffs start; with All Star in August, after the July game. A month table cannot follow a lockout or pandemic calendar: pass a season then. Without one stats.wnba.com answers an empty HTTP 500 or every season summed.
SeasonType	season_type			Y	Season type, a label: Regular Season, Pre Season, Playoffs or All Star (each endpoint takes a subset). Not ESPN's numeric code: 3 is HTTP 400. A default season follows it: Playoffs rolls over in October, All Star in August.
SeasonYear	season_nullable			Y

Returns

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

col_name	type	description
league_id	character	League identifier used in compact NBA Stats schedule and scoreboard result sets.
season_id	character	Stats API identifier for seasonid associated with this NBA or WNBA Stats row.
team_id	integer	Unique team identifier.
team_city	character	Team city or region (e.g. 'Las Vegas').
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_slug	character	URL slug for teamslug used by NBA or WNBA Stats pages.
conference	character	Filter players or teams by conference.
conference_record	character	NBA or WNBA Stats value for conferencerecord in the leaguestandingsv3 result set.
playoff_rank	integer	NBA or WNBA Stats value for playoffrank in the leaguestandingsv3 result set.
clinch_indicator	character	NBA or WNBA Stats value for clinchindicator in the leaguestandingsv3 result set.
division	character	Team division.
division_record	character	NBA or WNBA Stats value for divisionrecord in the leaguestandingsv3 result set.
division_rank	integer	NBA or WNBA Stats value for divisionrank in the leaguestandingsv3 result set.
wins	integer	Total wins.
losses	integer	Total losses.
win_pct	numeric	Winning percentage for the team or split represented by this row.
league_rank	integer	NBA or WNBA Stats value for leaguerank in the leaguestandingsv3 result set.
record	character	Record string (e.g. '12-4').
home	character	Home.
road	character	Road.
l10	character	L10.
last10_home	character	NBA or WNBA Stats value for last10home in the leaguestandingsv3 result set.
last10_road	character	NBA or WNBA Stats value for last10road in the leaguestandingsv3 result set.
ot	character	Ot.
three_pts_or_less	character	Scoring or score-margin metric for threeptsorless in the requested NBA or WNBA Stats split.
ten_pts_or_more	character	Scoring or score-margin metric for tenptsormore in the requested NBA or WNBA Stats split.
long_home_streak	integer	NBA or WNBA Stats value for longhomestreak in the leaguestandingsv3 result set.
str_long_home_streak	character	NBA or WNBA Stats value for strlonghomestreak in the leaguestandingsv3 result set.
long_road_streak	integer	NBA or WNBA Stats value for longroadstreak in the leaguestandingsv3 result set.
str_long_road_streak	character	NBA or WNBA Stats value for strlongroadstreak in the leaguestandingsv3 result set.
long_win_streak	integer	NBA or WNBA Stats value for longwinstreak in the leaguestandingsv3 result set.
long_loss_streak	integer	NBA or WNBA Stats value for longlossstreak in the leaguestandingsv3 result set.
current_home_streak	integer	NBA or WNBA Stats value for currenthomestreak in the leaguestandingsv3 result set.
str_current_home_streak	character	NBA or WNBA Stats value for strcurrenthomestreak in the leaguestandingsv3 result set.
current_road_streak	integer	NBA or WNBA Stats value for currentroadstreak in the leaguestandingsv3 result set.
str_current_road_streak	character	NBA or WNBA Stats value for strcurrentroadstreak in the leaguestandingsv3 result set.
current_streak	integer	NBA or WNBA Stats value for currentstreak in the leaguestandingsv3 result set.
str_current_streak	character
conference_games_back	numeric	NBA or WNBA Stats value for conferencegamesback in the leaguestandingsv3 result set.
division_games_back	numeric	NBA or WNBA Stats value for divisiongamesback in the leaguestandingsv3 result set.
clinched_conference_title	integer	Flag indicating clinchedconferencetitle for the requested NBA or WNBA Stats context.
clinched_division_title	integer	Flag indicating clincheddivisiontitle for the requested NBA or WNBA Stats context.
clinched_playoff_birth	integer	Flag indicating clinchedplayoffbirth for the requested NBA or WNBA Stats context.
clinched_play_in	integer	Flag indicating clinchedplayin for the requested NBA or WNBA Stats context.
eliminated_conference	integer	Flag indicating eliminatedconference for the requested NBA or WNBA Stats context.
eliminated_division	integer	Flag indicating eliminateddivision for the requested NBA or WNBA Stats context.
ahead_at_half	character	NBA or WNBA Stats value for aheadathalf in the leaguestandingsv3 result set.
behind_at_half	character	NBA or WNBA Stats value for behindathalf in the leaguestandingsv3 result set.
tied_at_half	character	NBA or WNBA Stats value for tiedathalf in the leaguestandingsv3 result set.
ahead_at_third	character	NBA or WNBA Stats value for aheadatthird in the leaguestandingsv3 result set.
behind_at_third	character	NBA or WNBA Stats value for behindatthird in the leaguestandingsv3 result set.
tied_at_third	character	NBA or WNBA Stats value for tiedatthird in the leaguestandingsv3 result set.
score100_pts	character	Scoring or score-margin metric for score100pts in the requested NBA or WNBA Stats split.
opp_score100_pts	character	Scoring or score-margin metric for oppscore100pts in the requested NBA or WNBA Stats split.
opp_over500	character	NBA or WNBA Stats value for oppover500 in the leaguestandingsv3 result set.
lead_in_fgpct	character	Shooting metric for leadinfgpct in the requested NBA or WNBA Stats split.
lead_in_reb	character	Rebounding metric for leadinreb in the requested NBA or WNBA Stats split.
fewer_turnovers	character	Turnover or loose-ball metric for fewerturnovers in the requested NBA or WNBA Stats split.
points_pg	numeric	Scoring or score-margin metric for pointspg in the requested NBA or WNBA Stats split.
opp_points_pg	numeric	Scoring or score-margin metric for opppointspg in the requested NBA or WNBA Stats split.
diff_points_pg	numeric	Scoring or score-margin metric for diffpointspg in the requested NBA or WNBA Stats split.
vs_east	character	NBA or WNBA Stats value for vseast in the leaguestandingsv3 result set.
vs_atlantic	character	NBA or WNBA Stats value for vsatlantic in the leaguestandingsv3 result set.
vs_central	character	NBA or WNBA Stats value for vscentral in the leaguestandingsv3 result set.
vs_southeast	character	NBA or WNBA Stats value for vssoutheast in the leaguestandingsv3 result set.
vs_west	character	NBA or WNBA Stats value for vswest in the leaguestandingsv3 result set.
vs_northwest	character	NBA or WNBA Stats value for vsnorthwest in the leaguestandingsv3 result set.
vs_pacific	character	NBA or WNBA Stats value for vspacific in the leaguestandingsv3 result set.
vs_southwest	character	NBA or WNBA Stats value for vssouthwest in the leaguestandingsv3 result set.
jan	character	Value for January in the endpoint's monthly NBA or WNBA Stats split.
feb	character	Value for February in the endpoint's monthly NBA or WNBA Stats split.
mar	character	Value for March in the endpoint's monthly NBA or WNBA Stats split.
apr	character	Value for April in the endpoint's monthly NBA or WNBA Stats split.
may	character	Value for May in the endpoint's monthly NBA or WNBA Stats split.
jun	character	Value for June in the endpoint's monthly NBA or WNBA Stats split.
jul	character	Value for July in the endpoint's monthly NBA or WNBA Stats split.
aug	character	Value for August in the endpoint's monthly NBA or WNBA Stats split.
sep	character	Value for September in the endpoint's monthly NBA or WNBA Stats split.
oct	character	Value for October in the endpoint's monthly NBA or WNBA Stats split.
nov	character	Value for November in the endpoint's monthly NBA or WNBA Stats split.
dec	character	Value for December in the endpoint's monthly NBA or WNBA Stats split.
score_80_plus	character	Scoring or score-margin metric for score 80 plus in the requested NBA or WNBA Stats split.
opp_score_80_plus	character	Opponent score 80 plus for the requested NBA or WNBA team, player, lineup, or game split.
score_below_80	character	Scoring or score-margin metric for score below 80 in the requested NBA or WNBA Stats split.
opp_score_below_80	character	Opponent score below 80 for the requested NBA or WNBA team, player, lineup, or game split.
total_points	integer	Scoring or score-margin metric for totalpoints in the requested NBA or WNBA Stats split.
opp_total_points	integer	Scoring or score-margin metric for opptotalpoints in the requested NBA or WNBA Stats split.
diff_total_points	integer	Scoring or score-margin metric for difftotalpoints in the requested NBA or WNBA Stats split.
league_games_back	numeric	NBA or WNBA Stats value for leaguegamesback in the leaguestandingsv3 result set.
playoff_seeding	integer	NBA or WNBA Stats value for playoffseeding in the leaguestandingsv3 result set.
clinched_post_season	integer	Flag indicating clinchedpostseason for the requested NBA or WNBA Stats context.
neutral	character	Neutral.

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

Example

wnba_stats_leaguestandingsv3(league_id='10', season='2024')

Last validated n/a.