Skip to main content

CRICKET — ESPN core API (v2) — Other

espn_cricket_league_root​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

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_cricket_league_root()

Last validated n/a.

espn_cricket_seasons​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum 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_cricket_seasons()

Last validated n/a.

espn_cricket_games​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
limitlimitYMaximum number of items to return.

Returns​

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

Example​

espn_cricket_games()

Last validated n/a.

espn_cricket_game​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
event_idevent_idYevent_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_cricket_game(event_id='401584793')

Last validated n/a.

espn_cricket_teams_core​

ESPN endpoint.

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

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

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

Returns​

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

col_nametypedescription
team_abbreviationcharacterShort team abbreviation (e.g. "BOS").
team_alternate_colorcharacterSecondary team color as a hex string (no leading '#').
team_colorcharacterPrimary team color as a hex string (no leading '#').
team_display_namecharacterFull team display name (location + nickname).
team_idcharacterESPN team id (stable join key across ESPN endpoints).
team_is_activelogicalWhether the team is currently active.
team_is_all_starlogicalWhether the entry is an all-star squad rather than a franchise.
team_locationcharacterTeam location / city (e.g. "Boston").
team_logoscharacterPipe-delimited logo image URLs.
team_namecharacterTeam nickname/mascot (e.g. "Celtics").
team_nicknamecharacterTeam nickname as ESPN labels it (often equals team_name).
team_short_display_namecharacterAbbreviated display name for compact UIs.
team_slugcharacterURL slug used in ESPN web paths.
team_uidcharacterESPN global UID (encodes sport/league/team).

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

Example​

espn_cricket_teams_core()

Last validated n/a.

espn_cricket_team_core​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_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_cricket_team_core(team_id='4')

Last validated n/a.

espn_cricket_venues​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum 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_cricket_venues()

Last validated n/a.

espn_cricket_venue​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
venue_idvenue_idYvenue_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_cricket_venue(venue_id='3663')

Last validated n/a.

espn_cricket_franchises​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum 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_cricket_franchises()

Last validated n/a.

espn_cricket_franchise​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
franchise_idfranchise_idYfranchise_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_cricket_franchise(franchise_id='2')

Last validated n/a.

espn_cricket_coach​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_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_cricket_coach(coach_id='1')

Last validated n/a.

espn_cricket_coach_record​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.
record_typerecord_typeYrecord_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_cricket_coach_record(coach_id='1')

Last validated n/a.

espn_cricket_coach_season​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.
seasonseasonYseason 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_cricket_coach_season(coach_id='1', season=2024)

Last validated n/a.

espn_cricket_positions​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum 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_cricket_positions()

Last validated n/a.

espn_cricket_position​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
position_idposition_idYposition_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_cricket_position(position_id='1')

Last validated n/a.

espn_cricket_tournaments​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum 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_cricket_tournaments()

Last validated n/a.

espn_cricket_awards​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum 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_cricket_awards()

Last validated n/a.

espn_cricket_award​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
award_idaward_idYaward_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_cricket_award(award_id='1')

Last validated n/a.

espn_cricket_standings_core​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

Returns​

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

col_nametypedescription
groupcharacterConference/group/table the row belongs to, flattened from the standings children hierarchy.
teamcharacterDisplay name of the team in this standings row.
team_idcharacterESPN numeric identifier for the team.
team_abbreviationcharacterTeam abbreviation.
rankintegerPosition within the group/table.
matches_playedintegerMatches played (cricket).
matches_wonintegerMatches won (cricket).
matches_lostintegerMatches lost (cricket).
noresultintegerMatches with no result (cricket).
match_pointsintegerCompetition points (cricket).
qualifiedintegerQualification flag (cricket).
netrrdoubleNet run rate (cricket).
fordoubleRuns/goals for.
againstdoubleRuns/goals against.
totalcharacterAggregate/summary value as published by ESPN.

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

Example​

espn_cricket_standings_core()

Last validated n/a.

espn_cricket_leaders_core​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

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_cricket_leaders_core()

Last validated n/a.

espn_cricket_league_notes​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

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_cricket_league_notes()

Last validated n/a.

espn_cricket_talentpicks​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

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_cricket_talentpicks()

Last validated n/a.