Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Statcast Leaders

MLB Statcast Leaders provides Statcast leader information for various hitting and pitching statistics.

Log in to see full request history

⏱️

Update Frequency

TTL / Cache: 120 seconds

Data Updates: As Necessary


Data Points

League:
AttributeParent ElementTypeDescription
aliasleagueStringAlias of a league
ex. MLB
idleagueGUIDUnique ID of a league
ex. 2fa448bc-fc17-4d3d-be03-e60e080fdc26
nameleagueStringName of a league
ex. Major League Baseball
idseasonGUIDUnique ID of a season
ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1
typeseasonStringType of season
PRE(Spring Training), REG(Regular Season), PST(Postseason), AST(All-Star Game)
yearseasonIntegerYear of a season
Player:
AttributeParent ElementTypeDescription
first_nameplayerStringFirst name of a player
ex. Markus
full_nameplayerStringFull name of a player
ex. Mookie Betts
suffixplayerStringName suffix of a player
ex. Jr.
idplayerGUIDUnique ID of a player
ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a runner
ex. Betts
positionplayerStringPosition of a player
C(Catcher), IF(Infield), OF(Outfield), P(Pitcher), DH(Designated Hitter)
preferred_nameplayerStringPreferred name of a player
ex. Mookie
primary_positionplayerStringPrimary position of a player
C (Catcher), 1B (First Base), 2B (Second Base), 3B (Third Base), SS (Shortstop), LF (Left Field), CF (Centerfield), P (Pitcher), RF (Right Field), RP (Relief Pitcher), SP (Starting Pitcher), DH (Designated Hitter)
statusplayerStringStatus of a player
A(Activated), BRV(Bereavement Leave), D7(7 Day Injured List), D10(10 Day Injured List), D60(60 Day Injured List), DFA(Designated for assignment), FA(Free agent), FME(Family Medical Emergency), LV(Paid Leave), MIN(Minors), NRI(Non-roster Invite), PL(Paternity Leave), RST(Restricted), RET(Retired), SUS(Suspended), UDP(Unsigned Draft Pick), WV(Waivers), DUP(Duplicate Profile), Null(Blank)(Traded or not activated)

*Traded players temporarily have no status listed after they are traded to a new team and are either activated by the MLB club or assigned to a minor league affiliate
Opposing Player:
AttributeParent ElementTypeDescription
first_nameopposing_playerStringFirst name of a player
ex. Markus
full_nameplayerStringFull name of a player
ex. Mookie Betts
suffixplayerStringName suffix of a player
ex. Jr.
idopposing_playerGUIDUnique ID of a player
ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberopposing_playerIntegerNumber of a player's jersey
last_nameopposing_playerStringLast name of a runner
ex. Betts
positionopposing_playerStringPosition of a player
C(Catcher), IF(Infield), OF(Outfield), P(Pitcher), DH(Designated Hitter)
preferred_nameopposing_playerStringPreferred name of a player
ex. Mookie
primary_positionopposing_playerStringPrimary position of a player
C (Catcher), 1B (First Base), 2B (Second Base), 3B (Third Base), SS (Shortstop), LF (Left Field), CF (Centerfield), P (Pitcher), RF (Right Field), RP (Relief Pitcher), SP (Starting Pitcher), DH (Designated Hitter)
statusopposing_playerStringStatus of a player
A(Activated), BRV(Bereavement Leave), D7(7 Day Injured List), D10(10 Day Injured List), D60(60 Day Injured List), DFA(Designated for assignment), FA(Free agent), FME(Family Medical Emergency), LV(Paid Leave), MIN(Minors), NRI(Non-roster Invite), PL(Paternity Leave), RST(Restricted), RET(Retired), SUS(Suspended), UDP(Unsigned Draft Pick), WV(Waivers), DUP(Duplicate Profile), Null(Blank)(Traded or not activated)

*Traded players temporarily have no status listed after they are traded to a new team and are either activated by the MLB club or assigned to a minor league affiliate
Statcast Leaders - Hitting:
AttributeParent ElementTypeDescription
barreled_ballbarreled_ball - average - playerDecimalBarreled ball percentage
barreled_ballbarreled_ball - max - playerDecimalMaximum barreled ball
distancedistance - average - playerDecimalAverage hit distance
distancedistance - max - playerDecimalMaximum hit distance
generated_speedgenerated_speed - average - playerDecimalAverage generated speed
generated_speedgenerated_speed - max - playerDecimalMaximum generated speed
hang_timehang_time - average - playerDecimalAverage hang time
hang_timehang_time - max - playerDecimalMaximum hang time
homerun_distancehomerun_distance - average - playerDecimalAverage homerun distance
homerun_distancehomerun_distance - max - playerDecimalMaximum homerun distance
launch_anglelaunch_angle - average - playerDecimalAverage launch angle
launch_anglelaunch_angle - max - playerDecimalMaximum launch angle
launch_speedlaunch_speed - average - playerDecimalAverage launch speed
launch_speedlaunch_speed - max - playerDecimalMaximum launch speed
launch_spin_ratelaunch_spin_rate - average - playerDecimalAverage launch spin rate
launch_spin_ratelaunch_spin_rate - max - playerDecimalMaximum launch spin rate
max_heightmax_height - average - playerDecimalThe average measured height (or projected height when not measured) of the batted ball
max_heightmax_height - max - playerDecimalThe maximum measured height (or projected height when not measured) of the batted ball
travel_distancetravel_distance - average - playerDecimalAverage travel distance
travel_distancetravel_distance - max - playerDecimalMaximum travel distance
travel_timetravel_time - average - playerDecimalAverage travel time
travel_timetravel_time - max - playerDecimalMaximum travel time
Statcast Leaders - Pitching:
AttributeParent ElementTypeDescription
effective_speedeffective_speed - average - playerDecimalAverage effective speed percentage
effective_speedeffective_speed - max - playerDecimalMaximum effective speed
generated_speedgenerated_speed - average - playerDecimalAverage generated speed
generated_speedgenerated_speed - max - playerDecimalMaximum generated speed
launch_anglelaunch_angle - average - playerDecimalAverage launch angle
launch_anglelaunch_angle - max - playerDecimalMaximum launch angle
launch_speedlaunch_speed - average - playerDecimalAverage launch speed
launch_speedlaunch_speed - max - playerDecimalMaximum launch speed
release_extensionrelease_extension - average - playerDecimalAverage release extension
release_extensionrelease_extension - max - playerDecimalMaximum release extension
release_speedrelease_speed - average - playerDecimalAverage release speed
release_speedrelease_speed - max - playerDecimalMaximum release speed
release_spin_raterelease_spin_rate - average - playerDecimalAverage release spin rate
release_spin_raterelease_spin_rate - max - playerDecimalMaximum release spin rate
Event Statcast Data:
AttributeParent ElementTypeDescription
countplayerIntegerNumber of pitches or hits counted towards the leaderboard statistic
maxplayerDecimalMaximum value of the leaderboard statistic
minplayerDecimalMinimum value of the leaderboard statistic
game_idplayerGUIDUnique ID of game in which statistic was recorded
ex. 37989cce-88b6-4191-ab74-ad5a3c8cf2b8
rankplayerIntegerPlayer rank for the leaderboard statistic
unitsplayerStringUnit of the leaderboard statistic
Teams:
AttributeParent ElementTypeDescription
abbrteamStringAbbreviation of a team
ex. TB (Tampa Bay)
idteamGUIDUnique ID of a team
ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketteamStringMarket name of a team
ex. Tampa Bay
nameteamStringTeam name
ex. Rays
Path Params
string
required
Defaults to trial

The access level of your API key

production (Production), trial (Trial),
tracking (Statcast Production), trial-tracking (Statcast Trial)

string
required
Defaults to en

2-letter code for supported languages

en (English)

string
required
Defaults to 2025

Year of a season in YYYY format

string
required
Defaults to REG

Type of season

REG (Regular Season)

string
required
Defaults to json

Format returned

json, xml

Response

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json