mbb — Web API
5 endpoints on sdv.mbb. Each is exposed under a camelCase canonical name and a snake_case alias (py/R parity), accepts snake_case or camelCase params, and returns raw ESPN JSON by default ({ parsed: true } for tidy rows).
espnMbbAthleteGamelog
MBB — athlete gamelog (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/gamelog
| API param | JS | required | description |
|---|---|---|---|
{athlete_id} | athlete_id | yes | path parameter |
season | season | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_athlete_gamelog):
| col_name | type | description |
|---|---|---|
season_type_id | character | Season type id (regular/post) |
season_type_name | character | Season type name |
category | character | Stat / leader category name |
event_id | character | ESPN event/game id |
event_date | character | Event date (ISO 8601) |
home_away | character | home or away |
score | character | Final score for the athlete's team |
opponent_id | character | Opponent ESPN team id |
opponent_abbreviation | character | Opponent abbreviation |
opponent_display_name | character | Opponent display name |
game_result | character | Game result (W/L) |
game_processed | logical | Whether the game has been processed |
Example:
await sdv.mbb.espnMbbAthleteGamelog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mbb.espn_mbb_athlete_gamelog(...)
espnMbbAthleteOverview
MBB — athlete overview (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/overview
| API param | JS | required | description |
|---|---|---|---|
{athlete_id} | athlete_id | yes | path parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_athlete_overview):
| col_name | type | description |
|---|---|---|
athlete_id | character | ESPN athlete id |
athlete_display_name | character | Athlete display name |
athlete_short_name | character | Athlete short name |
athlete_position | character | Position abbreviation |
athlete_jersey | character | Jersey number |
athlete_team_id | character | Athlete's team id |
athlete_team_abbreviation | character | Athlete's team abbreviation |
split_name | character | Split / season-segment name |
split_category | character | Split category |
Example:
await sdv.mbb.espnMbbAthleteOverview({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mbb.espn_mbb_athlete_overview(...)
espnMbbAthleteSplits
MBB — athlete splits (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/splits
| API param | JS | required | description |
|---|---|---|---|
{athlete_id} | athlete_id | yes | path parameter |
season | season | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_athlete_splits):
| col_name | type | description |
|---|---|---|
category | character | Stat / leader category name |
split_name | character | Split / season-segment name |
split_abbreviation | character | Split abbreviation |
split_category | character | Split category |
split_value | character | Split value |
split_description | character | Split description |
Example:
await sdv.mbb.espnMbbAthleteSplits({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mbb.espn_mbb_athlete_splits(...)
espnMbbAthleteStats
MBB — athlete stats (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/athletes/{athlete_id}/stats
| API param | JS | required | description |
|---|---|---|---|
{athlete_id} | athlete_id | yes | path parameter |
season | season | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_athlete_stats):
| col_name | type | description |
|---|---|---|
category | character | Stat / leader category name |
split_name | character | Split / season-segment name |
split_category | character | Split category |
split_value | character | Split value |
Example:
await sdv.mbb.espnMbbAthleteStats({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mbb.espn_mbb_athlete_stats(...)
espnMbbLeaders
MBB — leaders (ESPN site.web.api.espn.com (web v3)).
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/mens-college-basketball/statistics/byathlete
| API param | JS | required | description |
|---|---|---|---|
category | category | no | query parameter |
season | season | no | query parameter |
seasontype | season_type | no | query parameter |
limit | limit | no | query parameter (default 50) |
page | page | no | query parameter (default 1) |
sort | sort | no | query parameter |
| — | parsed | no | return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_leaders):
| col_name | type | description |
|---|---|---|
category | character | Stat / leader category name |
rank | integer | Rank within the category |
athlete_id | character | ESPN athlete id |
athlete_display_name | character | Athlete display name |
athlete_short_name | character | Athlete short name |
athlete_jersey | character | Jersey number |
athlete_position | character | Position abbreviation |
team_id | character | ESPN team id |
team_abbreviation | character | Team abbreviation |
team_display_name | character | Team display name |
Example:
await sdv.mbb.espnMbbLeaders({});
// snake_case alias (py/R parity): sdv.mbb.espn_mbb_leaders(...)