Skip to contents

Get ESPN Women's College Basketball Athletes Index

Get ESPN Women's College Basketball Athletes Index

Get ESPN NBA Athletes Index

Get ESPN NBA Athletes Index

Usage

espn_mbb_athletes_index(
  season = most_recent_mbb_season(),
  active = TRUE,
  limit = 25000L,
  ...
)

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 MBB 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 25000. MBB can return 6,000-12,000 athletes per season; increase if needed. 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.

Columns as documented in the shared espn_mbb_athletes_index_schema table.

A single hoopR_data tibble with one row per athlete.

Columns as documented in the shared espn_mbb_athletes_index_schema table.

See also

Other ESPN MBB Functions: espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), 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_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_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), 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()

Other ESPN NBA Functions: espn_mbb_award(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_record(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_all(), espn_mbb_game_odds(), espn_mbb_game_official_detail(), espn_mbb_game_play(), espn_mbb_game_play_personnel(), espn_mbb_game_player_box(), espn_mbb_game_probabilities(), espn_mbb_game_propbets(), espn_mbb_game_team_linescores(), espn_mbb_game_team_roster_entry(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_player_awards(), espn_mbb_player_career_stats(), espn_mbb_player_eventlog_v2(), espn_mbb_player_info(), espn_mbb_player_overview(), espn_mbb_player_seasons(), espn_mbb_player_stats(), espn_mbb_position(), espn_mbb_positions(), espn_mbb_powerindex(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), 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_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_record_detail(), espn_mbb_team_schedule(), 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(), espn_nba_draft_pick(), espn_nba_freeagents(), espn_nba_player_contracts(), espn_nba_team_depthchart(), espn_nba_transactions()

Author

Saiem Gilani

Examples

# \donttest{
  espn_mbb_athletes_index(season = 2025, limit = 50)
#> Fetching page 1 of 1 for mens-college-basketball athletes (season=2025)...
#> ── ESPN MENS-COLLEGE-BASKETBALL Athletes Index from ESPN.com ──── hoopR 3.1.0 ──
#>  Data updated: 2026-08-27 17:46: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 2571       NA        NA     NA       NA      NA       NA     http://… http:/…
#>  2 23574      NA        NA     NA       NA      NA       NA     http://… http:/…
#>  3 50600      NA        NA     NA       NA      NA       NA     http://… http:/…
#>  4 71520      NA        NA     NA       NA      NA       NA     http://… http:/…
#>  5 71896      NA        NA     NA       NA      NA       NA     http://… http:/…
#>  6 71897      NA        NA     NA       NA      NA       NA     http://… http:/…
#>  7 71898      NA        NA     NA       NA      NA       NA     http://… http:/…
#>  8 71899      NA        NA     NA       NA      NA       NA     http://… http:/…
#>  9 71900      NA        NA     NA       NA      NA       NA     http://… http:/…
#> 10 71901      NA        NA     NA       NA      NA       NA     http://… http:/…
#> # ℹ 40 more rows
# }
# \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-08-27 17:46: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 4431679    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  2 5142620    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 4593125    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  7 4433268    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  8 4278039    NA        NA     NA       NA      NA       NA     http://… http:/…
#>  9 3135045    NA        NA     NA       NA      NA       NA     http://… http:/…
#> 10 4066328    NA        NA     NA       NA      NA       NA     http://… http:/…
#> # ℹ 40 more rows
# }