Integration GuidesDocs
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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
⏱️

Update Frequency

TTL / Cache: 12 hours

Data Updates: Seasonal stats update on a 5-minute timer after a game moves to closed

📘

Retrieving Game, Season, and Split Statistics

Learn how to use seasonal pitch analytics for player-level pitch mix and velocity trend analysis in our Retrieving Game, Season, and Split Statistics integration scenario.


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

L, R, B
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), D15 (15-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 of a player

L, R, B
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

Path Params
string
enum
required
Defaults to trial

The access level of your API key

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

Allowed:
string
enum
required
Defaults to en

2-letter code for supported languages

en (English)

Allowed:
string
required
Defaults to 6072398c-e2b4-405c-932a-aa05582114dc

Unique Id of a player

Example: 6072398c-e2b4-405c-932a-aa05582114dc

string
enum
required
Defaults to json

Format returned

json, xml

Allowed:
Response

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