Fox Sports — Fox Sports API (api.foxsports.com) — Event
fox_api_event_data
GET /bifrost/v1/{sport}/event/{event_id}/data -- Fox Sports API event data.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/event/{event_id}/data
| 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. | ||
event_id | event_id | Y | Numeric Fox game (event) id, e.g. 11195. | ||
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 |
|---|---|---|
columns | String | |
entity_link_alternate_image_url | String | |
entity_link_analytics_name | String | |
entity_link_analytics_sport | String | |
entity_link_color | String | |
entity_link_content_type | String | |
entity_link_content_uri | String | |
entity_link_image_alt_text | String | |
entity_link_image_type | String | |
entity_link_image_url | String | |
entity_link_layout_path | String | |
entity_link_layout_tokens_content_uri | String | |
entity_link_layout_tokens_id | String | |
entity_link_title | String | |
entity_link_type | String | |
entity_link_web_url | String | |
is_cutoff | Boolean | |
is_faded | Boolean | |
selected | Boolean |
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_event_data(sport='nfl', event_id='11195')
fox_api_event_matchup
GET /bifrost/v1/{sport}/event/{event_id}/matchup -- Fox Sports API event matchup.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/event/{event_id}/matchup
| 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. | ||
event_id | event_id | Y | Numeric Fox game (event) id, e.g. 11195. | ||
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 |
|---|---|---|
entity_image_alt_text | String | |
entity_image_alt_url | String | |
entity_image_type | String | |
entity_image_url | String | |
entity_link_alternate_image_url | String | |
entity_link_analytics_name | String | |
entity_link_analytics_sport | String | |
entity_link_color | String | |
entity_link_content_type | String | |
entity_link_content_uri | String | |
entity_link_image_alt_text | String | |
entity_link_image_type | String | |
entity_link_image_url | String | |
entity_link_layout_path | String | |
entity_link_layout_tokens_content_uri | String | |
entity_link_layout_tokens_id | String | |
entity_link_title | String | |
entity_link_type | String | |
entity_link_web_url | String | |
text | String | |
title | 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_event_matchup(sport='nfl', event_id='11195')
fox_api_event_odds
GET /bifrost/v1/{sport}/event/{event_id}/odds -- Fox Sports API event odds.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/event/{event_id}/odds
| 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. | ||
event_id | event_id | Y | Numeric Fox game (event) id, e.g. 11195. | ||
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 |
|---|---|---|
odds1 | String | |
odds2 | String | |
point | Int64 | |
text | String | |
text1 | String | |
text2 | String | |
timestamp | String | |
annotation_color | String | |
annotation_text | String | |
annotation_type | 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_event_odds(sport='nfl', event_id='11195')
fox_api_event_recap
GET /bifrost/v1/{sport}/event/{event_id}/recap -- Fox Sports API event recap.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/event/{event_id}/recap
| 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. | ||
event_id | event_id | Y | Numeric Fox game (event) id, e.g. 11195. | ||
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 |
|---|---|---|
entity_image_alt_text | String | |
entity_image_alt_url | String | |
entity_image_type | String | |
entity_image_url | String | |
entity_link_alternate_image_url | String | |
entity_link_analytics_name | String | |
entity_link_analytics_sport | String | |
entity_link_color | String | |
entity_link_content_type | String | |
entity_link_content_uri | String | |
entity_link_image_alt_text | String | |
entity_link_image_type | String | |
entity_link_image_url | String | |
entity_link_layout_path | String | |
entity_link_layout_tokens_content_uri | String | |
entity_link_layout_tokens_id | String | |
entity_link_title | String | |
entity_link_type | String | |
entity_link_web_url | String | |
text | String | |
title | 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_event_recap(sport='nfl', event_id='11195')
fox_api_event_standings
GET /bifrost/v1/{sport}/event/{event_id}/standings -- Fox Sports API event standings.
Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/event/{event_id}/standings
| 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. | ||
event_id | event_id | Y | Numeric Fox game (event) id, e.g. 11195. | ||
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 |
|---|---|---|
section | String | |
nfc_north | String | |
v1 | String | |
w_l_t | String | |
div | String | |
strk | 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. |
nfc_south | 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_event_standings(sport='nfl', event_id='11195')