Skip to main content

CFL — ESPN core API (v2) — Other

espn_cfl_league_root​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl

API ParameterPythonPatternRequiredNullableDescription

Returns​

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

col_nametypedescription
$refString
abbreviationString
colorString
display_nameString
genderString
guidString
idInt64
is_tournamentBoolean
linksString
logosString
nameString
short_nameString
slugString
uidString
athletes_$refString
awards_$refString
calendar_$refString
draft_$refString
events_$refString
franchises_$refString
group_$refString
groups_$refString
leaders_$refString
notes_$refString
rankings_$refString
season_$refString
season_athletes_$refString
season_coaches_$refString
season_display_nameString
season_end_dateString
season_futures_$refString
season_power_index_leaders_$refString
season_power_indexes_$refString
season_rankings_$refString
season_start_dateString
season_type_$refString
season_type_abbreviationString
season_type_corrections_$refString
season_type_end_dateString
season_type_groups_$refString
season_type_has_groupsBoolean
season_type_has_legsBoolean
season_type_has_standingsBoolean
season_type_idInt64
season_type_nameString
season_type_slugString
season_type_start_dateString
season_type_typeInt64
season_type_weeks_$refString
season_type_yearInt64
season_types_$refString
season_types_countInt64
season_types_itemsString
season_types_page_countInt64
season_types_page_indexInt64
season_types_page_sizeInt64
season_yearInt64
seasons_$refString
teams_$refString
transactions_$refString

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​

espn_cfl_league_root()

espn_cfl_seasons​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of 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_nametypedescription
$refString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_seasons()

espn_cfl_games​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/events

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/events?limit=500

API ParameterPythonPatternRequiredNullableDescription
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
limitlimitYMaximum number of 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_nametypedescription
$refString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_games()

espn_cfl_game​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/events/{event_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/events/401584793

API ParameterPythonPatternRequiredNullableDescription
event_idevent_idYevent_id path parameter.

Returns​

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

col_nametypedescription
$refString
competitionsString
dateString
idInt64
linksString
nameString
short_nameString
time_validBoolean
uidString
venuesString
league_$refString
season_$refString
season_type_$refString

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​

espn_cfl_game(event_id='401584793')

espn_cfl_teams_core​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/teams

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/teams?limit=1000&page=1

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.
pagepageYpage query parameter.

Returns​

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

col_nametypedescription
team_abbreviationStringShort team abbreviation (e.g. "BOS").
team_alternate_colorStringSecondary team color as a hex string (no leading '#').
team_colorStringPrimary team color as a hex string (no leading '#').
team_display_nameStringFull team display name (location + nickname).
team_idInt64ESPN team id (stable join key across ESPN endpoints).
team_is_activeBooleanWhether the team is currently active.
team_is_all_starBooleanWhether the entry is an all-star squad rather than a franchise.
team_locationStringTeam location / city (e.g. "Boston").
team_logosStringPipe-delimited logo image URLs.
team_nameStringTeam nickname/mascot (e.g. "Celtics").
team_nicknameStringTeam nickname as ESPN labels it (often equals team_name).
team_short_display_nameStringAbbreviated display name for compact UIs.
team_slugStringURL slug used in ESPN web paths.
team_uidStringESPN global UID (encodes sport/league/team).

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​

espn_cfl_teams_core()

espn_cfl_team_core​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/teams/{team_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/teams/4

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.

Returns​

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

col_nametypedescription
$refString
abbreviationString
alternate_colorString
colorString
display_nameString
guidString
idInt64
is_activeBoolean
is_all_starBoolean
linksString
locationString
logosString
nameString
short_display_nameString
slugString
uidString
against_the_spread_records_$refString
athletes_$refString
awards_$refString
coaches_$refString
depth_charts_$refString
events_$refString
franchise_$refString
groups_$refString
injuries_$refString
notes_$refString
odds_records_$refString
ranks_$refString
record_$refString
transactions_$refString
venue_$refString
venue_address_cityString
venue_address_stateString
venue_full_nameString
venue_grassBoolean
venue_guidString
venue_idInt64
venue_imagesString
venue_indoorBoolean
venue_short_nameString

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​

espn_cfl_team_core(team_id='4')

espn_cfl_venues​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/venues

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/venues?limit=1000

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of 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_nametypedescription
$refString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_venues()

espn_cfl_venue​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/venues/{venue_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/venues/3663

API ParameterPythonPatternRequiredNullableDescription
venue_idvenue_idYvenue_id path parameter.

Returns​

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

col_nametypedescription
$refString
full_nameString
grassBoolean
guidString
idInt64
imagesString
indoorBoolean

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​

espn_cfl_venue(venue_id='3663')

espn_cfl_franchises​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/franchises

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/franchises?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of 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_nametypedescription
$refString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_franchises()

espn_cfl_franchise​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/franchises/{franchise_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/franchises/2

API ParameterPythonPatternRequiredNullableDescription
franchise_idfranchise_idYfranchise_id path parameter.

Returns​

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

col_nametypedescription
$refString
abbreviationString
colorString
display_nameString
idInt64
is_activeBoolean
locationString
nameString
short_display_nameString
slugString
uidString
team_$refString
venue_$refString
venue_address_cityString
venue_address_stateString
venue_full_nameString
venue_grassBoolean
venue_guidString
venue_idInt64
venue_imagesString
venue_indoorBoolean
venue_short_nameString

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​

espn_cfl_franchise(franchise_id='2')

espn_cfl_coach​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/coaches/{coach_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/coaches/1

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.

Returns​

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

col_nametypedescription
$refString
career_recordsString
coach_seasonsString
experienceInt64
first_nameString
idInt64
last_nameString
uidString
birth_place_cityString
birth_place_stateString

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​

espn_cfl_coach(coach_id='1')

espn_cfl_coach_record​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/coaches/{coach_id}/record/{record_type}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/coaches/1/record/0

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.
record_typerecord_typeYrecord_type path parameter.

Returns​

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

col_nametypedescription
$refString
display_valueString
idInt64
nameString
statsString
summaryString
typeString
valueFloat64

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​

espn_cfl_coach_record(coach_id='1')

espn_cfl_coach_season​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/coaches/{coach_id}/seasons/{season}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/coaches/1/seasons/2024

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.
seasonseasonYseason path parameter.

Returns​

return_parsed=True (default) — the output of parse_single_entity; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

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​

espn_cfl_coach_season(coach_id='1', season=2024)

espn_cfl_positions​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/positions

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/positions?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of 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_nametypedescription
$refString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_positions()

espn_cfl_position​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/positions/{position_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/positions/1

API ParameterPythonPatternRequiredNullableDescription
position_idposition_idYposition_id path parameter.

Returns​

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

col_nametypedescription
$refString
abbreviationString
display_nameString
idInt64
leafBoolean
nameString
parent_$refString

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​

espn_cfl_position(position_id='1')

espn_cfl_tournaments​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/tournaments

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/tournaments?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of 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_nametypedescription
$refString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_tournaments()

espn_cfl_awards​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/awards

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/awards?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of 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_nametypedescription
$refString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_awards()

espn_cfl_award​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/awards/{award_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/awards/1

API ParameterPythonPatternRequiredNullableDescription
award_idaward_idYaward_id path parameter.

Returns​

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

col_nametypedescription
countInt64
itemsString
page_countInt64
page_indexInt64
page_sizeInt64

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​

espn_cfl_award(award_id='1')

espn_cfl_standings_core​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/standings

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/standings

API ParameterPythonPatternRequiredNullableDescription

Returns​

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

col_nametypedescription
group_nameStringGroup name.
group_abbreviationStringGroup abbreviation.
team_idInt64Team id.
team_nameStringTeam name.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
team_locationStringTeam location.
team_logoStringTeam logo.
avg_points_againstFloat64Avg points against.
avg_points_forFloat64Avg points for.
clincherFloat64Clincher.
differentialFloat64Differential.
division_win_percentFloat64Division win percent.
games_behindFloat64Games behind.
league_win_percentFloat64League win percent.
lossesFloat64Losses.
playoff_seedFloat64Playoff seed.
point_differentialFloat64Point differential.
pointsFloat64Points.
points_againstFloat64Points against.
points_forFloat64Points for.
streakFloat64Streak.
win_percentFloat64Win percent.
winsFloat64Wins.
games_aheadFloat64Games ahead.
overallStringOverall.
homeStringHome.
roadStringRoad.
vs. div.StringVs. div..
vs. conf.StringVs. conf..
last ten gamesStringLast ten games.

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​

espn_cfl_standings_core()

espn_cfl_leaders_core​

All-time league leaders. ESPN ignores season here (nba with and without season=2015 returned the same career totals, 2026-11-17).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/leaders

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, nfl, mlb, nhl, 2026-10-07); its rows sit under keys it does not read (top level: $ref, abbreviation, categories, id, name, type).

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​

espn_cfl_leaders_core()

espn_cfl_league_notes​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/notes

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/notes

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: the page holds zero items (count 0) in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

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​

espn_cfl_league_notes()

espn_cfl_talentpicks​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/talentpicks

Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/talentpicks

API ParameterPythonPatternRequiredNullableDescription

Returns​

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

col_nametypedescription
pick_competition_$refString
pick_competitor_$refString
pick_correctBoolean
pick_person_display_nameString
pick_person_first_nameString
pick_person_headshot_altString
pick_person_headshot_hrefString
pick_person_idInt64
pick_person_last_nameString
week_record_display_valueString
week_record_season_$refString
week_record_statsString
countInt64Total items in the ESPN collection across every page (the page envelope's count), the same on every row; more than the row count means this is one page of several (pass the wrapper's limit= or page=).
page_countInt64Pages the collection spans at the requested limit (the page envelope's pageCount), the same on every row; above 1 means rows are missing from this frame.

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​

espn_cfl_talentpicks()