Skip to main content

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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/event/11195/data?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.
event_idevent_idYNumeric Fox game (event) id, e.g. 11195.
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
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_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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/event/11195/matchup?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.
event_idevent_idYNumeric Fox game (event) id, e.g. 11195.
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
entity_image_alt_textString
entity_image_alt_urlString
entity_image_typeString
entity_image_urlString
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
textString
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_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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/event/11195/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.
event_idevent_idYNumeric Fox game (event) id, e.g. 11195.
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
odds1String
odds2String
pointInt64
textString
text1String
text2String
timestampString
annotation_colorString
annotation_textString
annotation_typeString

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_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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/event/11195/recap?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.
event_idevent_idYNumeric Fox game (event) id, e.g. 11195.
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
entity_image_alt_textString
entity_image_alt_urlString
entity_image_typeString
entity_image_urlString
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
textString
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_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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/event/11195/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.
event_idevent_idYNumeric Fox game (event) id, e.g. 11195.
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
nfc_northString
v1String
w_l_tString
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.
nfc_southString

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_event_standings(sport='nfl', event_id='11195')