Skip to main content

Fox Sports — Fox Sports API (api.foxsports.com) — League

fox_api_league_conferences​

GET /bifrost/v1/{sport}/league/conferences -- Fox Sports API league conferences.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/conferences

Valid URL: https://api.foxsports.com/bifrost/v1/cfb/league/conferences?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
groupString
fox_idString
abbreviationString
nameString
content_uriString
content_typeString
web_urlString
colorString
logo_urlString

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.

Example​

fox_api_league_conferences(sport='cfb')

fox_api_league_header​

GET /bifrost/v1/{sport}/league/header -- Fox Sports API league header.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/header

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/header?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
templateString
titleString
entity_idStringComposite Yahoo id this editorial row was keyed under, surfaced from the collection map key (e.g., "ncaaf.g.202509200023" for a game, "ncaaf.t.29" for a team); always carried as Utf8.
content_uriString
content_typeString
colorString
logo_urlString
image_alt_textString
rankString
detailsString

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.

Example​

fox_api_league_header(sport='nfl')

fox_api_league_odds​

GET /bifrost/v1/{sport}/league/odds -- Fox Sports API league odds.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/odds

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/odds?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).
groupIdgroup_idYConference / group id filter.

Returns​

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

col_nametypedescription
model_gambling_text_bet_textString
model_gambling_text_winnings_textString
model_image_alt_textString
model_image_alt_urlString
model_image_typeString
model_image_urlString
model_info_dateString
model_info_sub_textString
model_main_textString
model_odds_bet_slip_bet_displayString
model_odds_bet_slip_bet_incrementInt64
model_odds_bet_slip_bet_indexInt64
model_odds_bet_slip_bet_maxInt64
model_odds_bet_slip_bet_minInt64
model_odds_bet_slip_descriptionString
model_odds_bet_slip_disclaimer_textString
model_odds_bet_slip_event_timeString
model_odds_bet_slip_event_titleString
model_odds_bet_slip_image_alt_textString
model_odds_bet_slip_image_alt_urlString
model_odds_bet_slip_image_typeString
model_odds_bet_slip_image_urlString
model_odds_bet_slip_odds_displayString
model_odds_bet_slip_payout_multiplierFloat64
model_odds_bet_slip_tracking_data_bet_entity_nameString
model_odds_bet_slip_tracking_data_bet_entity_uriString
model_odds_bet_slip_tracking_data_bet_event_statusInt64
model_odds_bet_slip_tracking_data_bet_event_uriString
model_odds_bet_slip_tracking_data_bet_outcome_lineString
model_odds_bet_slip_tracking_data_bet_outcome_titleString
model_odds_bet_slip_tracking_data_content_entity_uriString
model_odds_bet_slip_tracking_data_page_start_sourceString
model_odds_sub_textString
model_odds_textString
model_odds_titleString
model_sub_textString
templateString

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.

Example​

fox_api_league_odds(sport='nfl')

fox_api_league_playernews​

GET /bifrost/v1/{sport}/league/playernews -- Fox Sports API league playernews.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/playernews

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/playernews?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
alternate_image_urlString
dateString
descriptionString
entity_link_alternate_image_urlString
entity_link_analytics_nameString
entity_link_analytics_sportString
entity_link_colorString
entity_link_content_typeString
entity_link_content_uriString
entity_link_image_alt_textString
entity_link_image_typeString
entity_link_image_urlString
entity_link_layout_pathString
entity_link_layout_tokens_content_uriString
entity_link_layout_tokens_idString
entity_link_titleString
entity_link_typeString
entity_link_web_urlString
headlineString
image_alt_textString
image_typeString
image_urlString
impactString
impact_titleString
sourceString
subtitleString
titleString

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.

Example​

fox_api_league_playernews(sport='nfl')

fox_api_league_polls​

GET /bifrost/v1/{sport}/league/polls -- Fox Sports API league polls.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/polls

Valid URL: https://api.foxsports.com/bifrost/v1/cfb/league/polls?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
sectionString
rankingString
v1String
v2String
ptsString
entity_idStringComposite Yahoo id this editorial row was keyed under, surfaced from the collection map key (e.g., "ncaaf.g.202509200023" for a game, "ncaaf.t.29" for a team); always carried as Utf8.
teamString
rank_changeInt64

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.

Example​

fox_api_league_polls(sport='cfb')

fox_api_league_schedule​

GET /bifrost/v1/{sport}/league/schedule -- Fox Sports API league schedule.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/schedule

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/schedule?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
idString
parameters_season_typeString
parameters_weekString
subtitleString
titleString
uriString
web_urlString

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.

Example​

fox_api_league_schedule(sport='nfl')

fox_api_league_scores​

GET /bifrost/v1/{sport}/league/scores -- Fox Sports API league scores.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/scores

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/scores?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
idString
parameters_season_typeString
parameters_weekString
subtitleString
titleString
uriString
web_urlString

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.

Example​

fox_api_league_scores(sport='nfl')

fox_api_league_scores_segment​

GET /bifrost/v1/{sport}/league/scores-segment/{segment_id} -- Fox Sports API league scores segment.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/scores-segment/{segment_id}

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/scores-segment/2026-3-1?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
segment_idsegment_idYScores segment id, <season>-<week>-<seasonTypeCode>, e.g. 2026-3-1.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).
groupIdgroup_idYConference / group id filter.

Returns​

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

col_nametypedescription
segment_idString
section_idString
section_titleString
game_idString
chip_idString
leagueString
dateString
event_statusInt64
statusString
tv_stationString
headlineString
odds_lineString
over_under_lineString
home_teamString
home_team_idString
home_scoreInt64
home_recordString
away_teamString
away_team_idString
away_scoreInt64
away_recordString

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.

Example​

fox_api_league_scores_segment(sport='nfl', segment_id='2026-3-1')

fox_api_league_standings​

GET /bifrost/v1/{sport}/league/standings -- Fox Sports API league standings.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/standings

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/standings?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
sectionString
afc_eastString
v1String
w_l_tString
pctString
pfString
paString
homeString
awayString
confString
divString
strkString
entity_idStringComposite Yahoo id this editorial row was keyed under, surfaced from the collection map key (e.g., "ncaaf.g.202509200023" for a game, "ncaaf.t.29" for a team); always carried as Utf8.
afc_northString
afc_southString
afc_westString
nfc_eastString
nfc_northString
nfc_southString
nfc_westString
american_football_conferenceString
national_football_conferenceString

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.

Example​

fox_api_league_standings(sport='nfl')

fox_api_league_stats​

GET /bifrost/v1/{sport}/league/stats -- Fox Sports API league stats.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/stats

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/stats?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
condensed_uriString
image_alt_textString
image_typeString
image_urlString
nameString
selection_idString
short_nameString
stat_abbreviationString
stat_valueString
team_abbreviationString
templateString
titleString
web_urlString

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.

Example​

fox_api_league_stats(sport='nfl')

fox_api_league_stats_con​

GET /bifrost/v1/{sport}/league/stats-con/{who}/{category}/{page} -- Fox Sports API league stats con.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/stats-con/{who}/{category}/{page}

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/stats-con/player/passing/1?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
whowhoYStat subject, e.g. player or team.
categorycategoryYStat category slug, e.g. passing.
pagepageYResults page number.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).
groupIdgroup_idYConference / group id filter.

Returns​

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

col_nametypedescription
columnsString
entity_link_alternate_image_urlString
entity_link_analytics_nameString
entity_link_analytics_sportString
entity_link_colorString
entity_link_content_typeString
entity_link_content_uriString
entity_link_image_alt_textString
entity_link_image_typeString
entity_link_image_urlString
entity_link_layout_pathString
entity_link_layout_tokens_content_uriString
entity_link_layout_tokens_idString
entity_link_titleString
entity_link_typeString
entity_link_web_urlString
is_cutoffBoolean
is_fadedBoolean
selectedBoolean

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.

Example​

fox_api_league_stats_con(sport='nfl', who='player', category='passing', page='1')

fox_api_league_teamnav​

GET /bifrost/v1/{sport}/league/teamnav -- Fox Sports API league teamnav.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/league/teamnav

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/league/teamnav?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
api-versionapi_versionYFox API version (api-version query key).

Returns​

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

col_nametypedescription
groupString
fox_idString
abbreviationString
nameString
content_uriString
content_typeString
web_urlString
colorString
logo_urlString

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.

Example​

fox_api_league_teamnav(sport='nfl')