Get ESPN NBA Athletes Index

Get ESPN NBA Athletes Index

Get ESPN NBA Athletes Index

Usage

espn_nba_athletes_index(
  season = most_recent_nba_season(),
  active = TRUE,
  limit = 5000L,
  ...
)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent NBA season.

active

logical. When TRUE (default) only active athletes are returned. Set to FALSE for the full historical roster.

limit

integer. Maximum number of rows to return. Default 5000. Pass a small value (e.g. limit = 50) in tests to keep execution fast.

...

Additional arguments; currently unused but retained for forward compatibility. Proxy configuration should use options(hoopR.proxy = ...) – see ?hoopR for details.

Value

A single hoopR_data tibble with one row per athlete.

col_name	types	description
athlete_id	character	Unique athlete identifier (ESPN).
full_name	character	Player's full name.
jersey	character	Jersey number worn by the player.
position	character	Listed roster position (G, F, C, etc.).
team_id	character	Unique team identifier.
headshot	character	Headshot image URL.
status	character	Status label.
link	character

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_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_roster(), 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_athletes_index(season = 2025, limit = 50)
#> Fetching page 1 of 1 for nba athletes (season=2025)...
#> ── ESPN NBA Athletes Index from ESPN.com ──────────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 01:33:43 UTC
#> # A tibble: 50 × 9
#>    athlete_id full_name jersey position team_id headshot status link     ref_url
#>    <chr>      <chr>     <chr>  <chr>    <chr>   <chr>    <chr>  <chr>    <chr>  
#>  1 4432932    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  2 4431679    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  3 2991235    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  4 4066261    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  5 4397018    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  6 4684682    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  7 4397072    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  8 4593125    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  9 4433268    NA        NA     NA       NA      NA       NA     http://… http:/…
#> 10 4278039    NA        NA     NA       NA      NA       NA     http://… http:/…
#> # ℹ 40 more rows
# }