MLB Stats — mlb_stats • baseballr

MLB Stats

Usage

mlb_stats(
  stat_type = NULL,
  player_pool = NULL,
  game_type = NULL,
  team_id = NULL,
  position = NULL,
  stat_group = NULL,
  season = NULL,
  league_id = NULL,
  sport_ids = NULL,
  sort_stat = NULL,
  order = NULL,
  limit = 1000,
  offset = NULL
)

Arguments

stat_type

Stat type to return statistics for.

player_pool

There are 4 different types of player pools to return statistics for a particular player pool across a sport. Acceptable values include: All, Qualified, Rookies, or Qualified_rookies

game_type

Game type to return information for a particular statistic in a particular game type.

team_id

Team ID to return information and ranking for a particular statistic for a particular team.

position

Position to return statistics for a given position. Default to "Qualified" player pool Acceptable values include:

stat_group

Stat group to return information and ranking for a particular statistic in a particular group.

season

Year to return information and ranking for a particular statistic in a given year.

league_id

League ID to return statistics for a given league. Default to "Qualified" player pool.

sport_ids

The sport_id(s) to return information and ranking information for.

sort_stat

Sort return based on stat.

order

Order return based on either desc or asc.

limit

A limit to limit return to a particular number of records.

offset

An offset to returns i+1 as the first record in the set of players.

Value

Returns a tibble with the following columns

col_name	types	description
total_splits	integer	Total number of splits in the response.
season	character	Season year for the statistic.
num_teams	integer	Number of teams the player appeared for.
rank	integer	Rank of the player for the sorted statistic.
age	integer	Player age during the season.
games_played	integer	Games played.
ground_outs	integer	Ground outs.
air_outs	integer	Air outs (fly outs).
runs	integer	Runs scored.
doubles	integer	Doubles.
triples	integer	Triples.
home_runs	integer	Home runs.
strike_outs	integer	Strikeouts.
base_on_balls	integer	Walks (bases on balls).
intentional_walks	integer	Intentional walks.
hits	integer	Hits.
hit_by_pitch	integer	Times hit by pitch.
avg	character	Batting average.
at_bats	integer	At bats.
obp	character	On-base percentage.
slg	character	Slugging percentage.
ops	character	On-base plus slugging.
caught_stealing	integer	Times caught stealing.
stolen_bases	integer	Stolen bases.
stolen_base_percentage	character	Stolen base success percentage.
caught_stealing_percentage	character	Caught stealing percentage.
ground_into_double_play	integer	Grounded into double plays.
number_of_pitches	integer	Total pitches seen.
plate_appearances	integer	Plate appearances.
total_bases	integer	Total bases.
rbi	integer	Runs batted in.
left_on_base	integer	Runners left on base.
sac_bunts	integer	Sacrifice bunts.
sac_flies	integer	Sacrifice flies.
babip	character	Batting average on balls in play.
ground_outs_to_airouts	character	Ratio of ground outs to air outs.
catchers_interference	integer	Times reached on catcher's interference.
at_bats_per_home_run	character	At bats per home run.
team_id	integer	Team MLBAM ID.
team_name	character	Team name.
team_link	character	API link to the team.
player_id	integer	Player MLBAM ID.
player_full_name	character	Player full name.
player_link	character	API link to the player.
player_first_name	character	Player first name.
player_last_name	character	Player last name.
league_id	integer	League MLBAM ID.
league_name	character	League name.
league_link	character	API link to the league.
sport_id	integer	Sport MLBAM ID.
sport_link	character	API link to the sport.
sport_abbreviation	character	Sport abbreviation (e.g., MLB).
position_code	character	Primary position code.
position_name	character	Primary position name.
position_type	character	Primary position type.
position_abbreviation	character	Primary position abbreviation.
splits_tied_with_offset	list	Players tied at the offset boundary.
splits_tied_with_limit	list	Players tied at the limit boundary.
player_pool	character	Player pool used (e.g., QUALIFIED).
type_display_name	character	Stat type display name.
group_display_name	character	Stat group display name.

Examples

# \donttest{
  try(mlb_stats(stat_type = 'season', stat_group = 'hitting', season = 2021))
#> ── MLB Stats data from MLB.com ────────────────────── baseballr 2.0.0 ──
#> ℹ Data updated: 2026-06-08 11:09:28 UTC
#> # A tibble: 132 × 61
#>    total_splits season num_teams  rank   age games_played ground_outs
#>           <int> <chr>      <int> <int> <int>        <int>       <int>
#>  1          132 2021           2     1    28          148         141
#>  2          132 2021           1     2    37          143         131
#>  3          132 2021           1     3    22          151         160
#>  4          132 2021           1     4    34          121         141
#>  5          132 2021           1     5    22          161         161
#>  6          132 2021           2     6    32          120         140
#>  7          132 2021           1     7    28          141         112
#>  8          132 2021           1     8    28          123         163
#>  9          132 2021           1     9    29          138         117
#> 10          132 2021           2    10    29          155         156
#> # ℹ 122 more rows
#> # ℹ 54 more variables: air_outs <int>, runs <int>, doubles <int>,
#> #   triples <int>, home_runs <int>, strike_outs <int>,
#> #   base_on_balls <int>, intentional_walks <int>, hits <int>,
#> #   hit_by_pitch <int>, avg <chr>, at_bats <int>, obp <chr>, slg <chr>,
#> #   ops <chr>, caught_stealing <int>, stolen_bases <int>,
#> #   stolen_base_percentage <chr>, caught_stealing_percentage <chr>, …
# }