MBB — ESPN web API (v3)
sportsdataverse.mbb — 5 endpoints.
espn_mbb_player_overview
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/overview
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. |
Returns
Raw JSON Dict (no parser registered).
Example
espn_mbb_player_overview(athlete_id='4239')
Last validated n/a.
espn_mbb_player_stats_v3
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/stats
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. | ||
season | season | Y | Season year (e.g. 2024). |
Returns
Raw JSON Dict (no parser registered).
Example
espn_mbb_player_stats_v3(athlete_id='4239')
Last validated n/a.
espn_mbb_player_gamelog
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/gamelog
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. | ||
season | season | Y | Season year (e.g. 2024). |
Returns
Raw JSON Dict (no parser registered).
Example
espn_mbb_player_gamelog(athlete_id='4239')
Last validated n/a.
espn_mbb_player_splits
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/splits
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. | ||
season | season | Y | Season year (e.g. 2024). |
Returns
Raw JSON Dict (no parser registered).
Example
espn_mbb_player_splits(athlete_id='4239')
Last validated n/a.
espn_mbb_leaders
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/statistics/byathlete
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
category | category | Y | category query parameter. | ||
season | season | Y | Season year (e.g. 2024). | ||
seasontype | season_type | Y | Season phase: 1=preseason, 2=regular season, 3=postseason. | ||
limit | limit | Y | Maximum number of items to return. | ||
page | page | Y | page query parameter. | ||
sort | sort | Y | sort query parameter. |
Returns
| col_name | type | description |
|---|---|---|
athletes | character | Athletes. |
glossary | character | Glossary. |
categories | character | Categories. |
pagination_count | integer | Pagination count. |
pagination_limit | integer | Pagination limit. |
pagination_page | integer | Pagination page. |
pagination_pages | integer | Pagination pages. |
pagination_first | character | Pagination first. |
pagination_next | character | Pagination next. |
pagination_last | character | Pagination last. |
league_id | character | League id. |
league_uid | character | League uid. |
league_name | character | League name. |
league_abbreviation | character | League abbreviation. |
league_slug | character | League slug. |
league_midsize_name | character | |
league_short_name | character | League short name. |
current_season_year | integer | Current season year. |
current_season_display_name | character | Current season display name. |
current_season_start_date | character | Current season start date. |
current_season_end_date | character | Current season end date. |
current_season_type_id | character | Current season type id. |
current_season_type_type | integer | Current season type type. |
current_season_type_name | character | Current season type name. |
current_season_type_start_date | character | Current season type start date. |
current_season_type_end_date | character | Current season type end date. |
requested_season_year | integer | Requested season year. |
requested_season_display_name | character | Requested season display name. |
requested_season_start_date | character | Requested season start date. |
requested_season_end_date | character | Requested season end date. |
requested_season_type_id | character | Requested season type id. |
requested_season_type_type | integer | Requested season type type. |
requested_season_type_name | character | Requested season type name. |
requested_season_type_start_date | character | Requested season type start date. |
requested_season_type_end_date | character | Requested season type end date. |
Example
espn_mbb_leaders()
Last validated n/a.