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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
dates | dates | Y | One 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. | ||
week | week | Y | Week number within the season. | ||
seasontype | season_type | Y | Season phase: 1=preseason, 2=regular season, 3=postseason. | ||
groups | groups | Y | Conference or group id filter (e.g. an ESPN conference id). | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
event_id | String | ESPN event id for the match. |
date | String | Match start timestamp (ISO 8601, UTC). |
name | String | Full event name (e.g. 'Team A at Team B'). |
short_name | String | Abbreviated event name (e.g. 'TA @ TB'). |
home_team | String | Home team display name. |
home_team_id | String | Home team ESPN id. |
home_score | String | Home team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)'). |
away_team | String | Away team display name. |
away_team_id | String | Away team ESPN id. |
away_score | String | Away team's score. For cricket, the innings string. |
status | String | Status type name (e.g. STATUS_FINAL, STATUS_SCHEDULED, STATUS_IN_PROGRESS). |
status_detail | String | Human-readable status detail (e.g. 'Final', the over/innings summary). |
venue | String | Full name of the venue where the match was played. |
neutral_site | Boolean | Whether the match is played at a neutral venue. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
event | event_id | Y | event 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_name | type | description |
|---|---|---|
id | String | |
uid | String | |
time_valid | Boolean | |
season_year | Int64 | |
season_type | Int64 | ESPN season-phase numeric code (1=pre-season, 2=regular season, 3=postseason, 4=off-season). |
season_slug | String | |
league_id | String | ESPN numeric identifier for the league or competition. |
league_name | String | |
league_abbreviation | String | Abbreviation for the league or competition the game belongs to. |
competition_id | String | ESPN numeric identifier for the primary competition (game) in the header. |
competition_date | String | Date and time of the competition as recorded in the game header. |
neutral_site | Boolean | |
status_name | String | |
status_description | String | |
is_final | String | Boolean flag indicating whether the game has reached a final or completed status. |
matchcards_batting
| col_name | type | description |
|---|---|---|
innings_number | String | Innings number within the match to which this batting or bowling entry belongs. |
team_name | String | Full display name of the team. |
total | String | |
runs_total | String | Total runs scored by the team or batting side in this innings. |
extras | String | Additional runs awarded to the batting side from wides, no-balls, byes, or leg byes in this innings. |
player_id | String | |
player_name | String | |
dismissal | String | Method by which the batter was dismissed in this innings (e.g., caught, bowled, run out). |
runs | String | |
balls_faced | String | Total number of balls faced by the batter during their innings. |
fours | String | Number of boundaries hit for four runs by the batter in this innings. |
sixes | String | Number of boundaries hit for six runs by the batter in this innings. |
matchcards_bowling
| col_name | type | description |
|---|---|---|
innings_number | String | Innings number within the match to which this batting or bowling entry belongs. |
team_name | String | Full display name of the team. |
player_id | String | |
player_name | String | |
overs | String | Number of overs bowled by the bowler in this innings. |
maidens | String | Number of maiden overs bowled by the bowler in this innings, in which no runs were conceded. |
conceded | String | Total runs conceded by the bowler during their spell in this innings. |
wickets | String | Number of wickets taken by the bowler in this innings. |
economy_rate | String | Average runs conceded per over by the bowler in this innings. |
nbw | String | Combined no-balls and wides bowled by the bowler in this innings. |
matchcards_partnerships
| col_name | type | description |
|---|---|---|
innings_number | String | Innings number within the match to which this batting or bowling entry belongs. |
team_name | String | Full display name of the team. |
partnership_runs | String | Total runs scored during the batting partnership for this fall-of-wicket record. |
partnership_overs | String | Number of overs faced during the batting partnership for this fall-of-wicket record. |
wicket_name | String | Name or label identifying the wicket at which this batting partnership ended. |
fow_type | String | Type classification for this fall-of-wicket entry (e.g., caught, bowled, run out). |
player1_name | String | Name of the first batter in the batting partnership for this fall-of-wicket entry. |
player1_runs | String | Runs contributed by the first player in the batting partnership. |
player2_name | String | Name of the second batter in the batting partnership for this fall-of-wicket entry. |
player2_runs | String | Runs contributed by the second player in the batting partnership. |
rosters
| col_name | type | description |
|---|---|---|
team_id | String | |
home_away | String | |
winner | Boolean | |
athlete_id | String | |
athlete | String | Reference or identifier string for the athlete associated with this row in the box score. |
jersey | String | |
starter | Boolean | |
position | String | |
captain | Boolean | Indicates whether the player was designated as a team captain for this game. |
game_info
| col_name | type | description |
|---|---|---|
venue_id | String | |
venue_full_name | String | |
venue_short_name | String | Abbreviated or shortened display name for the venue where the game was played. |
venue_city | String | |
venue_country | String | Country name for the venue where the game was played. |
attendance | Int64 | |
officials | String |
standings
| col_name | type | description |
|---|---|---|
group | String | |
team | String | |
team_id | String | |
rank | Int64 | |
matches_played | Int64 | Total number of matches played by the team in the current stage or competition group. |
matches_won | Int64 | Total number of matches won by the team in the current stage or competition group. |
matches_lost | Int64 | Total number of matches lost by the team in the current stage or competition group. |
noresult | Int64 | Number of matches that ended without a result (e.g., rain-affected or abandoned) for the team. |
match_points | Int64 | Total competition points accumulated by the team based on match outcomes in the group or stage. |
qualified | Int64 | Boolean qualification flag indicating whether the team has secured advancement from the current group or stage. |
netrr | Float64 | Net Run Rate for the team, a tiebreaker metric used in cricket group standings. |
for | Float64 | Total runs or score accumulated by the team across all matches in the group or stage. |
against | Float64 | Total runs or score conceded by the team across all matches in the group or stage. |
total | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
id | Int64 | ESPN numeric identifier for the article. |
now_id | String | ESPN 'now' feed id. |
content_key | String | Internal content key. |
data_source_identifier | String | Source-system identifier. |
type | String | Article type (Story, Media, HeadlineNews, etc.). |
headline | String | Article headline. |
description | String | Article summary/description. |
last_modified | String | Last-modified timestamp (ISO 8601). |
published | String | Publish timestamp (ISO 8601). |
images | String | Article images (list, stringified). |
categories | String | Article categories (list, stringified). |
premium | Boolean | Whether the article is premium/paywalled. |
byline | String | Author byline string as published by ESPN. |
links_web_href | String | Web article URL. |
links_mobile_href | String | Mobile article URL. |
links_api_self_href | String | ESPN API canonical self-link for the article resource. |
links_app_sportscenter_href | String | SportsCenter app deep link. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 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 |
|---|---|---|
id | Int64 | ESPN numeric identifier for the athlete. |
display_name | String | Athlete's full display name as shown on ESPN. |
injuries | String | Injury entries for the athlete (list of dicts, stringified): status, type, details, dates. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
date | String | |
description | String | |
team_abbreviation | String | |
team_alternate_color | String | |
team_color | String | |
team_display_name | String | |
team_id | Int64 | |
team_links | String | |
team_location | String | |
team_logos | String | |
team_name | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 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_id | Int64 | |
name | String | |
abbreviation | String | |
short_name | String | |
is_conference | Boolean | |
parent_group_id | Int64 | |
depth | Int64 | |
children_count | Int64 |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|
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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
team_abbreviation | String | Short team abbreviation (e.g. "BOS"). |
team_alternate_color | String | Secondary team color as a hex string (no leading '#'). |
team_color | String | Primary team color as a hex string (no leading '#'). |
team_display_name | String | Full team display name (location + nickname). |
team_id | Int64 | ESPN team id (stable join key across ESPN endpoints). |
team_is_active | Boolean | Whether the team is currently active. |
team_is_all_star | Boolean | Whether the entry is an all-star squad rather than a franchise. |
team_location | String | Team location / city (e.g. "Boston"). |
team_logos | String | Pipe-delimited logo image URLs. |
team_name | String | Team nickname/mascot (e.g. "Celtics"). |
team_nickname | String | Team nickname as ESPN labels it (often equals team_name). |
team_short_display_name | String | Abbreviated display name for compact UIs. |
team_slug | String | URL slug used in ESPN web paths. |
team_uid | String | ESPN global UID (encodes sport/league/team). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_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_name | type | description |
|---|---|---|
team_abbreviation | String | |
team_alternate_color | String | |
team_color | String | |
team_display_name | String | |
team_franchise_$ref | String | |
team_franchise_abbreviation | String | |
team_franchise_color | String | |
team_franchise_display_name | String | |
team_franchise_id | Int64 | |
team_franchise_is_active | Boolean | |
team_franchise_location | String | |
team_franchise_name | String | |
team_franchise_short_display_name | String | |
team_franchise_slug | String | |
team_franchise_team_$ref | String | |
team_franchise_uid | String | |
team_franchise_venue_$ref | String | |
team_franchise_venue_address_city | String | |
team_franchise_venue_address_state | String | |
team_franchise_venue_full_name | String | |
team_franchise_venue_grass | Boolean | |
team_franchise_venue_guid | String | |
team_franchise_venue_id | Int64 | |
team_franchise_venue_images | String | |
team_franchise_venue_indoor | Boolean | |
team_franchise_venue_short_name | String | |
team_groups_id | Int64 | |
team_groups_is_conference | Boolean | |
team_groups_parent_id | Int64 | |
team_id | Int64 | |
team_is_active | Boolean | |
team_links | String | |
team_location | String | |
team_logos | String | |
team_name | String | |
team_next_event | String | |
team_record_items | String | |
team_short_display_name | String | |
team_slug | String | |
team_standing_summary | String | |
team_uid | String |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_id path parameter. | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
id | Int64 | Id. |
uid | String | Uid. |
guid | String | Guid. |
first_name | String | First name. |
last_name | String | Last name. |
full_name | String | Full name. |
display_name | String | Display name. |
short_name | String | Short name. |
weight | Float64 | Weight. |
display_weight | String | Display weight. |
height | Float64 | Height. |
display_height | String | Display height. |
age | Int64 | Age. |
date_of_birth | String | Date of birth. |
debut_year | Float64 | Debut year. |
links | String | Links. |
slug | String | Slug. |
jersey | String | Jersey. |
injuries | String | Injuries. |
teams | String | Teams. |
contracts | String | Contracts. |
alternate_ids_sdr | String | Alternate ids sdr. |
birth_place_city | String | Birth place city. |
birth_place_country | String | Birth place country. |
college_id | Int64 | College id. |
college_guid | String | College guid. |
college_mascot | String | College mascot. |
college_name | String | College name. |
college_short_name | String | College short name. |
college_abbrev | String | College abbrev. |
college_logos | String | College logos. |
headshot_href | String | Headshot href. |
headshot_alt | String | Headshot alt. |
position_id | Int64 | Position id. |
position_name | String | Position name. |
position_display_name | String | Position display name. |
position_abbreviation | String | Position abbreviation. |
position_leaf | Boolean | Position leaf. |
experience_years | Int64 | Experience years. |
contract_bird_status | Int64 | Contract bird status. |
contract_base_year_compensation_active | Boolean | Contract base year compensation active. |
contract_poison_pill_provision_active | Boolean | Contract poison pill provision active. |
contract_incoming_trade_value | Int64 | Contract incoming trade value. |
contract_outgoing_trade_value | Int64 | Contract outgoing trade value. |
contract_minimum_salary_exception | Boolean | Contract minimum salary exception. |
contract_option_type | Int64 | Contract option type. |
contract_salary | Int64 | Contract salary. |
contract_salary_remaining | Int64 | Contract salary remaining. |
contract_years_remaining | Int64 | Contract years remaining. |
contract_season_year | Int64 | Contract season year. |
contract_season_start_date | String | Contract season start date. |
contract_season_end_date | String | Contract season end date. |
contract_trade_kicker_active | Boolean | Contract trade kicker active. |
contract_trade_kicker_percentage | Float64 | Contract trade kicker percentage. |
contract_trade_kicker_value | Int64 | Contract trade kicker value. |
contract_trade_kicker_trade_value | Int64 | Contract trade kicker trade value. |
contract_trade_restriction | Boolean | Contract trade restriction. |
contract_unsigned_foreign_pick | Boolean | Contract unsigned foreign pick. |
contract_active | Boolean | Contract active. |
status_id | Int64 | Status id. |
status_name | String | Status name. |
status_type | String | Status type. |
status_abbreviation | String | Status abbreviation. |
citizenship | String | Citizenship. |
birth_place_state | String | Birth place state. |
hand_type | String | Hand type. |
hand_abbreviation | String | Hand abbreviation. |
hand_display_value | String | Hand display value. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_id path parameter. | ||
season | season | Y | Season 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_name | type | description |
|---|---|---|
id | Int64 | ESPN numeric event identifier. |
date | String | Event timestamp (ISO 8601, UTC). |
name | String | Full event name (e.g. 'Team A at Team B'). |
short_name | String | Abbreviated event name (e.g. 'TA @ TB'). |
time_valid | Boolean | Whether the event time is confirmed. |
competitions | String | Competition detail (list of dicts, stringified): competitors, venue, status. |
links | String | Related links (list, stringified). |
season_year | Int64 | Four-digit season year. |
season_display_name | String | Human-readable season label (e.g. '2024-25'). |
season_type_id | Int64 | ESPN numeric identifier for the season type. |
season_type_type | Int64 | Season type numeric code. |
season_type_name | String | Season type name (e.g. Regular Season). |
season_type_abbreviation | String | Season type abbreviation. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_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_name | type | description |
|---|---|---|
id | Int64 | ESPN numeric identifier for the athlete. |
display_name | String | Athlete's full display name as shown on ESPN. |
injuries | String | Injury entries for the athlete (list of dicts, stringified): status, type, details, dates. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_id path parameter. | ||
limit | limit | Y | Maximum 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_name | type | description |
|---|---|---|
id | Int64 | ESPN numeric identifier for the article. |
now_id | String | ESPN 'now' feed id. |
content_key | String | Internal content key. |
data_source_identifier | String | Source-system identifier. |
type | String | Article type (Story, Media, HeadlineNews, etc.). |
headline | String | Article headline. |
description | String | Article summary/description. |
last_modified | String | Last-modified timestamp (ISO 8601). |
published | String | Publish timestamp (ISO 8601). |
images | String | Article images (list, stringified). |
categories | String | Article categories (list, stringified). |
premium | Boolean | Whether the article is premium/paywalled. |
byline | String | Author byline string as published by ESPN. |
links_web_href | String | Web article URL. |
links_mobile_href | String | Mobile article URL. |
links_api_self_href | String | ESPN API canonical self-link for the article resource. |
links_app_sportscenter_href | String | SportsCenter app deep link. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
team_id | team_id | Y | team_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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_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
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_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_name | type | description |
|---|---|---|
id | Int64 | ESPN numeric identifier for the article. |
now_id | String | ESPN 'now' feed id. |
content_key | String | Internal content key. |
data_source_identifier | String | Source-system identifier. |
type | String | Article type (Story, Media, HeadlineNews, etc.). |
headline | String | Article headline. |
description | String | Article summary/description. |
last_modified | String | Last-modified timestamp (ISO 8601). |
published | String | Publish timestamp (ISO 8601). |
images | String | Article images (list, stringified). |
categories | String | Article categories (list, stringified). |
premium | Boolean | Whether the article is premium/paywalled. |
byline | String | Author byline string as published by ESPN. |
links_web_href | String | Web article URL. |
links_mobile_href | String | Mobile article URL. |
links_api_self_href | String | ESPN API canonical self-link for the article resource. |
links_app_sportscenter_href | String | SportsCenter app deep link. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
season | season | Y | Season year (e.g. 2024). | ||
group | group | Y | Conference or group id filter (e.g. an ESPN conference id). | ||
type | standings_type | Y | Standings 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_name | type | description |
|---|---|---|
group | String | Conference/group/table the row belongs to, flattened from the standings children hierarchy. |
team | String | Display name of the team in this standings row. |
team_id | String | ESPN numeric identifier for the team. |
team_abbreviation | String | Team abbreviation. |
rank | Int64 | Position within the group/table. |
matches_played | Int64 | Matches played (cricket). |
matches_won | Int64 | Matches won (cricket). |
matches_lost | Int64 | Matches lost (cricket). |
noresult | Int64 | Matches with no result (cricket). |
match_points | Int64 | Competition points (cricket). |
qualified | Int64 | Qualification flag (cricket). |
netrr | Float64 | Net run rate (cricket). |
for | Float64 | Runs/goals for. |
against | Float64 | Runs/goals against. |
total | String | Aggregate/summary value as published by ESPN. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Raises
| Exception | Description |
|---|---|
NoDataError | The host answered 404 -- the requested resource does not exist. |
ValueError | The host answered 400 / 422 -- the request is wrong; retrying cannot help. |
AssetFetchError | The 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')