Docs
Coverage MatrixDocumentationRelease LogLog In

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), IF(Infield), 1B(First Base), 2B(Second Base), 3B(Third Base), SS(Shortstop), OF(Outfield), 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
Authorization
Query
Click Try It! to start a request and see the response here!