mlb_stats_leaders: *MLB Stats Leaders*

In baseballr: Acquiring and Analyzing Baseball Data

MLB Stats Leaders

Description

MLB Stats Leaders

Usage

mlb_stats_leaders(
  leader_categories = NULL,
  player_pool = NULL,
  leader_game_types = NULL,
  sit_codes = NULL,
  position = NULL,
  stat_group = NULL,
  season = NULL,
  league_id = NULL,
  sport_id = NULL,
  start_date = NULL,
  end_date = NULL,
  stat_type = NULL,
  limit = 1000
)

Arguments

leader_categories	League leader category to return information and ranking for a particular statistic.
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
leader_game_types	Game type to return information and ranking for a particular statistic in a particular game type.
sit_codes	Situation code to return information and ranking for a particular statistic in a particular game type.
position	Position to return statistics for a given position. Default to "Qualified" player pool Acceptable values include: P C 1B 2B 3B SS LF CF RF DH PH PR BR OF IF SP RP CP UT UI UO RHP LHP RHS LHS LHR RHR B X
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_id	The sport_id to return information and ranking information for.
start_date	Start date to return information and ranking for a particular statistic for a particular date range. Format: MM/DD/YYYY start_date must be coupled with end_date and byDateRange stat_type
end_date	End date to return information and ranking for a particular statistic for a particular date range. Format: MM/DD/YYYY end_date must be coupled with start_date and byDateRange stat_type
stat_type	The stat_type to return information and ranking for a particular statistic for a particular stat type.
limit	A limit to limit return to a particular number of records.

Value

Returns a tibble with the following columns

col_name	types	description
leader_category	character	Statistical leader category (e.g., homeRuns).
rank	integer	Rank within the leaderboard.
value	character	Statistic value for the leader.
season	character	Season year.
num_teams	integer	Number of teams the player appeared for.
team_id	integer	Team MLBAM ID.
team_name	character	Team name.
team_link	character	API link to the team.
league_id	integer	League MLBAM ID.
league_name	character	League name.
league_link	character	API link to the league.
person_id	integer	Player MLBAM ID.
person_full_name	character	Player full name.
person_link	character	API link to the player.
person_first_name	character	Player first name.
person_last_name	character	Player last name.
sport_id	integer	Sport MLBAM ID.
sport_link	character	API link to the sport.
sport_abbreviation	character	Sport abbreviation (e.g., MLB).
stat_group	character	Stat group (e.g., hitting).
total_splits	integer	Total number of splits in the leaderboard.
game_type_id	character	Game type code (e.g., R for regular season).
game_type_description	character	Game type description.

Examples

 try(mlb_stats_leaders(leader_categories='homeRuns',sport_id=1, season = 2021))

baseballr documentation built on Aug. 27, 2026, 1:07 a.m.