Skip to main content

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

fox_api_team_gamelog​

GET /bifrost/v1/{sport}/team/{team_id}/gamelog -- Fox Sports API team gamelog.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/team/{team_id}/gamelog

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/team/25/gamelog?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.
team_idteam_idYNumeric Fox team id, e.g. 25.
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
emphasizedBoolean
indexInt64
priorityInt64
sortableString
templateString
textString
weightFloat64

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_team_gamelog(sport='nfl', team_id='25')

fox_api_team_header​

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

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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/team/25/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.
team_idteam_idYNumeric Fox team id, e.g. 25.
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_team_header(sport='nfl', team_id='25')

fox_api_team_roster​

GET /bifrost/v1/{sport}/team/{team_id}/roster -- Fox Sports API team roster.

Endpoint URL: GET https://api.foxsports.com/bifrost/v1/{sport}/team/{team_id}/roster

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/team/25/roster?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.
team_idteam_idYNumeric Fox team id, e.g. 25.
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
position_groupString
playerString
posString
ageStringAthlete age in years.
htString
wtString
collegeString
athlete_idStringESPN numeric identifier for the athlete.

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_team_roster(sport='nfl', team_id='25')

fox_api_team_standings​

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

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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/team/25/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.
team_idteam_idYNumeric Fox team id, e.g. 25.
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_southString
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.
nfc_eastString
nfc_northString
nfc_westString
afc_eastString
afc_northString
afc_southString
afc_westString
national_football_conferenceString
american_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_team_standings(sport='nfl', team_id='25')

fox_api_team_stats​

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

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

Valid URL: https://api.foxsports.com/bifrost/v1/nfl/team/25/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.
team_idteam_idYNumeric Fox team id, e.g. 25.
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
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_team_stats(sport='nfl', team_id='25')