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!