get https://api.sportradar.com/mlb//v7//players//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:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | season | GUID | Unique ID of a season ex. f5aa580e-8103-4ff5-beb0-965dbe8a8cf1 |
type | season | String | Type of seasonPRE(Spring Training), REG(Regular Season), PST(Postseason), AST(All-Star Game) |
year | season | Integer | Year of a season |
Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
bat_hand | player | String | Handedness of a hitter |
birthdate | player | Date | Player date of birth ex. 1988-03-19 |
birthcity | player | String | Player city of birth |
birthcountry | player | String | Player country of birth |
birthstate | player | String | Player state of birth |
college | player | String | College attended |
pro_debut | player | Date | Date of pro debut ex. 2008-05-25 |
first_name | player | String | First name of a player ex. Markus |
full_name | player | String | Full name of a player ex. Mookie Betts |
suffix | player | String | Name suffix of a player ex. Jr. |
height | player | Integer | Height in inches |
high_school | player | String | High school attended |
id | player | GUID | Unique ID of a player ex. ea1a2111-44cc-4996-babb-9439465e6760 |
jersey_number | player | Integer | Number of a player's jersey |
last_name | player | String | Last name of a player ex. Betts |
position | player | String | Position of a playerC(Catcher), IF(Infield), OF(Outfield), P(Pitcher), DH(Designated Hitter) |
preferred_name | player | String | Preferred name of a player ex. Mookie |
primary_position | player | String | Primary position of a playerC(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) |
reference | player | Integer | Unique MLBAM ID of a player |
status | player | String | Status of a playerA(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_hand | player | String | Throwing hand |
updated | player | dateTime | Timestamp of a player update ex. 2022-09-25T20:10:00+00:00 |
weight | player | Integer | Weight in lbs |
Player Pitching Stats (Season):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
d | season - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of doubles allowed |
foul | season - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Number of foul balls |
h | season - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of hits allowed |
hr | season - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of homeruns allowed |
flyball | season - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of fly balls allowed |
groundball | season - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of ground balls allowed |
linedrive | season - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of line drives allowed |
popups | season - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of popups allowed |
s | season - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of singles allowed |
klook | season - statistics - pitch_metrics - overall / pitch_types - outs | Integer | Number of strikeouts looking |
kswing | season - statistics - pitch_metrics - overall / pitch_types - outs | Integer | Number of strikeouts swinging |
klook | season - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Number of strikes looking |
kswing | season - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Number of strikes swinging |
btotal | season - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Total number of balls thrown |
ktotal | season - statistics - pitch_metrics - overall / pitch_types - outs | Integer | Total number of strikeouts |
ktotal | season - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Total number of strikes thrown |
t | season - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of triples allowed |
swing_rate | season - statistics - pitch_metrics - overall / pitch_types - swings | Decimal | Swing rate percentage ex. 60.5 |
strike_pct | season - statistics - pitch_metrics - overall / pitch_types - swings | Decimal | Strike percentage ex. 24.4 |
total | season - statistics - pitch_metrics - overall / pitch_types - swings | Integer | Number of swings induced |
whiff_rate | season - statistics - pitch_metrics - overall / pitch_types - swings | Decimal | Swing and miss percentage ex. 40.4 |
avg_speed | season - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Average speed of a type of pitch |
avg_speed | season - statistics - pitch_metrics - pitch_types - overall | Decimal | Average speed of all pitches |
count | season - statistics - pitch_metrics - pitch_types - pitch_type | Integer | Number of pitches thrown for a type of pitch |
count | season - statistics - pitch_metrics - pitch_types - overall | Integer | Number of pitches thrown |
gbfb | season - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Opponents ground ball/fly ball ratio for a type of pitch ex. 2.5 |
gbfb | season - statistics - pitch_metrics - pitch_types - overall | Decimal | Opponents ground ball/fly ball ratio ex. 2.5 |
max_speed | season - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Maximum speed of a type of pitch ex. 98.5 |
max_speed | season - statistics - pitch_metrics - pitch_types - overall | Decimal | Maximum speed of pitches thrown ex. 92.5 |
min_speed | season - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Minimum speed of a type of pitch ex. 82.9 |
min_speed | season - statistics - pitch_metrics - pitch_types - overall | Decimal | Minimum speed of pitches thrown ex. 76.9 |
type | season - statistics - pitch_metrics - pitch_types - pitch_type | String | Code for a type of pitchFA(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:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbr | season - team | String | Abbreviation of a team ex. TB (Tampa Bay) |
id | season - team | GUID | Unique ID of a team ex. bdc11650-6f74-49c4-875e-778aeb7632d9 |
market | season - team | String | Market name of a team ex. Tampa Bay |
name | season - team | String | Team name ex. Rays |