MBB — ESPN core API (v2) — Player

espn_mbb_players_index

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes

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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_players_index()

Last validated n/a.

espn_mbb_player_core

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/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 (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_core(athlete_id='4239')

Last validated n/a.

espn_mbb_player_career_stats

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/statistics[/{stat_type}]

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/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) — a tidy polars.DataFrame (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_career_stats(athlete_id='4239')

Last validated n/a.

espn_mbb_player_statisticslog

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/statisticslog

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_statisticslog(athlete_id='4239')

Last validated n/a.

espn_mbb_player_eventlog

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/eventlog

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/4239/eventlog

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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_eventlog(athlete_id='4239')

Last validated n/a.

espn_mbb_player_contracts

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/contracts

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_contracts(athlete_id='4239')

Last validated n/a.

espn_mbb_player_awards

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/awards

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/4239/awards

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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_awards(athlete_id='4239')

Last validated n/a.

espn_mbb_player_seasons

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/seasons

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_seasons(athlete_id='4239')

Last validated n/a.

espn_mbb_player_records

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/records

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/4239/records

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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_records(athlete_id='4239')

Last validated n/a.

espn_mbb_player_injuries

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/injuries

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/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_mbb_player_injuries(athlete_id='4239')

Last validated n/a.

espn_mbb_player_notes

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/notes

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/4239/notes

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 (parser: parse_items); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

espn_mbb_player_notes(athlete_id='4239')

Last validated n/a.

espn_mbb_player_vs_player

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/athletes/{athlete_id}/vsathlete/{opp_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/mens-college-basketball/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) — a tidy polars.DataFrame (parser: parse_single_entity); pass return_as_pandas=True for a pandas.DataFrame. return_parsed=False — the raw JSON Dict payload, unparsed.

Example

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

Last validated n/a.