Skip to main content

UEFA Champions League — ESPN core API (v2) — Season

espn_ucl_season_pointer​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/season

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/season

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
display_nameString
end_dateString
start_dateString
yearInt64
athletes_$refString
coaches_$refString
futures_$refString
power_index_leaders_$refString
power_indexes_$refString
rankings_$refString
type_$refString
type_abbreviationString
type_corrections_$refString
type_end_dateString
type_groups_$refString
type_has_groupsBoolean
type_has_legsBoolean
type_has_standingsBoolean
type_idInt64
type_nameString
type_slugString
type_start_dateString
type_typeInt64
type_weeks_$refString
type_yearInt64
types_$refString
types_countInt64
types_itemsString
types_page_countInt64
types_page_indexInt64
types_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_ucl_season_pointer()

espn_ucl_season_info​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason 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_nameString
end_dateString
start_dateString
yearInt64
awards_$refString
futures_$refString
leaders_$refString
power_index_leaders_$refString
power_indexes_$refString
rankings_$refString
type_$refString
type_abbreviationString
type_corrections_$refString
type_end_dateString
type_groups_$refString
type_has_groupsBoolean
type_has_legsBoolean
type_has_standingsBoolean
type_idInt64
type_leaders_$refString
type_nameString
type_slugString
type_start_dateString
type_typeInt64
type_weeks_$refString
type_yearInt64
types_$refString
types_countInt64
types_itemsString
types_page_countInt64
types_page_indexInt64
types_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_ucl_season_info(season=2024)

espn_ucl_season_types​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason 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
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_ucl_season_types(season=2024)

espn_ucl_season_type​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_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
abbreviationString
end_dateString
has_groupsBoolean
has_legsBoolean
has_standingsBoolean
idInt64
nameString
slugString
start_dateString
typeInt64
yearInt64
corrections_$refString
groups_$refString
leaders_$refString
weeks_$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_ucl_season_type(season=2024, season_type=2)

espn_ucl_season_group​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/groups/{group_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/groups/80

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_type path parameter.
group_idgroup_idYgroup_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
idInt64
is_conferenceBoolean
linksString
midsize_nameString
nameString
short_nameString
slugString
uidString
children_$refString
parent_$refString
season_$refString
standings_$refString
teams_$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_ucl_season_group(season=2024, season_type=2, group_id=80)

espn_ucl_season_groups​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/groups

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/groups

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_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
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_ucl_season_groups(season=2024, season_type=2)

espn_ucl_season_group_teams​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/groups/{group_id}/teams

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/groups/80/teams?limit=500

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_type path parameter.
group_idgroup_idYgroup_id path parameter.
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_ucl_season_group_teams(season=2024, season_type=2, group_id=80)

espn_ucl_season_group_children​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/groups/{group_id}/children

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/groups/80/children?limit=500

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_type path parameter.
group_idgroup_idYgroup_id path parameter.
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_ucl_season_group_children(season=2024, season_type=2, group_id=80)

espn_ucl_season_type_leaders​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/leaders

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_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​

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_ucl_season_type_leaders(season=2024, season_type=2)

espn_ucl_season_type_corrections​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/corrections

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/corrections

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_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
athlete_$refString
competition_$refString
split_stats_abbreviationString
split_stats_categoriesString
split_stats_idInt64
split_stats_nameString
team_$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_ucl_season_type_corrections(season=2024, season_type=2)

espn_ucl_season_weeks​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/weeks

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/weeks

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_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
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_ucl_season_weeks(season=2024, season_type=2)

espn_ucl_season_week​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/weeks/{week}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/weeks/1

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_type path parameter.
weekweekYweek 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
end_dateString
numberInt64
start_dateString
textString
rankings_$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_ucl_season_week(season=2024, season_type=2, week=1)

espn_ucl_season_week_powerindex​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/weeks/{week}/powerindex

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/weeks/8/powerindex

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_type path parameter.
weekweekYweek path parameter.
limitlimitYPage 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_nametypedescription
team_idInt64
seasonInt64
last_updatedString
run_date_time_keyInt64
fpiFloat64
fpirankFloat64
projectedwFloat64
projectedlFloat64
projectedtFloat64
recordFloat64
probwinoutFloat64
probwinconfString
sosremainingrankFloat64
accomplishmentString
accomplishmentrankFloat64
adjwinsString
adjlossesString
adjwinpctrankFloat64
gamecontrolString
gamecontrolrankFloat64
adjavgingamewpString
adjavgingamewprankFloat64
avgingamewpFloat64
avgingamewprankFloat64
avgsosrankFloat64
epaoffenseFloat64
epadefenseFloat64
epaspecialteamsFloat64
probwindivFloat64
offefficiencyFloat64
offefficiencyrankFloat64
defefficiencyFloat64
defefficiencyrankFloat64
stefficiencyFloat64
stefficiencyrankFloat64
totefficiencyFloat64
totefficiencyrankFloat64

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_ucl_season_week_powerindex(season=2024, season_type=2, week=8)

espn_ucl_season_week_games​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/types/{season_type}/weeks/{week}/events

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/types/2/weeks/1/events?limit=500

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
season_typeseason_typeYseason_type path parameter.
weekweekYweek path parameter.
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_ucl_season_week_games(season=2024, season_type=2, week=1)

espn_ucl_season_teams​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/teams

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/teams?limit=1000&page=1

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
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
$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_ucl_season_teams(season=2024)

espn_ucl_season_team​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/teams/{team_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/teams/4

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
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
awards_$refString
coaches_$refString
depth_charts_$refString
events_$refString
franchise_$refString
groups_$refString
injuries_$refString
leaders_$refString
notes_$refString
ranks_$refString
record_$refString
statistics_$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_ucl_season_team(season=2024, team_id='4')

espn_ucl_season_players​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/athletes

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/athletes?limit=100&page=1

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
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
$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_ucl_season_players(season=2024)

espn_ucl_season_coaches​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/coaches

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/coaches?limit=500

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
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

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_ucl_season_coaches(season=2024)

espn_ucl_season_draft​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/draft

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/draft

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason 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
$refStringCore v2 URL of this draft resource.
display_nameStringFull name of the draft (e.g., "2024 National Basketball Association Draft").
linksStringJSON-encoded list of ESPN web links for the draft (href, rel, text).
number_of_roundsInt64Number of rounds in the draft.
positionsStringJSON-encoded list of the position resources the draft uses (Core v2 $ref links with abbreviations).
short_display_nameStringShort name of the draft (e.g., "2024 NBA Draft").
uidStringESPN universal id of the draft (e.g., "s:40l:46e:draft~y:2024").
yearInt64Year the draft was held (e.g., 2024), the season in its Core v2 path.
athletes_$refStringCore v2 URL of the draft's athlete (prospect) collection.
rounds_$refStringCore v2 URL of the draft's rounds, which hold the picks.
status_$refStringCore v2 URL of the draft's status resource.

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_ucl_season_draft(season=2024)

espn_ucl_season_draft_round_picks​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/draft/rounds/{round_num}/picks

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/draft/rounds/1/picks

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
round_numround_numYround_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​

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_ucl_season_draft_round_picks(season=2024, round_num='1')

espn_ucl_season_futures​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/futures

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/futures

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason 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_nameString
futuresString
idInt64
nameString
typeString
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_ucl_season_futures(season=2024)

espn_ucl_season_freeagents​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/freeagents

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/freeagents

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason 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​

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_ucl_season_freeagents(season=2024)

espn_ucl_season_powerindex​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/powerindex[/{team_id}]

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/powerindex

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
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
last_updatedString
max_game_dateString
run_cutoff_dateString
run_date_time_keyInt64
seasonInt64
season_typeInt64
statsString
league_$refString
team_$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_ucl_season_powerindex(season=2024)

espn_ucl_season_powerindex_leaders​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/powerindex/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/powerindex/leaders

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason 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
display_nameString
leadersString
nameString
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_ucl_season_powerindex_leaders(season=2024)

espn_ucl_season_awards​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/{season}/awards

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/uefa.champions/seasons/2024/awards?limit=200

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYseason path parameter.
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_ucl_season_awards(season=2024)