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_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_record(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athlete_detail(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_broadcasts(), espn_nba_game_odds(), espn_nba_game_official_detail(), espn_nba_game_officials(), espn_nba_game_play(), espn_nba_game_play_personnel(), espn_nba_game_player_box(), espn_nba_game_powerindex(), espn_nba_game_predictor(), espn_nba_game_probabilities(), espn_nba_game_propbets(), espn_nba_game_rosters(), espn_nba_game_situation(), espn_nba_game_team_leaders(), espn_nba_game_team_linescores(), espn_nba_game_team_records(), espn_nba_game_team_roster(), espn_nba_game_team_roster_entry(), espn_nba_game_team_score(), espn_nba_game_team_statistics(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_awards(), espn_nba_player_box(), espn_nba_player_career_stats(), espn_nba_player_contract(), espn_nba_player_contracts(), espn_nba_player_eventlog(), espn_nba_player_eventlog_v2(), espn_nba_player_gamelog(), espn_nba_player_info(), espn_nba_player_overview(), espn_nba_player_seasons(), espn_nba_player_splits(), espn_nba_player_statisticslog(), espn_nba_player_stats(), espn_nba_player_stats_v3(), espn_nba_position(), espn_nba_positions(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_draft(), 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_record_detail(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_season_statistics(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_season(), 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-06-30 19:33:48 UTC
#> # A tibble: 29 × 9
#>    athlete_id full_name jersey position team_id headshot status link     ref_url
#>    <chr>      <chr>     <chr>  <chr>    <chr>   <chr>    <chr>  <chr>    <chr>  
#>  1 3135045    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  2 3032977    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  3 6580       NA        NA     NA       NA      NA       NA     http://… http:/…
#>  4 4066383    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  5 5105337    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  6 5061568    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  7 4433188    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  8 5107157    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  9 4431941    NA        NA     NA       NA      NA       NA     http://… http:/…
#> 10 4837356    NA        NA     NA       NA      NA       NA     http://… http:/…
#> # ℹ 19 more rows
# }