Skip to contents

Get ESPN men's college basketball game rosters

Usage

espn_mbb_game_rosters(game_id)

Arguments

game_id

Game ID

Value

A game rosters data frame

col_nametypesdescription
athlete_idintegerUnique athlete identifier (ESPN).
athlete_uidcharacterESPN athlete UID (universal identifier).
athlete_guidcharacterESPN athlete GUID.
athlete_typecharacterAthlete type / class.
sdrintegerSdr.
first_namecharacterPlayer's first name.
last_namecharacterPlayer's last name.
full_namecharacterPlayer's full name.
athlete_display_namecharacterAthlete display name (full).
short_namecharacterShort display name.
weightintegerPlayer weight in pounds.
display_weightcharacterPlayer weight in display format (e.g. '180 lbs').
heightintegerPlayer height (string e.g. '6-2' or inches).
display_heightcharacterPlayer height in display format (e.g. '6-2').
ageintegerPlayer age (in years).
date_of_birthcharacterDate of birth (YYYY-MM-DD).
birth_place_citycharacterBirth place city.
birth_place_statecharacterBirth place state.
birth_place_countrycharacterBirth place country.
slugcharacterURL-safe identifier.
headshot_hrefcharacterHeadshot image URL.
headshot_altcharacterAlternative-text label for the headshot.
jerseycharacterJersey number worn by the player.
hand_typecharacterHand type.
hand_abbreviationcharacterHand abbreviation.
hand_display_valuecharacterHand display value.
position_idintegerUnique position identifier.
position_namecharacterListed roster position ('Guard', 'Forward', 'Center').
position_display_namecharacterPosition display name.
position_abbreviationcharacterPosition abbreviation ('G' / 'F' / 'C').
position_leaflogicalPosition leaf.
linkedlogicalTRUE if the record is linked to a related entity.
experience_yearsintegerExperience years.
experience_display_valuecharacterExperience display value.
experience_abbreviationcharacterExperience abbreviation.
activelogicalTRUE if the row represents an active record (player / team / season).
draft_display_textcharacterDraft display text.
draft_roundintegerRound of the draft selection.
draft_yearintegerDraft year (4-digit).
draft_selectionintegerDraft selection.
status_idintegerStatus identifier.
status_namecharacterStatus label.
status_typecharacterStatus type.
status_abbreviationcharacterStatus abbreviation.
starterlogicalTRUE if the player was in the starting lineup; FALSE otherwise.
validlogicalValid.
did_not_playlogicalTRUE if the player did not appear in the game.
display_namecharacterDisplay name.
ejectedlogicalTRUE if the player was ejected from the game.
team_idintegerUnique team identifier.
team_guidcharacterESPN team GUID.
team_uidcharacterESPN universal team identifier (UID format 's:40~l:...~t:...').
team_sdrintegerESPN team SDR identifier.
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationcharacterTeam city or location string.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_nicknamecharacterTeam nickname.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
team_display_namecharacterFull team display name.
team_short_display_namecharacterShort team display name (e.g. 'Aces').
team_colorcharacterTeam primary color (hex without leading '#').
team_alternate_colorcharacterTeam alternate color (hex without leading '#').
is_activelogicalIs active.
is_all_starlogicalIs all star.
logo_hrefcharacterTeam or league logo URL.
logo_dark_hrefcharacterLogo URL for dark backgrounds.
game_idintegerUnique game identifier.
orderintegerDisplay order within the result set.
home_awaycharacterGame venue label ('home' or 'away').
winnerlogicalWinner.
roster_hrefcharacterURL for roster.

See also

Other ESPN MBB Functions: espn_mbb_athlete_awards(), espn_mbb_athlete_career_stats(), espn_mbb_athlete_eventlog(), espn_mbb_athlete_eventlog_v2(), espn_mbb_athlete_gamelog(), espn_mbb_athlete_info(), espn_mbb_athlete_overview(), espn_mbb_athlete_seasons(), espn_mbb_athlete_splits(), espn_mbb_athlete_statisticslog(), espn_mbb_athlete_stats(), espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_event_broadcasts(), espn_mbb_event_competitor_leaders(), espn_mbb_event_competitor_linescores(), espn_mbb_event_competitor_records(), espn_mbb_event_competitor_roster(), espn_mbb_event_competitor_roster_entry(), espn_mbb_event_competitor_score(), espn_mbb_event_competitor_statistics(), espn_mbb_event_odds(), espn_mbb_event_official_detail(), espn_mbb_event_officials(), espn_mbb_event_play(), espn_mbb_event_play_personnel(), espn_mbb_event_player_box(), espn_mbb_event_powerindex(), espn_mbb_event_predictor(), espn_mbb_event_probabilities(), espn_mbb_event_propbets(), espn_mbb_event_situation(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_box(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_season_statistics(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_season(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Author

Saiem Gilani

Examples

# \donttest{
try(espn_mbb_game_rosters(game_id = 401256760))
#> ── ESPN MBB Game Roster Information from ESPN.com ─────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-30 20:44:15 UTC
#> # A tibble: 34 × 151
#>    athlete_id athlete_uid  athlete_guid athlete_type    sdr first_name last_name
#>         <int> <chr>        <chr>        <chr>         <int> <chr>      <chr>    
#>  1    4277850 s:40~l:41~a… 7b156c52-fa… basketball   4.28e6 RaiQuan    Gray     
#>  2    4432829 s:40~l:41~a… 2734604d-09… basketball   4.43e6 Balsa      Koprivica
#>  3    4433134 s:40~l:41~a… dd0bb1da-07… basketball   4.43e6 Scottie    Barnes   
#>  4    4277854 s:40~l:41~a… f44291c9-0d… basketball   4.28e6 MJ         Walker   
#>  5    4277852 s:40~l:41~a… f376da3f-46… basketball   4.28e6 Anthony    Polite   
#>  6    4279098 s:40~l:41~a… 89f097ed-f5… basketball   4.28e6 Malik      Osborne  
#>  7    4701240 s:40~l:41~a… f35c5378-4b… basketball   4.70e6 Tanor      Ngom     
#>  8    4683134 s:40~l:41~a… f878c598-70… basketball   4.68e6 Quincy     Ballard  
#>  9    4701239 s:40~l:41~a… 88820814-39… basketball   4.70e6 Sardaar    Calhoun  
#> 10    4592191 s:40~l:41~a… 066a390d-78… basketball   4.59e6 Nathanael  Jack     
#> # ℹ 24 more rows
#> # ℹ 144 more variables: full_name <chr>, athlete_display_name <chr>,
#> #   short_name <chr>, weight <int>, display_weight <chr>, height <int>,
#> #   display_height <chr>, age <int>, date_of_birth <chr>,
#> #   birth_place_city <chr>, birth_place_state <chr>, birth_place_country <chr>,
#> #   birth_country_alternate_id <chr>, birth_country_abbreviation <chr>,
#> #   slug <chr>, headshot_href <chr>, headshot_alt <chr>, …
# }