MLB — ESPN core API (v2) — Player

espn_mlb_players_index

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes?active=true&limit=100&page=1

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

Returns

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

col_name	type	description
$ref	character

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

Example

espn_mlb_players_index()

Last validated n/a.

espn_mlb_player_core

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239

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
$ref	character
active	logical	Whether the player is currently active.
age	integer	Player age (in years).
date_of_birth	character	Date of birth.
debut_year	integer	Debut year.
display_height	character	Display height.
display_name	character	Display name.
display_weight	character	Display weight.
first_name	character	Player first name.
full_name	character	Player's full name.
guid	character	Stable cross-league team GUID.
height	double	Height (feet and inches).
id	character	Id.
jersey	character	Jersey number worn by the player.
last_name	character	Player last name.
linked	logical	Linked.
links	character
short_name	character	Short display name.
slug	character	URL-safe identifier.
type	character	Record type / category.
uid	character	ESPN UID string.
weight	double	Weight in pounds.
alternate_ids_sdr	character
birth_place_city	character	Birth place city.
birth_place_state	character	Birth place state.
college_$ref	character
college_athlete_$ref	character
contracts_$ref	character
draft_display_text	character	Draft display text.
draft_pick_$ref	character
draft_round	integer	Draft round.
draft_selection	integer	Draft selection.
draft_team_$ref	character
draft_year	integer	Year the player was drafted.
experience_years	integer
hand_abbreviation	character
hand_display_value	character
hand_type	character
headshot_alt	character	Headshot alt.
headshot_href	character	Headshot image URL.
position_$ref	character
position_abbreviation	character	Position abbreviation.
position_display_name	character	Position display name.
position_id	character	Unique position identifier.
position_leaf	logical	Position leaf.
position_name	character	Position name.
seasons_$ref	character
statistics_$ref	character
statisticslog_$ref	character
status_abbreviation	character	Status abbreviation.
status_id	character	Status id.
status_name	character	Game status (e.g. 'STATUS_FINAL').
status_type	character	Status type.
team_$ref	character

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

Example

espn_mlb_player_core(athlete_id='4239')

Last validated n/a.

espn_mlb_player_career_stats

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/statistics[/{stat_type}]

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/statistics

API Parameter	Python	Pattern	Required	Nullable	Description
athlete_id	athlete_id		Y		athlete_id path parameter.
stat_type	stat_type			Y	stat_type 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, mlb, mbb, 2026-10-07); its rows sit under keys it does not read (top level: $ref, athlete, splits).

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

Example

espn_mlb_player_career_stats(athlete_id='4239')

Last validated n/a.

espn_mlb_player_statisticslog

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/statisticslog

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/statisticslog

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
statistics	character
season_$ref	character

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

Example

espn_mlb_player_statisticslog(athlete_id='4239')

Last validated n/a.

espn_mlb_player_eventlog

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/eventlog

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/eventlog

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_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.

Example

espn_mlb_player_eventlog(athlete_id='4239')

Last validated n/a.

espn_mlb_player_contracts

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/contracts

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/contracts

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
$ref	character

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

Example

espn_mlb_player_contracts(athlete_id='4239')

Last validated n/a.

espn_mlb_player_awards

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/awards

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/awards

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_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_mlb_player_awards(athlete_id='4239')

Last validated n/a.

espn_mlb_player_seasons

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/seasons

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/seasons

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
$ref	character

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

Example

espn_mlb_player_seasons(athlete_id='4239')

Last validated n/a.

espn_mlb_player_records

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/records

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/records

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_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_mlb_player_records(athlete_id='4239')

Last validated n/a.

espn_mlb_player_injuries

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/injuries

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/injuries

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

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

Example

espn_mlb_player_injuries(athlete_id='4239')

Last validated n/a.

espn_mlb_player_notes

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/notes

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/notes

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_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.

Example

espn_mlb_player_notes(athlete_id='4239')

Last validated n/a.

espn_mlb_player_vs_player

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/vsathlete/{opp_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/vsathlete/5

API Parameter	Python	Pattern	Required	Nullable	Description
athlete_id	athlete_id		Y		athlete_id path parameter.
opp_id	opp_id		Y		opp_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.

Example

espn_mlb_player_vs_player(athlete_id='4239', opp_id='5')

Last validated n/a.

espn_mlb_player_hotzones

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/{athlete_id}/hotzones

Valid URL: https://sports.core.api.espn.com/v2/sports/baseball/leagues/mlb/athletes/4239/hotzones

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
count	integer	Count of count.
items	character
page_count	integer
page_index	integer
page_size	integer

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

Example

espn_mlb_player_hotzones(athlete_id='4239')

Last validated n/a.