Skip to contents

Get ESPN MLB Athletes Index

Get ESPN MLB Athletes Index

Usage

espn_mlb_athletes_index(
  season = most_recent_mlb_season(),
  active = TRUE,
  limit = 5000L,
  ...
)

Arguments

season

Season year (numeric, e.g. 2025). Defaults to the most recent MLB 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(baseballr.proxy = ...) – see ?baseballr for details.

Value

A single baseballr_data tibble with one row per athlete.

col_nametypesdescription
athlete_idcharacterUnique athlete identifier (ESPN).
full_namecharacterPlayer's full name.
jerseycharacterJersey number worn by the player.
positioncharacterListed roster position (G, F, C, etc.).
team_idcharacterUnique team identifier.
headshotcharacterHeadshot image URL.
statuscharacterStatus label.
linkcharacter

See also

Other ESPN MLB Functions: espn_mlb, espn_mlb_award(), espn_mlb_betting(), espn_mlb_calendar(), espn_mlb_coach(), espn_mlb_coach_record(), espn_mlb_coach_season(), espn_mlb_coaches(), espn_mlb_conferences(), espn_mlb_draft(), espn_mlb_draft_athlete_detail(), espn_mlb_draft_athletes(), espn_mlb_draft_pick(), espn_mlb_draft_rounds(), espn_mlb_draft_status(), espn_mlb_franchise(), espn_mlb_franchises(), espn_mlb_freeagents(), espn_mlb_futures(), espn_mlb_game_all(), espn_mlb_game_broadcasts(), espn_mlb_game_endpoints, espn_mlb_game_info(), espn_mlb_game_odds(), espn_mlb_game_official_detail(), espn_mlb_game_officials(), espn_mlb_game_play(), espn_mlb_game_play_personnel(), espn_mlb_game_player_box(), espn_mlb_game_powerindex(), espn_mlb_game_predictor(), espn_mlb_game_probabilities(), espn_mlb_game_probables(), espn_mlb_game_propbets(), espn_mlb_game_rosters(), espn_mlb_game_situation(), espn_mlb_game_team_leaders(), espn_mlb_game_team_linescores(), espn_mlb_game_team_records(), espn_mlb_game_team_roster(), espn_mlb_game_team_roster_entry(), espn_mlb_game_team_score(), espn_mlb_game_team_statistics(), espn_mlb_injuries(), espn_mlb_leaders(), espn_mlb_news(), espn_mlb_pbp(), espn_mlb_player_awards(), espn_mlb_player_box(), espn_mlb_player_career_stats(), espn_mlb_player_contract(), espn_mlb_player_contracts(), espn_mlb_player_endpoints, espn_mlb_player_eventlog(), espn_mlb_player_eventlog_v2(), espn_mlb_player_gamelog(), espn_mlb_player_info(), espn_mlb_player_overview(), espn_mlb_player_seasons(), espn_mlb_player_splits(), espn_mlb_player_statisticslog(), espn_mlb_player_stats(), espn_mlb_player_stats_v3(), espn_mlb_position(), espn_mlb_positions(), espn_mlb_powerindex(), espn_mlb_scoreboard(), espn_mlb_season_awards(), espn_mlb_season_draft(), espn_mlb_season_group(), espn_mlb_season_group_children(), espn_mlb_season_group_teams(), espn_mlb_season_groups(), espn_mlb_season_info(), espn_mlb_season_leaders(), espn_mlb_season_ranking(), espn_mlb_season_rankings(), espn_mlb_season_type(), espn_mlb_season_types(), espn_mlb_season_week(), espn_mlb_season_weeks(), espn_mlb_seasons(), espn_mlb_standings(), espn_mlb_team(), espn_mlb_team_box(), espn_mlb_team_current_roster(), espn_mlb_team_depthchart(), espn_mlb_team_endpoints, espn_mlb_team_injuries(), espn_mlb_team_leaders(), espn_mlb_team_news(), espn_mlb_team_odds_records(), espn_mlb_team_record(), espn_mlb_team_record_detail(), espn_mlb_team_roster(), espn_mlb_team_schedule(), espn_mlb_team_season_profile(), espn_mlb_team_season_roster(), espn_mlb_team_season_statistics(), espn_mlb_team_stats(), espn_mlb_teams(), espn_mlb_tournament(), espn_mlb_tournament_season(), espn_mlb_tournament_seasons(), espn_mlb_tournaments(), espn_mlb_transactions(), espn_mlb_venues(), espn_mlb_week_ranking(), espn_mlb_week_rankings(), espn_mlb_wp()

Author

Saiem Gilani

Examples

# \donttest{
  espn_mlb_athletes_index(season = 2025, limit = 50)
#> Fetching page 1 of 1 for mlb athletes (season=2025)...
#> ── ESPN MLB Athletes Index from ESPN.com ──────────── baseballr 2.0.0 ──
#>  Data updated: 2026-06-08 11:07:30 UTC
#> # A tibble: 50 × 9
#>    athlete_id full_name jersey position team_id headshot status link    
#>    <chr>      <chr>     <chr>  <chr>    <chr>   <chr>    <chr>  <chr>   
#>  1 1          NA        NA     NA       NA      NA       NA     http://…
#>  2 2          NA        NA     NA       NA      NA       NA     http://…
#>  3 3          NA        NA     NA       NA      NA       NA     http://…
#>  4 4          NA        NA     NA       NA      NA       NA     http://…
#>  5 5          NA        NA     NA       NA      NA       NA     http://…
#>  6 6          NA        NA     NA       NA      NA       NA     http://…
#>  7 7          NA        NA     NA       NA      NA       NA     http://…
#>  8 8          NA        NA     NA       NA      NA       NA     http://…
#>  9 9          NA        NA     NA       NA      NA       NA     http://…
#> 10 10         NA        NA     NA       NA      NA       NA     http://…
#> # ℹ 40 more rows
#> # ℹ 1 more variable: ref_url <chr>
# }