Skip to contents

Get ESPN NBA Team Roster

Get ESPN NBA Team Roster

Usage

espn_nba_team_roster(team_id, season = most_recent_nba_season(), ...)

Arguments

team_id

ESPN team identifier (character or numeric).

season

Season year (numeric). Defaults to the most recent NBA season.

...

Additional arguments; currently unused.

Value

A single tibble with one row per athlete.

col_nametypesdescription
athlete_idcharacterUnique athlete identifier (ESPN).
full_namecharacterPlayer's full name.
jerseycharacterJersey number worn by the player.
position_abbrevcharacter
position_namecharacterListed roster position ('Guard', 'Forward', 'Center').
heightcharacterPlayer height (string e.g. '6-2' or inches).
weightcharacterPlayer weight in pounds.
agecharacterPlayer age (in years).
birth_datecharacterDate of birth (YYYY-MM-DD).
birth_placecharacterPlace of birth.
headshotcharacterHeadshot image URL.
link_webcharacterWeb link / URL.
statuscharacterStatus label.
team_idcharacterUnique team identifier.
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).

See also

Other ESPN NBA Functions: espn_nba_athlete_awards(), espn_nba_athlete_career_stats(), espn_nba_athlete_contract(), espn_nba_athlete_contracts(), espn_nba_athlete_eventlog(), espn_nba_athlete_eventlog_v2(), espn_nba_athlete_gamelog(), espn_nba_athlete_info(), espn_nba_athlete_overview(), espn_nba_athlete_seasons(), espn_nba_athlete_splits(), espn_nba_athlete_statisticslog(), espn_nba_athlete_stats(), espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_odds(), espn_nba_event_officials(), espn_nba_event_powerindex(), espn_nba_event_predictor(), espn_nba_event_probabilities(), espn_nba_event_propbets(), espn_nba_event_situation(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_rosters(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_box(), espn_nba_player_stats(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_nba_team_roster(team_id = "17", season = 2025)
#> ── ESPN NBA Team Roster from ESPN.com ─────────────────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-19 01:34:16 UTC
#> # A tibble: 19 × 15
#>    athlete_id full_name jersey position_abbrev position_name height weight age  
#>    <chr>      <chr>     <chr>  <chr>           <chr>         <chr>  <chr>  <chr>
#>  1 4397018    Ochai Ag… 30     G               Guard         "6' 5… 215 l… 26   
#>  2 4278067    Nic Clax… 33     C               Center        "6' 1… 215 l… 27   
#>  3 4712896    Noah Clo… 21     F               Forward       "6' 1… 210 l… 21   
#>  4 5175643    Egor Dem… 8      G               Guard         "6' 8… 200 l… 20   
#>  5 4432887    Tyson Et… 10     G               Guard         "6' 0… 200 l… 26   
#>  6 5174655    Chaney J… 31     F               Forward       "6' 8… 225 l… 23   
#>  7 4432821    E.J. Lid… 9      F               Forward       "6' 6… 240 l… 25   
#>  8 3907823    Terance … 14     G               Guard         "6' 6… 215 l… 29   
#>  9 4687718    Josh Min… 00     F               Forward       "6' 8… 205 l… 23   
#> 10 4278104    Michael … 17     F               Forward       "6' 1… 218 l… 27   
#> 11 5037873    Drake Po… 4      G               Guard         "6' 5… 195 l… 20   
#> 12 5242502    Ben Saraf 77     G               Guard         "6' 6… 200 l… 20   
#> 13 3934620    Trevon S… 13     F               Forward       "6' 8… 225 l… 29   
#> 14 4432194    Day'Ron … 20     C               Center        "6' 1… 265 l… 24   
#> 15 4397784    Malachi … 18     G               Guard         "6' 4… 205 l… 26   
#> 16 5279130    Nolan Tr… 88     G               Guard         "6' 3… 185 l… 19   
#> 17 4433137    Ziaire W… 1      F               Forward       "6' 9… 185 l… 24   
#> 18 4431714    Jalen Wi… 22     F               Forward       "6' 6… 220 l… 25   
#> 19 5107173    Danny Wo… 2      F               Forward       "6' 1… 250 l… 22   
#> # ℹ 7 more variables: birth_date <chr>, birth_place <chr>, headshot <chr>,
#> #   link_web <chr>, status <chr>, team_id <chr>, season <int>
# }