SOCCER — ESPN core API (v2) — Other

espn_soccer_league_root

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_league_root()

Last validated n/a.

espn_soccer_seasons

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/seasons

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/seasons

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_seasons()

Last validated n/a.

espn_soccer_games

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/events

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/events

API Parameter	Python	Pattern	Required	Nullable	Description
dates	dates			Y	Date or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_games()

Last validated n/a.

espn_soccer_game

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/events/{event_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/events/401584793

API Parameter	Python	Pattern	Required	Nullable	Description
event_id	event_id		Y		event_id path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_game(event_id='401584793')

Last validated n/a.

espn_soccer_teams_core

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/teams

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/teams

API Parameter	Python	Pattern	Required	Nullable	Description
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
team_id	character	ESPN numeric identifier for the team.
display_name	character	Full display name of the team (e.g. 'Los Angeles Lakers').
abbreviation	character	Team abbreviation.
location	character	Team location/city.
name	character	Short team name, typically the mascot (e.g. 'Lakers').
short_display_name	character	Short team display name.
nickname	character	Alternative nickname used by ESPN for the team.
slug	character	URL slug for the team.
uid	character	ESPN universal id for the team.
color	character	Primary team color (hex).
alternate_color	character	Secondary team color (hex).
is_active	logical	Whether the team is currently active.
is_all_star	logical	Whether the team is an all-star side.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_teams_core()

Last validated n/a.

espn_soccer_team_core

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/teams/{team_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/teams/4

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_team_core(team_id='4')

Last validated n/a.

espn_soccer_venues

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/venues

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/venues

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_venues()

Last validated n/a.

espn_soccer_venue

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/venues/{venue_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/venues/3663

API Parameter	Python	Pattern	Required	Nullable	Description
venue_id	venue_id		Y		venue_id path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_venue(venue_id='3663')

Last validated n/a.

espn_soccer_franchises

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/franchises

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/franchises

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_franchises()

Last validated n/a.

espn_soccer_franchise

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/franchises/{franchise_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/franchises/2

API Parameter	Python	Pattern	Required	Nullable	Description
franchise_id	franchise_id		Y		franchise_id path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_franchise(franchise_id='2')

Last validated n/a.

espn_soccer_coach

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/coaches/{coach_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/coaches/1

API Parameter	Python	Pattern	Required	Nullable	Description
coach_id	coach_id		Y		coach_id path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_coach(coach_id='1')

Last validated n/a.

espn_soccer_coach_record

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/coaches/1/record

API Parameter	Python	Pattern	Required	Nullable	Description
coach_id	coach_id		Y		coach_id path parameter.
record_type	record_type			Y	record_type path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_coach_record(coach_id='1')

Last validated n/a.

espn_soccer_coach_season

ESPN endpoint.

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

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

API Parameter	Python	Pattern	Required	Nullable	Description
coach_id	coach_id		Y		coach_id path parameter.
season	season		Y		season path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

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

Last validated n/a.

espn_soccer_positions

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/positions

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/positions

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_positions()

Last validated n/a.

espn_soccer_position

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/positions/{position_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/positions/1

API Parameter	Python	Pattern	Required	Nullable	Description
position_id	position_id		Y		position_id path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_position(position_id='1')

Last validated n/a.

espn_soccer_tournaments

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/tournaments

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/tournaments

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_tournaments()

Last validated n/a.

espn_soccer_awards

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/awards

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/awards

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_awards()

Last validated n/a.

espn_soccer_award

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/awards/{award_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/awards/1

API Parameter	Python	Pattern	Required	Nullable	Description
award_id	award_id		Y		award_id path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_award(award_id='1')

Last validated n/a.

espn_soccer_standings_core

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/standings

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/standings

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
group	character	Conference/group/table the row belongs to, flattened from the standings children hierarchy.
team	character	Display name of the team in this standings row.
team_id	character	ESPN numeric identifier for the team.
team_abbreviation	character	Team abbreviation.
note	character	Standings note (e.g. qualification/relegation marker).
games_played	double	Matches played.
losses	double	Number of matches the team has lost.
point_differential	double	Goal difference (for minus against).
points	double	Competition points.
points_against	double	Goals conceded.
points_for	double	Goals (or runs) scored by the team.
ties	double	Number of matches the team has drawn.
wins	double	Number of matches the team has won.
advanced	double	Whether the team has advanced/qualified.
deductions	double	Points deducted.
ppg	double	Points per game.
rank	double	Position within the group/table.
rank_change	double	Change in rank versus the previous update.
overall	character	Overall record summary as published by ESPN.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_standings_core()

Last validated n/a.

espn_soccer_leaders_core

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/leaders

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/leaders

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_leaders_core()

Last validated n/a.

espn_soccer_league_notes

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/notes

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/notes

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_league_notes()

Last validated n/a.

espn_soccer_talentpicks

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/talentpicks

Valid URL: https://sports.core.api.espn.com/v2/sports/soccer/leagues/eng.1/talentpicks

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

return_parsed=True (default) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_soccer_talentpicks()

Last validated n/a.