Skip to main content
Version: 0.1.5

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
$refcharacter
abbreviationcharacter
colorcharacter
display_namecharacter
gendercharacter
guidcharacter
idcharacter
is_tournamentlogical
linkscharacter
logoscharacter
namecharacter
short_namecharacter
slugcharacter
uidcharacter
athletes_$refcharacter
awards_$refcharacter
calendar_$refcharacter
draft_$refcharacter
events_$refcharacter
franchises_$refcharacter
group_$refcharacter
groups_$refcharacter
leaders_$refcharacter
notes_$refcharacter
rankings_$refcharacter
season_$refcharacter
season_athletes_$refcharacter
season_coaches_$refcharacter
season_display_namecharacter
season_end_datecharacter
season_futures_$refcharacter
season_power_index_leaders_$refcharacter
season_power_indexes_$refcharacter
season_rankings_$refcharacter
season_start_datecharacter
season_type_$refcharacter
season_type_abbreviationcharacter
season_type_corrections_$refcharacter
season_type_end_datecharacter
season_type_groups_$refcharacter
season_type_has_groupslogical
season_type_has_legslogical
season_type_has_standingslogical
season_type_idcharacter
season_type_namecharacter
season_type_slugcharacter
season_type_start_datecharacter
season_type_typeinteger
season_type_weeks_$refcharacter
season_type_yearinteger
season_types_$refcharacter
season_types_countinteger
season_types_itemscharacter
season_types_page_countinteger
season_types_page_indexinteger
season_types_page_sizeinteger
season_yearinteger
seasons_$refcharacter
teams_$refcharacter
transactions_$refcharacter

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

Example​

espn_cricket_league_root(league='eng.1')

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?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

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

col_nametypedescription
$refcharacter

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

Example​

espn_cricket_seasons(league='eng.1')

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?limit=500

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

Returns​

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

col_nametypedescription
$refcharacter

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

Example​

espn_cricket_games(league='eng.1')

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
$refcharacter
competitionscharacter
datecharacter
idcharacter
linkscharacter
namecharacter
short_namecharacter
time_validlogical
uidcharacter
venuescharacter
league_$refcharacter
season_$refcharacter
season_type_$refcharacter

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

Example​

espn_cricket_game(league='eng.1', 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?limit=1000&page=1

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

Returns​

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

col_nametypedescription
team_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(league='eng.1')

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
$refcharacter
abbreviationcharacter
alternate_colorcharacter
colorcharacter
display_namecharacter
guidcharacter
idcharacter
is_activelogical
is_all_starlogical
linkscharacter
locationcharacter
logoscharacter
namecharacter
short_display_namecharacter
slugcharacter
uidcharacter
against_the_spread_records_$refcharacter
athletes_$refcharacter
awards_$refcharacter
coaches_$refcharacter
depth_charts_$refcharacter
events_$refcharacter
franchise_$refcharacter
groups_$refcharacter
injuries_$refcharacter
notes_$refcharacter
odds_records_$refcharacter
ranks_$refcharacter
record_$refcharacter
transactions_$refcharacter
venue_$refcharacter
venue_address_citycharacter
venue_address_statecharacter
venue_full_namecharacter
venue_grasslogical
venue_guidcharacter
venue_idcharacter
venue_imagescharacter
venue_indoorlogical
venue_short_namecharacter

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

Example​

espn_cricket_team_core(league='eng.1', 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?limit=1000

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

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

col_nametypedescription
$refcharacter

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

Example​

espn_cricket_venues(league='eng.1')

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
$refcharacter
full_namecharacter
grasslogical
guidcharacter
idcharacter
imagescharacter
indoorlogical

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

Example​

espn_cricket_venue(league='eng.1', 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?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

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

col_nametypedescription
$refcharacter

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

Example​

espn_cricket_franchises(league='eng.1')

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
$refcharacter
abbreviationcharacter
colorcharacter
display_namecharacter
idcharacter
is_activelogical
locationcharacter
namecharacter
short_display_namecharacter
slugcharacter
uidcharacter
team_$refcharacter
venue_$refcharacter
venue_address_citycharacter
venue_address_statecharacter
venue_full_namecharacter
venue_grasslogical
venue_guidcharacter
venue_idcharacter
venue_imagescharacter
venue_indoorlogical
venue_short_namecharacter

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

Example​

espn_cricket_franchise(league='eng.1', 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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
$refcharacter
career_recordscharacter
coach_seasonscharacter
experienceinteger
first_namecharacter
idcharacter
last_namecharacter
uidcharacter
birth_place_citycharacter
birth_place_statecharacter

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

Example​

espn_cricket_coach(league='eng.1', 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/0

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.
record_typerecord_typeYrecord_type path parameter.

Returns​

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

col_nametypedescription
$refcharacter
display_valuecharacter
idcharacter
namecharacter
statscharacter
summarycharacter
typecharacter
valuedouble

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

Example​

espn_cricket_coach_record(league='eng.1', 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) — the output of parse_single_entity; pass return_as_pandas=True for a pandas.DataFrame.

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

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

Example​

espn_cricket_coach_season(league='eng.1', 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?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

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

col_nametypedescription
$refcharacter

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

Example​

espn_cricket_positions(league='eng.1')

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
$refcharacter
abbreviationcharacter
display_namecharacter
idcharacter
leaflogical
namecharacter
parent_$refcharacter

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

Example​

espn_cricket_position(league='eng.1', 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?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

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

col_nametypedescription
$refcharacter

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

Example​

espn_cricket_tournaments(league='eng.1')

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?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

Returns​

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

col_nametypedescription
$refcharacter

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

Example​

espn_cricket_awards(league='eng.1')

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
countinteger
itemscharacter
page_countinteger
page_indexinteger
page_sizeinteger

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

Example​

espn_cricket_award(league='eng.1', 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(league='eng.1')

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) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

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

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

Example​

espn_cricket_leaders_core(league='eng.1')

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) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

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

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

Example​

espn_cricket_league_notes(league='eng.1')

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 with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
pick_competition_$refcharacter
pick_competitor_$refcharacter
pick_correctlogical
pick_person_display_namecharacter
pick_person_first_namecharacter
pick_person_headshot_altcharacter
pick_person_headshot_hrefcharacter
pick_person_idcharacter
pick_person_last_namecharacter
week_record_display_valuecharacter
week_record_season_$refcharacter
week_record_statscharacter

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

Example​

espn_cricket_talentpicks(league='eng.1')

Last validated n/a.