Skip to main content

WNBA — additional Python functions — Fox

fox_wnba_boxscore​

fox_wnba_boxscore(game_id: 'Union[int, str]', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA boxscore (long: one row per player-stat).

Parameters

ParameterTypeDefaultDescription
game_idUnion[int, str]Fox Bifrost event id.
return_parsedboolTrueIf True (default) flatten the per-team stat tables to long form; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_boxscore
df = fox_wnba_boxscore("2278")

fox_wnba_event_matchup​

fox_wnba_event_matchup(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba pregame team-stat comparison (one row per stat).

Wraps wnba/event/{game_id}/matchup.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_event_matchup
df = fox_wnba_event_matchup("...")

fox_wnba_event_recap​

fox_wnba_event_recap(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba postgame top performers (one row per player).

Wraps wnba/event/{game_id}/recap.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_event_recap
df = fox_wnba_event_recap("...")

fox_wnba_event_standings​

fox_wnba_event_standings(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba the two teams' standings context.

Wraps wnba/event/{game_id}/standings.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_event_standings
df = fox_wnba_event_standings("...")

fox_wnba_league_conferences​

fox_wnba_league_conferences(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba conference / group directory.

Wraps wnba/league/conferences.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_league_conferences
df = fox_wnba_league_conferences()

fox_wnba_league_header​

fox_wnba_league_header(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba league header (one row).

Wraps wnba/league/header.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
templatecharacterFox layout template name for the header block; always 'entity-header' in sampled data.
titlecharacterTitle or label for the record.
entity_idcharacterFox id of the league entity as a string: the trailing number of the league's Fox contentUri.
content_uricharacterFox Bifrost content URI of the league entity ('basketball/wnba/league/1' in sampled data).
content_typecharacterFox entity type of the header's entity; always 'league' in sampled data.
colorcharacterPrimary color (hex without leading '#').
logo_urlcharacterNBA CDN primary logo URL.
image_alt_textcharacterAlt text Fox attaches to the header image, which reads as the league's full name.
rankcharacterWhether to include statistical ranks in the returned table.
detailscharacterDetails.

Example

from sportsdataverse.wnba import fox_wnba_league_header
df = fox_wnba_league_header()

fox_wnba_league_leaders​

fox_wnba_league_leaders(category: 'str' = 'scoring', who: 'str' = 'player', page: 'int' = 0, *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA statistical leaders (stats-con); who=player|team.

Parameters

ParameterTypeDefaultDescription
categorystr'scoring'Stat category. Defaults to "scoring".
whostr'player'"player" or "team". Defaults to "player".
pageint00-based result page. Defaults to 0.
return_parsedboolTrueIf True (default) flatten the leader tables to a DataFrame; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
playerscharacterNested list of per-player box scores.
v1characterLeader's name as Fox abbreviates it, first initial plus surname ('F. Lastname'); the column is named v1 because its table header cell is blank.
gpcharacterGames played.
entity_idcharacterFox id of the row's linked player or team as a string: the trailing number of the row's entityLink contentUri.
mincharacterMinutes played.
mpgcharacterMinutes per game.

Example

from sportsdataverse.wnba import fox_wnba_league_leaders
df = fox_wnba_league_leaders("scoring")

fox_wnba_league_odds​

fox_wnba_league_odds(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba league odds board (one row per team per game).

Wraps wnba/league/odds.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
sectioncharacterTitle of the Fox odds-board section the game is listed under; always 'GAMES' in sampled data.
game_idcharacterUnique game identifier.
event_timecharacterScheduled start of the game as an ISO-8601 UTC timestamp string (e.g. '2026-09-17T23:30:00Z').
event_statusintegerFox numeric event-status code for the game (Int64); always 2 in the sampled board, where every game was still to be played at capture.
teamcharacterTeam-side label or team identifier.
spreadcharacterSpread.
to_wincharacterMoneyline for the team on this row as an American-odds string with explicit sign (e.g. '+884', '-126').
totalcharacterTotal.

Example

from sportsdataverse.wnba import fox_wnba_league_odds
df = fox_wnba_league_odds()

fox_wnba_league_player_news​

fox_wnba_league_player_news(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba league-wide player news feed.

Wraps wnba/league/playernews.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
titlecharacterTitle or label for the record.
subtitlecharacterPlayer tag line shaped ' # - ' (e.g. 'PHX #2 - G/F').
headlinecharacterNews headline.
descriptioncharacterLong-form description text.
impact_titlecharacterHeading label Fox shows above the impact note; always 'Impact' in sampled data.
impactcharacterFox's free-text impact note for the item, describing the player's availability or outlook (e.g. games missed with an injury and the next chance to play).
datecharacterDate in YYYY-MM-DD format.
sourcecharacterNews source.
athlete_idcharacterUnique athlete identifier (ESPN).
content_uricharacterFox Bifrost content URI of the athlete the item is about, shaped 'basketball/wnba/athletes/<athlete_id>'.
web_urlcharacterSite-relative foxsports.com path of the player's page (e.g. '/wnba/kahleah-copper-player').

Example

from sportsdataverse.wnba import fox_wnba_league_player_news
df = fox_wnba_league_player_news()

fox_wnba_league_polls​

fox_wnba_league_polls(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba rankings / polls rendered as standings tables.

Wraps wnba/league/polls.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_league_polls
df = fox_wnba_league_polls()

fox_wnba_league_schedule​

fox_wnba_league_schedule(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba league schedule nav selections.

Wraps wnba/league/schedule.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
selection_listcharacterWhich Fox navigation list the row came from ('groupList', 'dailyList' or 'selectionList'); always 'dailyList', one row per game date, in sampled data.
idcharacterUnique play identification number
titlecharacterTitle or label for the record.
datecharacterDate in YYYY-MM-DD format.
uricharacterAbsolute api.foxsports.com Bifrost URL of that date's segment payload (.../wnba/league/schedule-segment/-YYYYMMDD).
web_urlcharacterSite-relative foxsports.com path of the page for that date (e.g. '/wnba/schedule?date=YYYY-MM-DD').
selectedcharacterFox's default-selection flag, which Fox sets only on group-filter (groupList) items; this league's navigation payload has no groupList, so the column is null on every row. The current date or week is marked by the payload-level currentSelectionId, which the parser does not return.
group_idcharacterESPN group id.

Example

from sportsdataverse.wnba import fox_wnba_league_schedule
df = fox_wnba_league_schedule()

fox_wnba_league_scores​

fox_wnba_league_scores(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba league scores nav selections.

Wraps wnba/league/scores.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
selection_listcharacterWhich Fox navigation list the row came from ('groupList', 'dailyList' or 'selectionList'); always 'dailyList', one row per game date, in sampled data.
idcharacterUnique play identification number
titlecharacterTitle or label for the record.
datecharacterDate in YYYY-MM-DD format.
uricharacterAbsolute api.foxsports.com Bifrost URL of that date's segment payload (.../wnba/league/scores-segment/YYYYMMDD).
web_urlcharacterSite-relative foxsports.com path of the page for that date (e.g. '/wnba/scores?date=YYYY-MM-DD').
selectedcharacterFox's default-selection flag, which Fox sets only on group-filter (groupList) items; this league's navigation payload has no groupList, so the column is null on every row. The current date or week is marked by the payload-level currentSelectionId, which the parser does not return.
group_idcharacterESPN group id.

Example

from sportsdataverse.wnba import fox_wnba_league_scores
df = fox_wnba_league_scores()

fox_wnba_league_standings​

fox_wnba_league_standings(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba league-wide standings tables.

Wraps wnba/league/standings.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
sectioncharacterTitle of the Fox standings section the row came from, such as 'CONFERENCE' or 'PRESEASON'; each team appears once per section. Values in sampled data: 'CONFERENCE', 'PRESEASON'.
easterncharacterTeam's position in the Eastern conference table, from the first column whose header is the table name; null on rows from other tables, as a number string ('1' to '7' in sampled data).
v1characterTeam nickname as Fox displays it (e.g. 'Liberty', 'Fever'); the column is named v1 because its table header cell is blank.
w_lcharacterW l.
pctcharacterWin percentage.
gbcharacterGames behind the conference leader.
pfcharacterPersonal fouls.
pacharacterPoints allowed per game as a one-decimal string (e.g. '86.0').
homecharacterHome.
awaycharacterAway record.
confcharactercharacter.
l10characterL10.
strkcharacterCurrent streak.
entity_idcharacterFox id of the row's linked team as a string: the trailing number of the row's entityLink contentUri.
westerncharacterTeam's position in the Western conference table, from the first column whose header is the table name; null on rows from other tables, as a number string ('1' to '8' in sampled data).

Example

from sportsdataverse.wnba import fox_wnba_league_standings
df = fox_wnba_league_standings()

fox_wnba_league_stat_leaders​

fox_wnba_league_stat_leaders(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba league stats landing leaders.

Wraps wnba/league/stats.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
categorycharacterCategory label.
statcharacterStat.
stat_abbreviationcharacterFox's short code for the leader stat, such as 'PPG', 'RPG', 'FG%', 'DBL DBL' or 'OFF RTG'; the spelled-out name is in stat.
playercharacterPlayer name.
valuecharacterNumeric or string value field.

Example

from sportsdataverse.wnba import fox_wnba_league_stat_leaders
df = fox_wnba_league_stat_leaders()

fox_wnba_odds​

fox_wnba_odds(game_id: 'Union[int, str]', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA game odds six-pack (spread / to-win / total per team).

Parameters

ParameterTypeDefaultDescription
game_idUnion[int, str]Fox Bifrost event id.
return_parsedboolTrueIf True (default) flatten the six-pack market to a DataFrame; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_odds
df = fox_wnba_odds("2278")

fox_wnba_pbp​

fox_wnba_pbp(game_id: 'Union[int, str]', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA play-by-play (one row per play; period-based).

Parameters

ParameterTypeDefaultDescription
game_idUnion[int, str]Fox Bifrost event id.
return_parsedboolTrueIf True (default) flatten the pbp layout to a DataFrame; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_pbp
df = fox_wnba_pbp("2278")

fox_wnba_scoreboard​

fox_wnba_scoreboard(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba scoreboard nav selections (weeks / dates / groups).

Wraps wnba/scoreboard/main.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
selection_listcharacterWhich Fox navigation list the row came from ('groupList', 'dailyList' or 'selectionList'); always 'dailyList', one row per game date, in sampled data.
idcharacterUnique play identification number
titlecharacterTitle or label for the record.
datecharacterDate in YYYY-MM-DD format.
uricharacterAbsolute api.foxsports.com Bifrost URL of that date's segment payload (.../wnba/scoreboard/segment/YYYYMMDD).
web_urlcharacterSite-relative foxsports.com path of the page for that date (e.g. '/scores/wnba?date=YYYY-MM-DD').
selectedcharacterFox's default-selection flag, which Fox sets only on group-filter (groupList) items; this league's navigation payload has no groupList, so the column is null on every row. The current date or week is marked by the payload-level currentSelectionId, which the parser does not return.
group_idcharacterESPN group id.

Example

from sportsdataverse.wnba import fox_wnba_scoreboard
df = fox_wnba_scoreboard()

fox_wnba_scorechip​

fox_wnba_scorechip(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba compact live score chip (raw dict -- live-only, uncaptured shape).

Wraps wnba/scorechip/{chip_id}.

Returns

The raw JSON dict.

Example

from sportsdataverse.wnba import fox_wnba_scorechip
df = fox_wnba_scorechip("nfl12345")

fox_wnba_scores_segment​

fox_wnba_scores_segment(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba one row per game in a scoreboard segment.

Wraps wnba/league/scores-segment/{segment_id}.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_scores_segment
df = fox_wnba_scores_segment("...")

fox_wnba_standings​

fox_wnba_standings(team_id: 'Union[int, str]', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA standings for a team's conference/division.

Parameters

ParameterTypeDefaultDescription
team_idUnion[int, str]Fox Bifrost team id.
return_parsedboolTrueIf True (default) flatten the standings tables to a DataFrame; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_standings
df = fox_wnba_standings("3")

fox_wnba_team_gamelog​

fox_wnba_team_gamelog(team_id: 'Union[int, str]', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA team game log (long: one row per game-stat).

Parameters

ParameterTypeDefaultDescription
team_idUnion[int, str]Fox Bifrost team id.
return_parsedboolTrueIf True (default) flatten to long form; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_team_gamelog
df = fox_wnba_team_gamelog("3")

fox_wnba_team_header​

fox_wnba_team_header(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba team header (one row).

Wraps wnba/team/{team_id}/header.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_team_header
df = fox_wnba_team_header("...")

fox_wnba_team_roster​

fox_wnba_team_roster(team_id: 'Union[int, str]', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA team roster (one row per player).

Parameters

ParameterTypeDefaultDescription
team_idUnion[int, str]Fox Bifrost team id.
return_parsedboolTrueIf True (default) flatten the roster tables to a DataFrame; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_team_roster
df = fox_wnba_team_roster("3")

fox_wnba_team_stats​

fox_wnba_team_stats(team_id: 'Union[int, str]', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA team stat leaders by category.

Parameters

ParameterTypeDefaultDescription
team_idUnion[int, str]Fox Bifrost team id.
return_parsedboolTrueIf True (default) flatten the leader sections to a DataFrame; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

Example

from sportsdataverse.wnba import fox_wnba_team_stats
df = fox_wnba_team_stats("3")

fox_wnba_teamnav​

fox_wnba_teamnav(*args: 'Any', **kwargs: 'Any') -> 'Any'

Fox Sports wnba team directory (one row per team).

Wraps wnba/league/teamnav.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
groupcharacterGroup identifier (e.g. conference 'group_id').
fox_idcharacterFox Sports team id as a string, the trailing number of content_uri (e.g. '6').
abbreviationcharacterShort abbreviation.
namecharacterDisplay name.
content_uricharacterFox Bifrost content URI identifying the team, shaped 'basketball/wnba/teams/<fox_id>'.
content_typecharacterFox entity type from the team's entity link; always 'team' in sampled data.
web_urlcharacterSite-relative foxsports.com path of the team page, shaped '/wnba/-team'.
colorcharacterPrimary color (hex without leading '#').
logo_urlcharacterNBA CDN primary logo URL.

Example

from sportsdataverse.wnba import fox_wnba_teamnav
df = fox_wnba_teamnav()

fox_wnba_teams​

fox_wnba_teams(team_id: 'Union[int, str]' = '3', *, return_parsed: 'bool' = True, return_as_pandas: 'bool' = False, **kwargs: 'Any') -> "Union[pl.DataFrame, 'pd.DataFrame', Dict[str, Any]]"

WNBA team directory (fox_team_id / fox_team_name / fox_section).

Derived from the standings endpoint (one league-wide payload), this is the frame the wehoop WNBA team crosswalk consumes.

Parameters

ParameterTypeDefaultDescription
team_idUnion[int, str]'3'Seed Fox Bifrost team id whose standings page is read. Defaults to "3" — any WNBA team id returns the whole league.
return_parsedboolTrueIf True (default) flatten the standings to the team directory; if False return the raw JSON dict.
return_as_pandasboolFalseIf True return a pandas DataFrame; otherwise polars. Ignored when return_parsed=False.

Returns

A polars DataFrame (default), a pandas DataFrame when return_as_pandas=True, or the raw JSON dict when return_parsed=False.

col_nametypedescription
fox_team_idcharacterFox Bifrost team id (NA if unmatched).
fox_team_namecharacterFox team name (NA if unmatched).
fox_sectioncharacterFox conference/section label (NA if unmatched).

Example

from sportsdataverse.wnba import fox_wnba_teams
df = fox_wnba_teams()