Skip to main content

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

fox_api_scoreboard​

GET /bifrost/v1/{sport}/scoreboard/main -- Fox Sports API scoreboard.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/scoreboard/main

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/scoreboard/main?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
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_scoreboard(sport='nfl')

fox_api_scorechip​

GET /bifrost/v1/{sport}/scorechip/{chip_id} -- one game's score chip (this route 400s if api-version is sent).

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/scorechip/{chip_id}

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/scorechip/nfl11195?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq

API ParameterPythonPatternRequiredNullableDescription
sportsportYFox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl.
chip_idchip_idYScore-chip id: the league slug plus the numeric game id, e.g. nfl11195.
apikeyapikeyYPublic Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.

Returns​

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

col_nametypedescription
alt_sort_keyString
content_typeString
content_uriString
entity_link_analytics_sportString
entity_link_content_typeString
entity_link_content_uriString
entity_link_layout_pathString
entity_link_layout_tokens_away_uriString
entity_link_layout_tokens_event_uriString
entity_link_layout_tokens_home_uriString
entity_link_layout_tokens_idString
entity_link_typeString
entity_link_web_urlString
event_headlineString
event_statusInt64
event_timeString
favorite_entitiesString
idString
importanceInt64
is_tbaBoolean
leagueString
lower_team_alternate_logo_urlString
lower_team_has_possessionBoolean
lower_team_image_alt_textString
lower_team_image_typeString
lower_team_is_loserBoolean
lower_team_logo_urlString
lower_team_long_nameString
lower_team_nameString
lower_team_recordString
lower_team_scoreInt64
lower_team_stacked_name_bottomString
lower_team_stacked_name_topString
lower_team_uriString
odds_lineString
over_under_lineString
sort_keyString
status_lineString
templateString
upper_team_alternate_logo_urlString
upper_team_has_possessionBoolean
upper_team_image_alt_textString
upper_team_image_typeString
upper_team_is_loserBoolean
upper_team_logo_urlString
upper_team_long_nameString
upper_team_nameString
upper_team_recordString
upper_team_scoreInt64
upper_team_stacked_name_bottomString
upper_team_stacked_name_topString
upper_team_uriString
uriString

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_scorechip(sport='nfl', chip_id='nfl11195')

fox_api_topevents_scoreboard_segment​

GET /bifrost/v1/topevents/scoreboard/segment/{segment} -- Fox Sports API topevents scoreboard segment.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/topevents/scoreboard/segment/{segment}

Valid URL: https://api.foxsports.com/bifrost/v1/topevents/scoreboard/segment/1?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
segmentsegmentYTop-events scoreboard segment id (0 / 1 ... as listed by topevents/scoreboard/main); NOT a league <season>-<week>-<type> id.
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
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_topevents_scoreboard_segment(segment='1')

fox_api_explore_browse​

GET /bifrost/v1/explore/browse/{section}/main -- Fox Sports API explore browse.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/explore/browse/{section}/main

Valid URL: https://api.foxsports.com/bifrost/v1/explore/browse/sports/main?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
sectionsectionYBrowse section: sports, players, shows, personalities or topics.
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_explore_browse(section='sports')

fox_api_explore_odds​

GET /bifrost/v1/explore/odds/main -- Fox Sports API explore odds.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/explore/odds/main

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

API ParameterPythonPatternRequiredNullableDescription
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
external_idStringProvider-side identifier for the media item, matching the play id it accompanies.
external_uriString
isa_valueString
pathString
short_titleString
slugString
spark_idString
tag_typeString
titleString
typeString
uuidv5String

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_explore_odds()

fox_api_search_content​

GET /bifrost/v1/search/content -- Fox Sports API search content.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/search/content

Valid URL: https://api.foxsports.com/bifrost/v1/search/content?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1&text=mahomes

API ParameterPythonPatternRequiredNullableDescription
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).
texttextYSearch text.

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
typeString
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.
titleString
subtitleString
content_typeString
content_uriString
web_urlString
analytics_nameString
image_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_search_content(text='mahomes')

fox_api_search_entities​

GET /bifrost/v1/search/entities -- Fox Sports API search entities.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/search/entities

Valid URL: https://api.foxsports.com/bifrost/v1/search/entities?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1&text=mahomes

API ParameterPythonPatternRequiredNullableDescription
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).
texttextYSearch text.

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
typeString
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.
titleString
subtitleString
content_typeString
content_uriString
web_urlString
analytics_nameString
image_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_search_entities(text='mahomes')

GET /bifrost/v1/search/popular -- Fox Sports API search popular.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/search/popular

Valid URL: https://api.foxsports.com/bifrost/v1/search/popular?apikey=jE7yBJVRNAwdDesMgTzTXUUSx1It41Fq&api-version=1.1

API ParameterPythonPatternRequiredNullableDescription
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).

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

col_nametypedescription
groupString
typeString
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.
titleString
subtitleString
content_typeString
content_uriString
web_urlString
analytics_nameString
image_urlString

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

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.
fox_api_search_popular()

GET /bifrost/v1/general/trending/articles -- Fox Sports API trending articles.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/general/trending/articles

Valid URL: https://api.foxsports.com/bifrost/v1/general/trending/articles?apikey=SuNgfBgmTGS2xozZbnV6FcjGGRQrR8cg&api-version=1.1&duration=4

API ParameterPythonPatternRequiredNullableDescription
apikeyapikeyYPublic Fox Sports feed-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).
durationdurationYTrending look-back window.
tagstagsYComma-separated tag filter.

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

col_nametypedescription
idString
spark_idString
titleString
descriptionString
content_typeString
component_typeString
publication_dateString
last_published_dateString
canonical_urlString
thumbnail_urlString
playback_urlString

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

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.
fox_api_trending_articles()

GET /bifrost/v1/general/trending/videos -- Fox Sports API trending videos.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/general/trending/videos

Valid URL: https://api.foxsports.com/bifrost/v1/general/trending/videos?apikey=SuNgfBgmTGS2xozZbnV6FcjGGRQrR8cg&api-version=1.1&duration=4&maxItems=12

API ParameterPythonPatternRequiredNullableDescription
apikeyapikeyYPublic Fox Sports feed-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).
durationdurationYTrending look-back window.
maxItemsmax_itemsYMaximum items to return.

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

col_nametypedescription
idString
spark_idString
titleString
descriptionString
content_typeString
component_typeString
publication_dateString
last_published_dateString
canonical_urlString
thumbnail_urlString
playback_urlString

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

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.
fox_api_trending_videos()

fox_api_foxpolls​

GET /foxpolls/v1/polls -- Fox Sports API foxpolls.

Endpoint URL: GET https://api.foxsports.com/foxpolls/v1/polls

Valid URL: https://api.foxsports.com/foxpolls/v1/polls?apikey=SuNgfBgmTGS2xozZbnV6FcjGGRQrR8cg&includeAnswers=true

API ParameterPythonPatternRequiredNullableDescription
apikeyapikeyYPublic Fox Sports feed-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it.
associatedEntityIdsassociated_entity_idsYComma-separated Fox entity ids the polls are associated with.
includeAnswersinclude_answersYInclude poll answer options.

Returns​

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

col_nametypedescription
poll_idInt64
uriString
titleString
typeString
background_image_urlString
background_image_versionInt64
background_image_typeString
background_image_alt_textString
background_image_additional_urlsString
min_submissions_neededInt64
max_submissions_allowedInt64
max_votes_per_userInt64
cta_textString
cta_urlString
results_display_typeString
results_display_textString
results_commentaryString
results_displayed_atString
authorization_typeString
starts_atString
ends_atString
locks_atString
answersString
votesInt64
min_votes_to_display_post_lockInt64
ads_enabledBoolean
background_image_additional_urls_resized_urlString
background_imageString

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_foxpolls()