CFL — ESPN core API (v2) — Season
espn_cfl_season_pointer
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/season
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/season
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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 |
|---|---|---|
$ref | String | |
display_name | String | |
end_date | String | |
start_date | String | |
year | Int64 | |
athletes_$ref | String | |
coaches_$ref | String | |
futures_$ref | String | |
power_index_leaders_$ref | String | |
power_indexes_$ref | String | |
rankings_$ref | String | |
type_$ref | String | |
type_abbreviation | String | |
type_corrections_$ref | String | |
type_end_date | String | |
type_groups_$ref | String | |
type_has_groups | Boolean | |
type_has_legs | Boolean | |
type_has_standings | Boolean | |
type_id | Int64 | |
type_name | String | |
type_slug | String | |
type_start_date | String | |
type_type | Int64 | |
type_weeks_$ref | String | |
type_year | Int64 | |
types_$ref | String | |
types_count | Int64 | |
types_items | String | |
types_page_count | Int64 | |
types_page_index | Int64 | |
types_page_size | Int64 |
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
espn_cfl_season_pointer()
espn_cfl_season_info
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season 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_name | type | description |
|---|---|---|
$ref | String | |
display_name | String | |
end_date | String | |
start_date | String | |
year | Int64 | |
awards_$ref | String | |
futures_$ref | String | |
leaders_$ref | String | |
power_index_leaders_$ref | String | |
power_indexes_$ref | String | |
rankings_$ref | String | |
type_$ref | String | |
type_abbreviation | String | |
type_corrections_$ref | String | |
type_end_date | String | |
type_groups_$ref | String | |
type_has_groups | Boolean | |
type_has_legs | Boolean | |
type_has_standings | Boolean | |
type_id | Int64 | |
type_leaders_$ref | String | |
type_name | String | |
type_slug | String | |
type_start_date | String | |
type_type | Int64 | |
type_weeks_$ref | String | |
type_year | Int64 | |
types_$ref | String | |
types_count | Int64 | |
types_items | String | |
types_page_count | Int64 | |
types_page_index | Int64 | |
types_page_size | Int64 |
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
espn_cfl_season_info(season=2024)
espn_cfl_season_types
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season 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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_types(season=2024)
espn_cfl_season_type
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types/2
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_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_name | type | description |
|---|---|---|
$ref | String | |
abbreviation | String | |
end_date | String | |
has_groups | Boolean | |
has_legs | Boolean | |
has_standings | Boolean | |
id | Int64 | |
name | String | |
slug | String | |
start_date | String | |
type | Int64 | |
year | Int64 | |
corrections_$ref | String | |
groups_$ref | String | |
leaders_$ref | String | |
weeks_$ref | 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
espn_cfl_season_type(season=2024, season_type=2)
espn_cfl_season_group
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/groups/{group_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types/2/groups/80
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_type path parameter. | ||
group_id | group_id | Y | group_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_name | type | description |
|---|---|---|
$ref | String | |
id | Int64 | |
is_conference | Boolean | |
links | String | |
midsize_name | String | |
name | String | |
short_name | String | |
slug | String | |
uid | String | |
children_$ref | String | |
parent_$ref | String | |
season_$ref | String | |
standings_$ref | String | |
teams_$ref | 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
espn_cfl_season_group(season=2024, season_type=2, group_id=80)
espn_cfl_season_groups
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/groups
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types/2/groups
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_groups(season=2024, season_type=2)
espn_cfl_season_group_teams
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/groups/{group_id}/teams
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_type path parameter. | ||
group_id | group_id | Y | group_id path parameter. | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_group_teams(season=2024, season_type=2, group_id=80)
espn_cfl_season_group_children
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/groups/{group_id}/children
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_type path parameter. | ||
group_id | group_id | Y | group_id path parameter. | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_group_children(season=2024, season_type=2, group_id=80)
espn_cfl_season_type_leaders
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/leaders
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types/2/leaders
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_type path parameter. |
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, wnba, cfb, mbb, wbb, 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
| 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
espn_cfl_season_type_leaders(season=2024, season_type=2)
espn_cfl_season_type_corrections
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/corrections
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types/2/corrections
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_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_name | type | description |
|---|---|---|
athlete_$ref | String | |
competition_$ref | String | |
split_stats_abbreviation | String | |
split_stats_categories | String | |
split_stats_id | Int64 | |
split_stats_name | String | |
team_$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_type_corrections(season=2024, season_type=2)
espn_cfl_season_weeks
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/weeks
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types/2/weeks
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_weeks(season=2024, season_type=2)
espn_cfl_season_week
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/weeks/{week}
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/types/2/weeks/1
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_type path parameter. | ||
week | week | Y | week 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_name | type | description |
|---|---|---|
$ref | String | |
end_date | String | |
number | Int64 | |
start_date | String | |
text | String | |
rankings_$ref | 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
espn_cfl_season_week(season=2024, season_type=2, week=1)
espn_cfl_season_week_powerindex
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/weeks/{week}/powerindex
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_type path parameter. | ||
week | week | Y | week path parameter. | ||
limit | limit | Y | Page size for this weekly power-index table; pass a limit large enough to avoid paging (table size varies by sport/league -- CFB's FBS table alone is ~134 rows). |
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 |
|---|---|---|
team_id | Int64 | |
season | Int64 | |
last_updated | String | |
run_date_time_key | Int64 | |
fpi | Float64 | |
fpirank | Float64 | |
projectedw | Float64 | |
projectedl | Float64 | |
projectedt | Float64 | |
record | Float64 | |
probwinout | Float64 | |
probwinconf | String | |
sosremainingrank | Float64 | |
accomplishment | String | |
accomplishmentrank | Float64 | |
adjwins | String | |
adjlosses | String | |
adjwinpctrank | Float64 | |
gamecontrol | String | |
gamecontrolrank | Float64 | |
adjavgingamewp | String | |
adjavgingamewprank | Float64 | |
avgingamewp | Float64 | |
avgingamewprank | Float64 | |
avgsosrank | Float64 | |
epaoffense | Float64 | |
epadefense | Float64 | |
epaspecialteams | Float64 | |
probwindiv | Float64 | |
offefficiency | Float64 | |
offefficiencyrank | Float64 | |
defefficiency | Float64 | |
defefficiencyrank | Float64 | |
stefficiency | Float64 | |
stefficiencyrank | Float64 | |
totefficiency | Float64 | |
totefficiencyrank | Float64 |
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
espn_cfl_season_week_powerindex(season=2024, season_type=2, week=8)
espn_cfl_season_week_games
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/types/{season_type}/weeks/{week}/events
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
season_type | season_type | Y | season_type path parameter. | ||
week | week | Y | week path parameter. | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_week_games(season=2024, season_type=2, week=1)
espn_cfl_season_teams
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/teams
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/teams?limit=1000&page=1
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
limit | limit | Y | Maximum number of items to return. | ||
page | page | Y | page 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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_teams(season=2024)
espn_cfl_season_team
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/teams/{team_id}
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/teams/4
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
team_id | team_id | Y | team_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_name | type | description |
|---|---|---|
$ref | String | |
abbreviation | String | |
alternate_color | String | |
color | String | |
display_name | String | |
guid | String | |
id | Int64 | |
is_active | Boolean | |
is_all_star | Boolean | |
links | String | |
location | String | |
logos | String | |
name | String | |
short_display_name | String | |
slug | String | |
uid | String | |
against_the_spread_records_$ref | String | |
awards_$ref | String | |
coaches_$ref | String | |
depth_charts_$ref | String | |
events_$ref | String | |
franchise_$ref | String | |
groups_$ref | String | |
injuries_$ref | String | |
leaders_$ref | String | |
notes_$ref | String | |
ranks_$ref | String | |
record_$ref | String | |
statistics_$ref | String | |
transactions_$ref | String | |
venue_$ref | String | |
venue_address_city | String | |
venue_address_state | String | |
venue_full_name | String | |
venue_grass | Boolean | |
venue_guid | String | |
venue_id | Int64 | |
venue_images | String | |
venue_indoor | Boolean | |
venue_short_name | 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
espn_cfl_season_team(season=2024, team_id='4')
espn_cfl_season_players
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/athletes
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
limit | limit | Y | Maximum number of items to return. | ||
page | page | Y | page 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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_players(season=2024)
espn_cfl_season_coaches
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/coaches
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/coaches?limit=500
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
$ref | 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
espn_cfl_season_coaches(season=2024)
espn_cfl_season_draft
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/draft
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/draft
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season 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_name | type | description |
|---|---|---|
$ref | String | Core v2 URL of this draft resource. |
display_name | String | Full name of the draft (e.g., "2024 National Basketball Association Draft"). |
links | String | JSON-encoded list of ESPN web links for the draft (href, rel, text). |
number_of_rounds | Int64 | Number of rounds in the draft. |
positions | String | JSON-encoded list of the position resources the draft uses (Core v2 $ref links with abbreviations). |
short_display_name | String | Short name of the draft (e.g., "2024 NBA Draft"). |
uid | String | ESPN universal id of the draft (e.g., "s:40 |
year | Int64 | Year the draft was held (e.g., 2024), the season in its Core v2 path. |
athletes_$ref | String | Core v2 URL of the draft's athlete (prospect) collection. |
rounds_$ref | String | Core v2 URL of the draft's rounds, which hold the picks. |
status_$ref | String | Core v2 URL of the draft's status resource. |
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
espn_cfl_season_draft(season=2024)
espn_cfl_season_draft_round_picks
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/draft/rounds/{round_num}/picks
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/draft/rounds/1/picks
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
round_num | round_num | Y | round_num path parameter. |
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: 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
| 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
espn_cfl_season_draft_round_picks(season=2024, round_num='1')
espn_cfl_season_futures
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/futures
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/futures
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season 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_name | type | description |
|---|---|---|
$ref | String | |
display_name | String | |
futures | String | |
id | Int64 | |
name | String | |
type | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_futures(season=2024)
espn_cfl_season_freeagents
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/freeagents
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/freeagents
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. |
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 nfl, mlb, nhl, cfb; 400 in nba, wnba, mbb, wbb with the documented example arguments (2026-10-07).
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
espn_cfl_season_freeagents(season=2024)
espn_cfl_season_powerindex
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/powerindex[/{team_id}]
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/powerindex
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
team_id | team_id | Y | team_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_name | type | description |
|---|---|---|
last_updated | String | |
max_game_date | String | |
run_cutoff_date | String | |
run_date_time_key | Int64 | |
season | Int64 | |
season_type | Int64 | |
stats | String | |
league_$ref | String | |
team_$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_powerindex(season=2024)
espn_cfl_season_powerindex_leaders
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/powerindex/leaders
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/powerindex/leaders
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season 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_name | type | description |
|---|---|---|
display_name | String | |
leaders | String | |
name | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_powerindex_leaders(season=2024)
espn_cfl_season_awards
ESPN endpoint.
Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/{season}/awards
Valid URL: https://sports.core.api.espn.com/v2/sports/football/leagues/cfl/seasons/2024/awards?limit=200
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | season path parameter. | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
$ref | String | |
count | Int64 | Total 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_count | Int64 | Pages 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
| 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
espn_cfl_season_awards(season=2024)