Skip to main content

Cricket — ESPN site API (v2)

sportsdataverse.cricket — 24 endpoints.

espn_cricket_scoreboard​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/scoreboard

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/scoreboard?dates=20240115&limit=500

API ParameterPythonPatternRequiredNullableDescription
datesdatesYOne day (YYYYMMDD) or one calendar year (YYYY). A range (YYYYMMDD-YYYYMMDD) is rejected with HTTP 400; request each day, or use the Core v2 events wrapper.
weekweekYWeek number within the season.
seasontypeseason_typeYSeason phase: 1=preseason, 2=regular season, 3=postseason.
groupsgroupsYConference or group id filter (e.g. an ESPN conference id).
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
event_idStringESPN event id for the match.
dateStringMatch start timestamp (ISO 8601, UTC).
nameStringFull event name (e.g. 'Team A at Team B').
short_nameStringAbbreviated event name (e.g. 'TA @ TB').
home_teamStringHome team display name.
home_team_idStringHome team ESPN id.
home_scoreStringHome team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)').
away_teamStringAway team display name.
away_team_idStringAway team ESPN id.
away_scoreStringAway team's score. For cricket, the innings string.
statusStringStatus type name (e.g. STATUS_FINAL, STATUS_SCHEDULED, STATUS_IN_PROGRESS).
status_detailStringHuman-readable status detail (e.g. 'Final', the over/innings summary).
venueStringFull name of the venue where the match was played.
neutral_siteBooleanWhether the match is played at a neutral venue.

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

espn_cricket_summary​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/summary

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/summary

API ParameterPythonPatternRequiredNullableDescription
eventevent_idYevent query parameter.

Returns​

return_parsed=True (default) — a dict of polars.DataFrames keyed by summary section (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

header

col_nametypedescription
idString
uidString
time_validBoolean
season_yearInt64
season_typeInt64ESPN season-phase numeric code (1=pre-season, 2=regular season, 3=postseason, 4=off-season).
season_slugString
league_idStringESPN numeric identifier for the league or competition.
league_nameString
league_abbreviationStringAbbreviation for the league or competition the game belongs to.
competition_idStringESPN numeric identifier for the primary competition (game) in the header.
competition_dateStringDate and time of the competition as recorded in the game header.
neutral_siteBoolean
status_nameString
status_descriptionString
is_finalStringBoolean flag indicating whether the game has reached a final or completed status.

matchcards_batting

col_nametypedescription
innings_numberStringInnings number within the match to which this batting or bowling entry belongs.
team_nameStringFull display name of the team.
totalString
runs_totalStringTotal runs scored by the team or batting side in this innings.
extrasStringAdditional runs awarded to the batting side from wides, no-balls, byes, or leg byes in this innings.
player_idString
player_nameString
dismissalStringMethod by which the batter was dismissed in this innings (e.g., caught, bowled, run out).
runsString
balls_facedStringTotal number of balls faced by the batter during their innings.
foursStringNumber of boundaries hit for four runs by the batter in this innings.
sixesStringNumber of boundaries hit for six runs by the batter in this innings.

matchcards_bowling

col_nametypedescription
innings_numberStringInnings number within the match to which this batting or bowling entry belongs.
team_nameStringFull display name of the team.
player_idString
player_nameString
oversStringNumber of overs bowled by the bowler in this innings.
maidensStringNumber of maiden overs bowled by the bowler in this innings, in which no runs were conceded.
concededStringTotal runs conceded by the bowler during their spell in this innings.
wicketsStringNumber of wickets taken by the bowler in this innings.
economy_rateStringAverage runs conceded per over by the bowler in this innings.
nbwStringCombined no-balls and wides bowled by the bowler in this innings.

matchcards_partnerships

col_nametypedescription
innings_numberStringInnings number within the match to which this batting or bowling entry belongs.
team_nameStringFull display name of the team.
partnership_runsStringTotal runs scored during the batting partnership for this fall-of-wicket record.
partnership_oversStringNumber of overs faced during the batting partnership for this fall-of-wicket record.
wicket_nameStringName or label identifying the wicket at which this batting partnership ended.
fow_typeStringType classification for this fall-of-wicket entry (e.g., caught, bowled, run out).
player1_nameStringName of the first batter in the batting partnership for this fall-of-wicket entry.
player1_runsStringRuns contributed by the first player in the batting partnership.
player2_nameStringName of the second batter in the batting partnership for this fall-of-wicket entry.
player2_runsStringRuns contributed by the second player in the batting partnership.

rosters

col_nametypedescription
team_idString
home_awayString
winnerBoolean
athlete_idString
athleteStringReference or identifier string for the athlete associated with this row in the box score.
jerseyString
starterBoolean
positionString
captainBooleanIndicates whether the player was designated as a team captain for this game.

game_info

col_nametypedescription
venue_idString
venue_full_nameString
venue_short_nameStringAbbreviated or shortened display name for the venue where the game was played.
venue_cityString
venue_countryStringCountry name for the venue where the game was played.
attendanceInt64
officialsString

standings

col_nametypedescription
groupString
teamString
team_idString
rankInt64
matches_playedInt64Total number of matches played by the team in the current stage or competition group.
matches_wonInt64Total number of matches won by the team in the current stage or competition group.
matches_lostInt64Total number of matches lost by the team in the current stage or competition group.
noresultInt64Number of matches that ended without a result (e.g., rain-affected or abandoned) for the team.
match_pointsInt64Total competition points accumulated by the team based on match outcomes in the group or stage.
qualifiedInt64Boolean qualification flag indicating whether the team has secured advancement from the current group or stage.
netrrFloat64Net Run Rate for the team, a tiebreaker metric used in cricket group standings.
forFloat64Total runs or score accumulated by the team across all matches in the group or stage.
againstFloat64Total runs or score conceded by the team across all matches in the group or stage.
totalString

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

espn_cricket_calendar​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/calendar

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/calendar

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

espn_cricket_news​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/news?limit=50

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
idInt64ESPN numeric identifier for the article.
now_idStringESPN 'now' feed id.
content_keyStringInternal content key.
data_source_identifierStringSource-system identifier.
typeStringArticle type (Story, Media, HeadlineNews, etc.).
headlineStringArticle headline.
descriptionStringArticle summary/description.
last_modifiedStringLast-modified timestamp (ISO 8601).
publishedStringPublish timestamp (ISO 8601).
imagesStringArticle images (list, stringified).
categoriesStringArticle categories (list, stringified).
premiumBooleanWhether the article is premium/paywalled.
bylineStringAuthor byline string as published by ESPN.
links_web_hrefStringWeb article URL.
links_mobile_hrefStringMobile article URL.
links_api_self_hrefStringESPN API canonical self-link for the article resource.
links_app_sportscenter_hrefStringSportsCenter app deep link.

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

espn_cricket_injuries​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/injuries

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
idInt64ESPN numeric identifier for the athlete.
display_nameStringAthlete's full display name as shown on ESPN.
injuriesStringInjury entries for the athlete (list of dicts, stringified): status, type, details, dates.

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

espn_cricket_transactions​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/transactions?limit=500

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
dateString
descriptionString
team_abbreviationString
team_alternate_colorString
team_colorString
team_display_nameString
team_idInt64
team_linksString
team_locationString
team_logosString
team_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_cricket_transactions(league='eng.1')

espn_cricket_conferences​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/groups

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/groups

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
group_idInt64
nameString
abbreviationString
short_nameString
is_conferenceBoolean
parent_group_idInt64
depthInt64
children_countInt64

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

espn_cricket_statistics_league​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/statistics

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/statistics

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, wnba, cfb, mbb, wbb, 2026-10-07); its rows sit under keys it does not read (top level: league, season, status, timestamp).

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

espn_cricket_draft​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/draft

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/draft

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, nhl, wnba, 2026-10-07); its rows sit under keys it does not read (top level: breakingNews, broadcasts, displayName, picks, positions, rounds, shortDisplayName, status).

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

espn_cricket_teams_site​

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams?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
team_abbreviationStringShort team abbreviation (e.g. "BOS").
team_alternate_colorStringSecondary team color as a hex string (no leading '#').
team_colorStringPrimary team color as a hex string (no leading '#').
team_display_nameStringFull team display name (location + nickname).
team_idInt64ESPN team id (stable join key across ESPN endpoints).
team_is_activeBooleanWhether the team is currently active.
team_is_all_starBooleanWhether the entry is an all-star squad rather than a franchise.
team_locationStringTeam location / city (e.g. "Boston").
team_logosStringPipe-delimited logo image URLs.
team_nameStringTeam nickname/mascot (e.g. "Celtics").
team_nicknameStringTeam nickname as ESPN labels it (often equals team_name).
team_short_display_nameStringAbbreviated display name for compact UIs.
team_slugStringURL slug used in ESPN web paths.
team_uidStringESPN global UID (encodes sport/league/team).

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

espn_cricket_team​

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/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
team_abbreviationString
team_alternate_colorString
team_colorString
team_display_nameString
team_franchise_$refString
team_franchise_abbreviationString
team_franchise_colorString
team_franchise_display_nameString
team_franchise_idInt64
team_franchise_is_activeBoolean
team_franchise_locationString
team_franchise_nameString
team_franchise_short_display_nameString
team_franchise_slugString
team_franchise_team_$refString
team_franchise_uidString
team_franchise_venue_$refString
team_franchise_venue_address_cityString
team_franchise_venue_address_stateString
team_franchise_venue_full_nameString
team_franchise_venue_grassBoolean
team_franchise_venue_guidString
team_franchise_venue_idInt64
team_franchise_venue_imagesString
team_franchise_venue_indoorBoolean
team_franchise_venue_short_nameString
team_groups_idInt64
team_groups_is_conferenceBoolean
team_groups_parent_idInt64
team_idInt64
team_is_activeBoolean
team_linksString
team_locationString
team_logosString
team_nameString
team_next_eventString
team_record_itemsString
team_short_display_nameString
team_slugString
team_standing_summaryString
team_uidString

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

espn_cricket_team_roster​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/roster

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/roster?limit=500

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_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
idInt64Id.
uidStringUid.
guidStringGuid.
first_nameStringFirst name.
last_nameStringLast name.
full_nameStringFull name.
display_nameStringDisplay name.
short_nameStringShort name.
weightFloat64Weight.
display_weightStringDisplay weight.
heightFloat64Height.
display_heightStringDisplay height.
ageInt64Age.
date_of_birthStringDate of birth.
debut_yearFloat64Debut year.
linksStringLinks.
slugStringSlug.
jerseyStringJersey.
injuriesStringInjuries.
teamsStringTeams.
contractsStringContracts.
alternate_ids_sdrStringAlternate ids sdr.
birth_place_cityStringBirth place city.
birth_place_countryStringBirth place country.
college_idInt64College id.
college_guidStringCollege guid.
college_mascotStringCollege mascot.
college_nameStringCollege name.
college_short_nameStringCollege short name.
college_abbrevStringCollege abbrev.
college_logosStringCollege logos.
headshot_hrefStringHeadshot href.
headshot_altStringHeadshot alt.
position_idInt64Position id.
position_nameStringPosition name.
position_display_nameStringPosition display name.
position_abbreviationStringPosition abbreviation.
position_leafBooleanPosition leaf.
experience_yearsInt64Experience years.
contract_bird_statusInt64Contract bird status.
contract_base_year_compensation_activeBooleanContract base year compensation active.
contract_poison_pill_provision_activeBooleanContract poison pill provision active.
contract_incoming_trade_valueInt64Contract incoming trade value.
contract_outgoing_trade_valueInt64Contract outgoing trade value.
contract_minimum_salary_exceptionBooleanContract minimum salary exception.
contract_option_typeInt64Contract option type.
contract_salaryInt64Contract salary.
contract_salary_remainingInt64Contract salary remaining.
contract_years_remainingInt64Contract years remaining.
contract_season_yearInt64Contract season year.
contract_season_start_dateStringContract season start date.
contract_season_end_dateStringContract season end date.
contract_trade_kicker_activeBooleanContract trade kicker active.
contract_trade_kicker_percentageFloat64Contract trade kicker percentage.
contract_trade_kicker_valueInt64Contract trade kicker value.
contract_trade_kicker_trade_valueInt64Contract trade kicker trade value.
contract_trade_restrictionBooleanContract trade restriction.
contract_unsigned_foreign_pickBooleanContract unsigned foreign pick.
contract_activeBooleanContract active.
status_idInt64Status id.
status_nameStringStatus name.
status_typeStringStatus type.
status_abbreviationStringStatus abbreviation.
citizenshipStringCitizenship.
birth_place_stateStringBirth place state.
hand_typeStringHand type.
hand_abbreviationStringHand abbreviation.
hand_display_valueStringHand display value.

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

espn_cricket_team_schedule​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/schedule

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/schedule

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id path parameter.
seasonseasonYSeason year (e.g. 2024).

Returns​

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

col_nametypedescription
idInt64ESPN numeric event identifier.
dateStringEvent timestamp (ISO 8601, UTC).
nameStringFull event name (e.g. 'Team A at Team B').
short_nameStringAbbreviated event name (e.g. 'TA @ TB').
time_validBooleanWhether the event time is confirmed.
competitionsStringCompetition detail (list of dicts, stringified): competitors, venue, status.
linksStringRelated links (list, stringified).
season_yearInt64Four-digit season year.
season_display_nameStringHuman-readable season label (e.g. '2024-25').
season_type_idInt64ESPN numeric identifier for the season type.
season_type_typeInt64Season type numeric code.
season_type_nameStringSeason type name (e.g. Regular Season).
season_type_abbreviationStringSeason type abbreviation.

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

espn_cricket_team_record​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/record

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/record

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id 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: ESPN answers an empty object 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_cricket_team_record(league='eng.1', team_id='4')

espn_cricket_team_depthcharts​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/depthcharts

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/depthcharts

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id 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: depthchart, season, status, team, timestamp).

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

espn_cricket_team_injuries​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/injuries

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
idInt64ESPN numeric identifier for the athlete.
display_nameStringAthlete's full display name as shown on ESPN.
injuriesStringInjury entries for the athlete (list of dicts, stringified): status, type, details, dates.

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

espn_cricket_team_transactions​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/transactions

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id 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: ESPN answers an empty object 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_cricket_team_transactions(league='eng.1', team_id='4')

espn_cricket_team_history​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/history

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/history

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id 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: ESPN answers an empty object in nba, nfl, mlb, nhl, wnba, mbb, wbb; 400 in cfb 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_cricket_team_history(league='eng.1', team_id='4')

espn_cricket_team_news​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/news?limit=50

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_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
idInt64ESPN numeric identifier for the article.
now_idStringESPN 'now' feed id.
content_keyStringInternal content key.
data_source_identifierStringSource-system identifier.
typeStringArticle type (Story, Media, HeadlineNews, etc.).
headlineStringArticle headline.
descriptionStringArticle summary/description.
last_modifiedStringLast-modified timestamp (ISO 8601).
publishedStringPublish timestamp (ISO 8601).
imagesStringArticle images (list, stringified).
categoriesStringArticle categories (list, stringified).
premiumBooleanWhether the article is premium/paywalled.
bylineStringAuthor byline string as published by ESPN.
links_web_hrefStringWeb article URL.
links_mobile_hrefStringMobile article URL.
links_api_self_hrefStringESPN API canonical self-link for the article resource.
links_app_sportscenter_hrefStringSportsCenter app deep link.

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

espn_cricket_team_leaders​

Deprecated: ESPN answers this team route with an empty object.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/{team_id}/leaders

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/teams/4/leaders

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_id 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: ESPN answers an empty object 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_cricket_team_leaders(league='eng.1', team_id='4')

espn_cricket_player_info​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/athletes/{athlete_id}

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/athletes/4239

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id 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.

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

espn_cricket_player_bio​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/athletes/{athlete_id}/bio

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/athletes/4239/bio

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id 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.

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

espn_cricket_player_news​

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/athletes/{athlete_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/cricket/eng.1/athletes/4239/news

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_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
idInt64ESPN numeric identifier for the article.
now_idStringESPN 'now' feed id.
content_keyStringInternal content key.
data_source_identifierStringSource-system identifier.
typeStringArticle type (Story, Media, HeadlineNews, etc.).
headlineStringArticle headline.
descriptionStringArticle summary/description.
last_modifiedStringLast-modified timestamp (ISO 8601).
publishedStringPublish timestamp (ISO 8601).
imagesStringArticle images (list, stringified).
categoriesStringArticle categories (list, stringified).
premiumBooleanWhether the article is premium/paywalled.
bylineStringAuthor byline string as published by ESPN.
links_web_hrefStringWeb article URL.
links_mobile_hrefStringMobile article URL.
links_api_self_hrefStringESPN API canonical self-link for the article resource.
links_app_sportscenter_hrefStringSportsCenter app deep link.

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

espn_cricket_standings​

ESPN endpoint.

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

Valid URL: https://site.api.espn.com/apis/v2/sports/cricket/eng.1/standings

API ParameterPythonPatternRequiredNullableDescription
seasonseasonYSeason year (e.g. 2024).
groupgroupYConference or group id filter (e.g. an ESPN conference id).
typestandings_typeYStandings variant (e.g. 'by-division' or 'by-conference').

Returns​

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

col_nametypedescription
groupStringConference/group/table the row belongs to, flattened from the standings children hierarchy.
teamStringDisplay name of the team in this standings row.
team_idStringESPN numeric identifier for the team.
team_abbreviationStringTeam abbreviation.
rankInt64Position within the group/table.
matches_playedInt64Matches played (cricket).
matches_wonInt64Matches won (cricket).
matches_lostInt64Matches lost (cricket).
noresultInt64Matches with no result (cricket).
match_pointsInt64Competition points (cricket).
qualifiedInt64Qualification flag (cricket).
netrrFloat64Net run rate (cricket).
forFloat64Runs/goals for.
againstFloat64Runs/goals against.
totalStringAggregate/summary value as published by ESPN.

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