Get ESPN MLB Team Season Statistics (Long Format with Rank)

Returns the full team-season-type statistics sheet for one MLB team in long format: one row per (category x stat). Each row carries the team's league rank for that stat where ESPN provides it (rank + rank_display_value). Complements espn_mlb_team_record() (W-L only) with the full stat package.

Usage

espn_mlb_team_season_statistics(
  team_id,
  season = most_recent_mlb_season(),
  season_type = 2L,
  ...
)

Arguments

team_id

ESPN team identifier.

season

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

season_type

Integer season type: 1 = preseason, 2 = regular (default), 3 = postseason.

...

Additional arguments; currently unused.

Value

A long tibble with one row per (category x stat).

col_name	types	description
league	character	League.
season	integer	Season (4-digit year).
season_type	integer	ESPN season type (1=pre, 2=regular, 3=post).
team_id	character	Unique ESPN team identifier.
category_name	character	Statistic category name.
category_display	character	Category display.
stat_name	character	Statistic name.
stat_abbrev	character	Stat abbrev.
stat_display	character	Stat display.
value	numeric	Numeric value.
display_value	character	Human-readable value.
rank	integer	Rank within the result set.
rank_display_value	character	Rank display value.

See also

Other ESPN MLB Functions: espn_mlb, espn_mlb_athletes_index(), 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_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_team_season_statistics(team_id = 13, season = 2024)
#> ── ESPN MLB Team Season Statistics ────────────────── baseballr 2.0.0 ──
#> ℹ Data updated: 2026-06-08 11:08:09 UTC
#> # A tibble: 170 × 13
#>    league season season_type team_id category_name category_display
#>    <chr>   <int>       <int> <chr>   <chr>         <chr>           
#>  1 mlb      2024           2 13      batting       Batting         
#>  2 mlb      2024           2 13      batting       Batting         
#>  3 mlb      2024           2 13      batting       Batting         
#>  4 mlb      2024           2 13      batting       Batting         
#>  5 mlb      2024           2 13      batting       Batting         
#>  6 mlb      2024           2 13      batting       Batting         
#>  7 mlb      2024           2 13      batting       Batting         
#>  8 mlb      2024           2 13      batting       Batting         
#>  9 mlb      2024           2 13      batting       Batting         
#> 10 mlb      2024           2 13      batting       Batting         
#> # ℹ 160 more rows
#> # ℹ 7 more variables: stat_name <chr>, stat_abbrev <chr>,
#> #   stat_display <chr>, value <dbl>, display_value <chr>, rank <int>,
#> #   rank_display_value <chr>
# }