Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Seasonal Pitch Metrics

MLB Seasonal Pitch Metrics provides detailed metrics on pitch type, velocity, and results for a given pitcher by season.

⏱️

Update Frequency

TTL / Cache: 2 seconds

Data Updates: As Necessary


Data Points

League
AttributeParent ElementTypeDescription
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
bat_handplayerStringHandedness of a hitter
birthdateplayerDatePlayer date of birth
ex. 1988-03-19
birthcityplayerStringPlayer city of birth
birthcountryplayerStringPlayer country of birth
birthstateplayerStringPlayer state of birth
collegeplayerStringCollege attended
pro_debutplayerDateDate of pro debut
ex. 2008-05-25
first_nameplayerStringFirst name of a player
ex. Markus
full_nameplayerStringFull name of a player
ex. Mookie Betts
suffixplayerStringName suffix of a player
ex. Jr.
heightplayerIntegerHeight in inches
high_schoolplayerStringHigh school attended
idplayerGUIDUnique ID of a player
ex. ea1a2111-44cc-4996-babb-9439465e6760
jersey_numberplayerIntegerNumber of a player's jersey
last_nameplayerStringLast name of a player
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)
referenceplayerIntegerUnique MLBAM ID of a player
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
throw_handplayerStringThrowing hand
updatedplayerdateTimeTimestamp of a player update
ex. 2022-09-25T20:10:00+00:00
weightplayerIntegerWeight in lbs
Player Pitching Stats (Season)
AttributeParent ElementTypeDescription
dseason - statistics - pitch_metrics - overall / pitch_types - onbaseIntegerNumber of doubles allowed
foulseason - statistics - pitch_metrics - overall / pitch_types - outcomeIntegerNumber of foul balls
hseason - statistics - pitch_metrics - overall / pitch_types - onbaseIntegerNumber of hits allowed
hrseason - statistics - pitch_metrics - overall / pitch_types - onbaseIntegerNumber of homeruns allowed
flyballseason - statistics - pitch_metrics - overall / pitch_types - in-playIntegerNumber of fly balls allowed
groundballseason - statistics - pitch_metrics - overall / pitch_types - in-playIntegerNumber of ground balls allowed
linedriveseason - statistics - pitch_metrics - overall / pitch_types - in-playIntegerNumber of line drives allowed
popupsseason - statistics - pitch_metrics - overall / pitch_types - in-playIntegerNumber of popups allowed
sseason - statistics - pitch_metrics - overall / pitch_types - onbaseIntegerNumber of singles allowed
klookseason - statistics - pitch_metrics - overall / pitch_types - outsIntegerNumber of strikeouts looking
kswingseason - statistics - pitch_metrics - overall / pitch_types - outsIntegerNumber of strikeouts swinging
klookseason - statistics - pitch_metrics - overall / pitch_types - outcomeIntegerNumber of strikes looking
kswingseason - statistics - pitch_metrics - overall / pitch_types - outcomeIntegerNumber of strikes swinging
btotalseason - statistics - pitch_metrics - overall / pitch_types - outcomeIntegerTotal number of balls thrown
ktotalseason - statistics - pitch_metrics - overall / pitch_types - outsIntegerTotal number of strikeouts
ktotalseason - statistics - pitch_metrics - overall / pitch_types - outcomeIntegerTotal number of strikes thrown
tseason - statistics - pitch_metrics - overall / pitch_types - onbaseIntegerNumber of triples allowed
swing_rateseason - statistics - pitch_metrics - overall / pitch_types - swingsDecimalSwing rate percentage
ex. 60.5
strike_pctseason - statistics - pitch_metrics - overall / pitch_types - swingsDecimalStrike percentage
ex. 24.4
totalseason - statistics - pitch_metrics - overall / pitch_types - swingsIntegerNumber of swings induced
whiff_rateseason - statistics - pitch_metrics - overall / pitch_types - swingsDecimalSwing and miss percentage
ex. 40.4
avg_speedseason - statistics - pitch_metrics - pitch_types - pitch_typeDecimalAverage speed of a type of pitch
avg_speedseason - statistics - pitch_metrics - pitch_types - overallDecimalAverage speed of all pitches
countseason - statistics - pitch_metrics - pitch_types - pitch_typeIntegerNumber of pitches thrown for a type of pitch
countseason - statistics - pitch_metrics - pitch_types - overallIntegerNumber of pitches thrown
gbfbseason - statistics - pitch_metrics - pitch_types - pitch_typeDecimalOpponents ground ball/fly ball ratio for a type of pitch
ex. 2.5
gbfbseason - statistics - pitch_metrics - pitch_types - overallDecimalOpponents ground ball/fly ball ratio
ex. 2.5
max_speedseason - statistics - pitch_metrics - pitch_types - pitch_typeDecimalMaximum speed of a type of pitch
ex. 98.5
max_speedseason - statistics - pitch_metrics - pitch_types - overallDecimalMaximum speed of pitches thrown
ex. 92.5
min_speedseason - statistics - pitch_metrics - pitch_types - pitch_typeDecimalMinimum speed of a type of pitch
ex. 82.9
min_speedseason - statistics - pitch_metrics - pitch_types - overallDecimalMinimum speed of pitches thrown
ex. 76.9
typeseason - statistics - pitch_metrics - pitch_types - pitch_typeStringCode for a type of pitch
FA(Fastball), SI(Sinker), CT(Cutter), CU(Curveball), SL(Slider), CH(Changeup), KN(Knuckleball), SP(Splitter), SC(Screwball), FO(Forkball), IB(Intentional Ball), PI(Pitchout), Other
Teams
AttributeParent ElementTypeDescription
abbrseason - teamStringAbbreviation of a team
ex. TB (Tampa Bay)
idseason - teamGUIDUnique ID of a team
ex. bdc11650-6f74-49c4-875e-778aeb7632d9
marketseason - teamStringMarket name of a team
ex. Tampa Bay
nameseason - teamStringTeam name
ex. Rays

Language
Credentials
Header
Click Try It! to start a request and see the response here!