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
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
sport | sport | Y | Fox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl. | ||
apikey | apikey | Y | Public Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox API version (api-version query key). | ||
groupId | group_id | Y | Conference / 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_name | type | description |
|---|---|---|
id | String | |
parameters_season_type | String | |
parameters_week | String | |
subtitle | String | |
title | String | |
uri | String | |
web_url | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
sport | sport | Y | Fox sport/league slug as used in foxsports.com URLs, e.g. nfl, cfb, nba, cbk, wcbk, mlb, nhl. | ||
chip_id | chip_id | Y | Score-chip id: the league slug plus the numeric game id, e.g. nfl11195. | ||
apikey | apikey | Y | Public 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_name | type | description |
|---|---|---|
alt_sort_key | String | |
content_type | String | |
content_uri | String | |
entity_link_analytics_sport | String | |
entity_link_content_type | String | |
entity_link_content_uri | String | |
entity_link_layout_path | String | |
entity_link_layout_tokens_away_uri | String | |
entity_link_layout_tokens_event_uri | String | |
entity_link_layout_tokens_home_uri | String | |
entity_link_layout_tokens_id | String | |
entity_link_type | String | |
entity_link_web_url | String | |
event_headline | String | |
event_status | Int64 | |
event_time | String | |
favorite_entities | String | |
id | String | |
importance | Int64 | |
is_tba | Boolean | |
league | String | |
lower_team_alternate_logo_url | String | |
lower_team_has_possession | Boolean | |
lower_team_image_alt_text | String | |
lower_team_image_type | String | |
lower_team_is_loser | Boolean | |
lower_team_logo_url | String | |
lower_team_long_name | String | |
lower_team_name | String | |
lower_team_record | String | |
lower_team_score | Int64 | |
lower_team_stacked_name_bottom | String | |
lower_team_stacked_name_top | String | |
lower_team_uri | String | |
odds_line | String | |
over_under_line | String | |
sort_key | String | |
status_line | String | |
template | String | |
upper_team_alternate_logo_url | String | |
upper_team_has_possession | Boolean | |
upper_team_image_alt_text | String | |
upper_team_image_type | String | |
upper_team_is_loser | Boolean | |
upper_team_logo_url | String | |
upper_team_long_name | String | |
upper_team_name | String | |
upper_team_record | String | |
upper_team_score | Int64 | |
upper_team_stacked_name_bottom | String | |
upper_team_stacked_name_top | String | |
upper_team_uri | String | |
uri | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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}
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
segment | segment | Y | Top-events scoreboard segment id (0 / 1 ... as listed by topevents/scoreboard/main); NOT a league <season>-<week>-<type> id. | ||
apikey | apikey | Y | Public Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox 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_name | type | description |
|---|---|---|
segment_id | String | |
section_id | String | |
section_title | String | |
game_id | String | |
chip_id | String | |
league | String | |
date | String | |
event_status | Int64 | |
status | String | |
tv_station | String | |
headline | String | |
odds_line | String | |
over_under_line | String | |
home_team | String | |
home_team_id | String | |
home_score | Int64 | |
home_record | String | |
away_team | String | |
away_team_id | String | |
away_score | Int64 | |
away_record | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
section | section | Y | Browse section: sports, players, shows, personalities or topics. | ||
apikey | apikey | Y | Public Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox 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_name | type | description |
|---|---|---|
group | String | |
fox_id | String | |
abbreviation | String | |
name | String | |
content_uri | String | |
content_type | String | |
web_url | String | |
color | String | |
logo_url | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
apikey | apikey | Y | Public Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox 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_name | type | description |
|---|---|---|
external_id | String | Provider-side identifier for the media item, matching the play id it accompanies. |
external_uri | String | |
isa_value | String | |
path | String | |
short_title | String | |
slug | String | |
spark_id | String | |
tag_type | String | |
title | String | |
type | String | |
uuidv5 | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
apikey | apikey | Y | Public Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox API version (api-version query key). | ||
text | text | Y | Search text. |
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 | String | |
type | String | |
entity_id | String | Composite 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. |
title | String | |
subtitle | String | |
content_type | String | |
content_uri | String | |
web_url | String | |
analytics_name | String | |
image_url | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
apikey | apikey | Y | Public Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox API version (api-version query key). | ||
text | text | Y | Search text. |
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 | String | |
type | String | |
entity_id | String | Composite 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. |
title | String | |
subtitle | String | |
content_type | String | |
content_uri | String | |
web_url | String | |
analytics_name | String | |
image_url | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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')
fox_api_search_popular
GET /bifrost/v1/search/popular -- Fox Sports API search popular.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/search/popular
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
apikey | apikey | Y | Public Fox Sports data-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox 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_name | type | description |
|---|---|---|
group | String | |
type | String | |
entity_id | String | Composite 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. |
title | String | |
subtitle | String | |
content_type | String | |
content_uri | String | |
web_url | String | |
analytics_name | String | |
image_url | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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_popular()
fox_api_trending_articles
GET /bifrost/v1/general/trending/articles -- Fox Sports API trending articles.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/general/trending/articles
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
apikey | apikey | Y | Public Fox Sports feed-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox API version (api-version query key). | ||
duration | duration | Y | Trending look-back window. | ||
tags | tags | Y | Comma-separated tag filter. |
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 |
|---|---|---|
id | String | |
spark_id | String | |
title | String | |
description | String | |
content_type | String | |
component_type | String | |
publication_date | String | |
last_published_date | String | |
canonical_url | String | |
thumbnail_url | String | |
playback_url | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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_trending_articles()
fox_api_trending_videos
GET /bifrost/v1/general/trending/videos -- Fox Sports API trending videos.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/general/trending/videos
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
apikey | apikey | Y | Public Fox Sports feed-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
api-version | api_version | Y | Fox API version (api-version query key). | ||
duration | duration | Y | Trending look-back window. | ||
maxItems | max_items | Y | Maximum items to return. |
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 |
|---|---|---|
id | String | |
spark_id | String | |
title | String | |
description | String | |
content_type | String | |
component_type | String | |
publication_date | String | |
last_published_date | String | |
canonical_url | String | |
thumbnail_url | String | |
playback_url | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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_trending_videos()
fox_api_foxpolls
GET /foxpolls/v1/polls -- Fox Sports API foxpolls.
Endpoint URL: GET https://api.foxsports.com/foxpolls/v1/polls
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
apikey | apikey | Y | Public Fox Sports feed-tier key shipped in the foxsports.com web bundle (not a secret); override only if Fox rotates it. | ||
associatedEntityIds | associated_entity_ids | Y | Comma-separated Fox entity ids the polls are associated with. | ||
includeAnswers | include_answers | Y | Include 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_name | type | description |
|---|---|---|
poll_id | Int64 | |
uri | String | |
title | String | |
type | String | |
background_image_url | String | |
background_image_version | Int64 | |
background_image_type | String | |
background_image_alt_text | String | |
background_image_additional_urls | String | |
min_submissions_needed | Int64 | |
max_submissions_allowed | Int64 | |
max_votes_per_user | Int64 | |
cta_text | String | |
cta_url | String | |
results_display_type | String | |
results_display_text | String | |
results_commentary | String | |
results_displayed_at | String | |
authorization_type | String | |
starts_at | String | |
ends_at | String | |
locks_at | String | |
answers | String | |
votes | Int64 | |
min_votes_to_display_post_lock | Int64 | |
ads_enabled | Boolean | |
background_image_additional_urls_resized_url | String | |
background_image | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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()