get https://api.sportradar.com/mlb//v7//games//pitch_metrics.
MLB Game Pitch Metrics provides detailed metrics on pitch type, velocity, and results for all pitchers in a given game.
Update Frequency
TTL / Cache: This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.
Data Updates: Realtime
Data Points
Boxscore:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
abbr | away | String | Abbreviation of the away team ex. MIN (Minnesota) |
abbr | home | String | Abbreviation of the home team ex. CIN (Cincinnati) |
id | away | GUID | Unique ID of the away team ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b |
id | home | GUID | Unique ID of the home team ex. 481dfe7e-5dab-46ab-a49f-9dcc2b6e2cfd |
market | away | String | Market name of the away team ex. Colorado |
market | home | String | Market name of the home team ex. Minnesota |
name | away | String | Team name of the away team ex. Rockies |
name | home | String | Team name of the home team ex. Twins |
Game:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
away_team | game | GUID | Unique ID of the away team ex. 29dd9a87-5bcc-4774-80c3-7f50d985068b |
cable | broadcast | String | Name of the game's broadcast cable station |
internet | broadcast | String | Name of the game's internet stream |
network | broadcast | String | Name of the game's broadcast network ex. MLB Network |
radio | broadcast | String | Name of the game's broadcast radio station |
satellite | broadcast | String | Name of the game's broadcast satellite station |
coverage | game | String | Coverage level of a gamefull, boxscore |
double_header | game | Boolean | Signifies whether a game is part of a double header |
day_night | game | String | Signifies a day or night gameD, N |
entry_mode | game | String | Signifies the type of data entrySTOMP, LDE |
home_team | game | GUID | Unique ID of the home team ex. ef64da7f-cfaf-4300-87b0-9313386b977c |
id | game | GUID | Unique ID of the game ex. 1b554f5e-d8b7-4268-95da-2f4191015c84 |
game_number | game | Integer | Number of the game |
parent_id | game | GUID | Standard parent ID of a game or series. Use this ID to group events (like the World Series or All-Star Game) across seasons. ex. 34e4cbbe-0086-4fad-bb08-840cbcfcabf0 (All-Star Game) |
reference | game | String | Unique MLBAM ID of a game |
scheduled | game | dateTime | Scheduled date and time of a game ex. 2022-09-25T20:10:00+00:00 |
season_id | game | GUID | Unique ID of the season a game belongs within ex. 6a5c278f-ebce-41f9-b1ba-2160b6af04ce |
season_type | game | String | Code type of the season a game belongs within ex. REG (Regular), PRE (Preseason), PST (Postseason), AST (All-Star) |
season_year | game | Integer | Year of the season a game belongs within |
tbd | game | Boolean | Signifies the game start time is to be determined. Placeholder start time is 08:00:00+00:00 |
split_squad | game | Boolean | Signifies a Spring Training split squad game |
status | game | String | The status of a gamescheduled, inprogress, complete, closed, wdelay, fdelay, odelay, canceled, unnecessary, if-necessary, postponed, suspended, maintenance |
Player:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
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. |
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 runner 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) |
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 |
Player Pitching Stats (Game):
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
d | player - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of doubles allowed |
foul | player - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Number of foul balls |
h | player - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of hits allowed |
hr | player - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of homeruns allowed |
flyball | player - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of fly balls allowed |
groundball | player - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of ground balls allowed |
linedrive | player - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of line drives allowed |
popups | player - statistics - pitch_metrics - overall / pitch_types - in-play | Integer | Number of popups allowed |
s | player - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of singles allowed |
klook | player - statistics - pitch_metrics - overall / pitch_types - outs | Integer | Number of strikeouts looking |
kswing | player - statistics - pitch_metrics - overall / pitch_types - outs | Integer | Number of strikeouts swinging |
klook | player - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Number of strikes looking |
kswing | player - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Number of strikes swinging |
btotal | player - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Total number of balls thrown |
ktotal | player - statistics - pitch_metrics - overall / pitch_types - outs | Integer | Total number of strikeouts |
ktotal | player - statistics - pitch_metrics - overall / pitch_types - outcome | Integer | Total number of strikes thrown |
t | player - statistics - pitch_metrics - overall / pitch_types - onbase | Integer | Number of triples allowed |
swing_rate | player - statistics - pitch_metrics - overall / pitch_types - swings | Decimal | Swing rate percentage ex. 60.5 |
strike_pct | player - statistics - pitch_metrics - overall / pitch_types - swings | Decimal | Strike percentage ex. 24.4 |
total | player - statistics - pitch_metrics - overall / pitch_types - swings | Integer | Number of swings induced |
whiff_rate | player - statistics - pitch_metrics - overall / pitch_types - swings | Decimal | Swing and miss percentage ex. 40.4 |
avg_speed | player - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Average speed of a type of pitch |
avg_speed | player - statistics - pitch_metrics - pitch_types - overall | Decimal | Average speed of all pitches |
count | player - statistics - pitch_metrics - pitch_types - pitch_type | Integer | Number of pitches thrown for a type of pitch |
count | player - statistics - pitch_metrics - pitch_types - overall | Integer | Number of pitches thrown |
gbfb | player - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Opponents ground ball/fly ball ratio for a type of pitch ex. 2.5 |
gbfb | player - statistics - pitch_metrics - pitch_types - overall | Decimal | Opponents ground ball/fly ball ratio ex. 2.5 |
max_speed | player - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Maximum speed of a type of pitch ex. 98.5 |
max_speed | player - statistics - pitch_metrics - pitch_types - overall | Decimal | Maximum speed of pitches thrown ex. 92.5 |
min_speed | player - statistics - pitch_metrics - pitch_types - pitch_type | Decimal | Minimum speed of a type of pitch ex. 82.9 |
min_speed | player - statistics - pitch_metrics - pitch_types - overall | Decimal | Minimum speed of pitches thrown ex. 76.9 |
type | player - 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 |
Series:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
ps_game | game | Integer | Game number in a series |
ps_round | game | String | Name of a series ex. ALDS |
Venue:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
address | venue | String | Address of a venue ex. 1000 Vin Scully Avenue |
capacity | venue | String | Capacity of a venue ex. 56000 |
city | venue | String | City of a venue ex. Los Angeles |
country | venue | String | Country of a venue ex. USA |
field_orientation | venue | String | Field orientation of a venue ex. NE |
id | venue | GUID | Unique ID of a venue ex. 66a19c3d-24fe-477d-bee7-c6ef1b98352f |
lat | location | Decimal | Latitude of a venue ex. 34.0745409 |
lng | location | Decimal | Longitude of a venue ex. -118.2408881 |
market | venue | String | Market of a venue ex. Los Angeles |
name | venue | String | Name of a venue ex. Dodger Stadium |
stadium_type | venue | String | Type of a venue ex. outdoor |
state | venue | String | State of a venue ex. CA |
surface | venue | String | Surface type of a venue ex. grass |
time_zone | venue | String | Time zone of a venue ex. US/Central |
zip | venue | Integer | ZIP code of a venue ex. 90012 |