Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Player Profile

MLB Player Profile provides player biographical information, including current and historical seasonal statistics and splits.

⏱️

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:

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
ex. New Mexico State

pro_debut

player

Date

Date of professional MLB debut
ex. 2008-05-25

pick

player - draft

Integer

Player's draft pick number within a round

round

player - draft

Integer

Player's draft pick round

team_id

player - draft

GUID

Unique ID of drafting team
ex. ea1a2111-44cc-4996-babb-9439465e6760

year

player - draft

Integer

Player's draft year

first_name

player

String

First name of a player
ex. Markus

full_name

player

String

Full name of a player
ex. Mookie Betts

height

player

Integer

Player height in inches

high_school

player

String

High school attended
ex. Pacifica (CA)

hof_year

player

Integer

Year a player was inducted into the MLB Hall of Fame
ex. 2024

id

player

GUID

Unique ID of a player
ex. ea1a2111-44cc-4996-babb-9439465e6760

jersey_number

player

Integer

Player's jersey number

last_name

player

String

Last name of a player
ex. Betts

position

player

String

Position of a player
C (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 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)

reference

player

Integer

Unique MLBAM ID of a player
ex. 477132

rookie_year

player

Integer

MLB rookie year of a player
ex. 2020

salary

player

Integer

Current annual salary of a player
ex. 15142857

status

player

String

Status 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

suffix

player

String

Suffix of a player
ex. Jr.

throw_hand

player

String

Throwing hand of a player
ex. L, R

weight

player

Integer

Player weight in lbs.

Player Baserunning Splits:

For the following statistics, we provide splits based on the categories of Away Games, By Month, By Opponent, By Surface, By Venue, Day Games, Home Games, Night Games, Vs. Lefties, and Vs. Righties

AttributeParent ElementTypeDescription
cssplits - hitting - overall - (Split) - statisticsIntegerNumber of times caught stealing
stolensplits - hitting - overall - (Split) - statisticsIntegerNumber of stolen bases
Player Hitting Splits:

For the following statistics, we provide splits based on the categories of Away Games, By Month, By Opponent, By Surface, By Venue, Day Games, Home Games, Night Games, Vs. Lefties, and Vs. Righties.

AttributeParent ElementTypeDescription
absplits - hitting - overall - (Split) - statisticsIntegerNumber of at bats
avgsplits - hitting - overall - (Split) - statisticsDecimalBatting average
ex. .333
dsplits - hitting - overall - (Split) - statisticsIntegerNumber of doubles
hbpsplits - hitting - overall - (Split) - statisticsIntegerNumber of hit by pitches
hsplits - hitting - overall - (Split) - statisticsIntegerNumber of hits
hrsplits - hitting - overall - (Split) - statisticsIntegerNumber of homeruns
ibbsplits - hitting - overall - (Split) - statisticsIntegerNumber of intentional walks
opssplits - hitting - overall - (Split) - statisticsDecimalOPS (On Base Percentage + Slugging Percentage)
ex. 0.833
obpsplits - hitting - overall - (Split) - statisticsDecimalOn Base Percentage
rbisplits - hitting - overall - (Split) - statisticsIntegerNumber of RBI (Runs Batted In)
ssplits - hitting - overall - (Split) - statisticsIntegerNumber of singles
slgsplits - hitting - overall - (Split) - statisticsDecimalSlugging Percentage
ex. 0.333
ktotalsplits - hitting - overall - (Split) - statisticsIntegerNumber of total strikeouts
runssplits - hitting - overall - (Split) - statisticsIntegerNumber of runs scored
tsplits - hitting - overall - (Split) - statisticsIntegerNumber of triples
bbsplits - hitting - overall - (Split) - statisticsIntegerNumber of walks
Player Pitching Splits:

For the following statistics, we provide splits based on the categories of Away Games, By Month, By Opponent, By Surface, By Venue, Day Games, Home Games, and Night Games.

Attribute

Parent Element

Type

Description

bb

splits - pitching - overall - (Split) - statistics

Integer

Number of walks

complete

splits - pitching - overall - (Split) - statistics

Integer

Number of complete games

era

splits - pitching - overall - (Split) - statistics

String

ERA (Earned Run Average)
ex. 2.299

Note: -- indicates an infinite ERA

er

splits - pitching - overall - (Split) - statistics

Integer

Number of earned runs allowed

play

splits - pitching - overall - (Split) - statistics

Integer

Number of games played

h

splits - pitching - overall - (Split) - statistics

Integer

Number of hits allowed

hr

splits - pitching - overall - (Split) - statistics

Integer

Number of homeruns allowed

ip_1

splits - pitching - overall - (Split) - statistics

Integer

Total number of outs recorded

ip_2

splits - pitching - overall - (Split) - statistics

Decimal

Total number of innings pitched
ex. 7.2 (7 2/3 innings)

ibb

splits - pitching - overall - (Split) - statistics

Integer

Number of intentional walks

loss

splits - pitching - overall - (Split) - statistics

Integer

Number of losses

oba

splits - pitching - overall - (Split) - statistics

Decimal

Opponents batting average
ex. 0.167

svo

splits - pitching - overall - (Split) - statistics

Integer

Number of save opportunities

save

splits - pitching - overall - (Split) - statistics

Integer

Number of saves

team_loss

splits - pitching - overall - (Split) - statistics

Integer

Number of team losses

team_win

splits - pitching - overall - (Split) - statistics

Integer

Number of team wins

runs

splits - pitching - overall - (Split) - statistics

Integer

Number of runs allowed

ktotal

splits - pitching - overall - (Split) - statistics

Integer

Number of strikeouts

win

splits - pitching - overall - (Split) - statistics

Integer

Number of wins

Player Pitching Splits (Handedness):

For the following statistics, we provide splits based on the categories of Vs. Lefties, Vs. Righties, and Vs. Switch Hitters.

AttributeParent ElementTypeDescription
bbsplits - pitching - overall - (Split) - statisticsIntegerNumber of walks
bfsplits - pitching - overall - (Split) - statisticsIntegerNumber of batters faced
dsplits - pitching - overall - (Split) - statisticsIntegerNumber of doubles allowed
hbpsplits - pitching - overall - (Split) - statisticsIntegerNumber of hit batters
hsplits - pitching - overall - (Split) - statisticsIntegerNumber of hits allowed
hrsplits - pitching - overall - (Split) - statisticsIntegerNumber of homeruns allowed
ibbsplits - pitching - overall - (Split) - statisticsIntegerNumber of intentional walks
obaplayer - statistics - pitching - overall / starters / bullpenDecimalOpponents Batting Average
opssplits - pitching - overall - (Split) - statisticsDecimalOpponents OPS (On Base Percentage + Slugging Percentage)
ex. 0.833
obpplayer - statistics - pitching - overall / starters / bullpenDecimalOpponents On Base Percentage
cssplits - pitching - overall - (Split) - statisticsIntegerNumber of times caught stealing
rbisplits - pitching - overall - (Split) - statisticsIntegerOpponent number of RBI (Runs Batted In)
ssplits - pitching - overall - (Split) - statisticsIntegerNumber of singles allowed
slgsplits - pitching - overall - (Split) - statisticsDecimalOpponents Slugging Percentage
ex. 0.357
sbsplits - pitching - overall - (Split) - statisticsIntegerNumber of stolen bases allowed
runssplits - pitching - overall - (Split) - statisticsIntegerNumber of runs allowed
ktotalsplits - pitching - overall - (Split) - statisticsIntegerNumber of strikeouts
tsplits - pitching - overall - (Split) - statisticsIntegerNumber of triples allowed
Player Baserunning Stats (Season):
AttributeParent ElementTypeDescription
caughthitting - overall - stealIntegerNumber of times caught stealing
pcthitting - overall - stealDecimalCaught stealing percentage
ex. 0.5
pickoffhitting - overall - stealDecimalNumber of times picked off
stolenhitting - overall - stealIntegerNumber of stolen bases
Player Fielding Stats (Season):
AttributeParent ElementTypeDescription
afielding - overallIntegerNumber of assists
outfieldfielding - overall - assistsIntegerNumber of outfield assists
totalfielding - overall - assistsIntegerNumber of total assists
completefielding - overall - gamesIntegerNumber of complete games played
dpfielding - overallIntegerNumber of double plays turned
errorfielding - overallIntegerNumber of errors committed
fieldingfielding - overall - errorsIntegerNumber of fielding errors committed
interferencefielding - overall - errorsIntegerNumber of interference errors committed
throwingfielding - overall - errorsIntegerNumber of throwing errors committed
totalfielding - overall - errorsIntegerTotal number of errors committed
fpctfielding - overallDecimalFielding percentage
ex. 0.969
finishfielding - overall - gamesIntegerNumber of games finished
playfielding - overall - gamesIntegerNumber of games played
startfielding - overall - gamesIntegerNumber of games started
inn_1fielding - overallIntegerTotal number of outs while in the field
inn_2fielding - overallDecimalTotal number of innings in the field
ex. 7.2 (7 2/3 innings)
pbfielding - overallIntegerNumber of passed balls
pofielding - overallIntegerNumber of putouts
rffielding - overallDecimalRange factor at a position. Determined by dividing the sum of a fielder's putouts and assists by their total number of defensive games played
outfieldfielding - overall - stealIntegerNumber of outfield assists
caughtfielding - overall - stealIntegerNumber of runners caught stealing
pctfielding - overall - stealDecimalCaught stealing percentage
ex. 0.5
pickofffielding - overall - stealIntegerNumber of successful pickoffs
stolenfielding - overall - stealIntegerNumber of stolen bases allowed
tcfielding - overallIntegerTotal number of fielding chances
tpfielding - overallIntegerNumber of triple plays turned
c_wpfielding - overallIntegerNumber of wild pitches while catching
Player Fielding Stats by Position (Season):
AttributeParent ElementTypeDescription
afielding - positionIntegerNumber of assists at a position
outfieldfielding - position - assistsIntegerNumber of outfield assists at a position
totalfielding - position - assistsIntegerNumber of total assists at a position
completefielding - position - gamesIntegerNumber of complete games played at a position
dpfielding - positionIntegerNumber of double plays turned at a position
errorfielding - positionIntegerNumber of errors committed at a position
fieldingfielding - position - errorsIntegerNumber of fielding errors committed at a position
interferencefielding - position - errorsIntegerNumber of interference errors committed at a position
throwingfielding - position - errorsIntegerNumber of throwing errors committed at a position
totalfielding - position - errorsIntegerTotal number of errors committed at a position
fpctfielding - positionDecimalFielding percentage at a position
ex. 0.969
finishfielding - position - gamesIntegerNumber of games finished at a position
playfielding - position - gamesIntegerNumber of games played at a position
startfielding - position - gamesIntegerNumber of games started at a position at a position
inn_1fielding - positionIntegerTotal number of outs while in the field at a position
inn_2fielding - positionDecimalTotal number of innings in the field at a position
ex. 7.2 (7 2/3 innings)
pbfielding - positionIntegerNumber of passed balls at a position
pofielding - overallIntegerNumber of putouts at a position
positionfielding - positionStringPosition 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)
rffielding - positionDecimalRange factor at a position. Determined by dividing the sum of a fielder's putouts and assists by their total number of defensive games played
outfieldfielding - position - stealIntegerNumber of outfield assists at a position
caughtfielding - position - stealIntegerNumber of runners caught stealing
pctfielding - position - stealDecimalCaught stealing percentage
ex. 0.5
pickofffielding - position - stealIntegerNumber of successful pickoffs
stolenfielding - position - stealIntegerNumber of stolen bases allowed
tcfielding - positionIntegerTotal number of fielding chances at a position
tpfielding - positionIntegerNumber of triple plays turned at a position
c_wpfielding - positionIntegerNumber of wild pitches while catching
Player Hitting Stats (Season):
AttributeParent ElementTypeDescription
abseason - statistics - hitting - overallIntegerNumber of at bats
abhrseason - statistics - hitting - overallDecimalAt bats per homerun
abkseason - statistics - hitting - overallDecimalAt bats per strikeout
ab_rispseason - statistics - hitting - overallIntegerNumber of at bats with runners in scoring position
ballseason - statistics - hitting - overall - outcomeIntegerNumber of at balls seen
bipseason - statistics - hitting - overallIntegerNumber of at balls hit in play
avgseason - statistics - hitting - overallIntegerBatting average
ex. .333
babipseason - statistics - hitting - overallIntegerBABIP (Batting average on balls in play)
ex. 0.333
ciseason - statistics - hitting - overall - onbaseIntegerNumber of at bats ending in a catcher's interference
completeseason - statistics - hitting - overall - gamesIntegerNumber of complete games played
cycleseason - statistics - hitting - overall - onbaseIntegerNumber of cycles (player hits a single, double, triple, and homerun)
dirtballseason - statistics - hitting - overall - outcomeIntegerNumber of dirtballs seen
dseason - statistics - hitting - overall - onbaseIntegerNumber of doubles
xbhseason - statistics - hitting - overallIntegerNumber of extra base hits
fcseason - statistics - hitting - overall - onbaseIntegerNumber of hits into fielder's choice
flyballseason - statistics - hitting - overallIntegerNumber of at flyballs
foseason - statistics - hitting - overall - outsIntegerNumber of fly outs
fidpseason - statistics - hitting - overall - outsIntegerNumber of fly outs into double plays
foulseason - statistics - hitting - overall - outcomeIntegerNumber of foul balls
finishseason - statistics - hitting - overall - gamesIntegerNumber of games finished
playseason - statistics - hitting - overall - gamesIntegerNumber of games played
startseason - statistics - hitting - overall - gamesIntegerNumber of games started
groundballseason - statistics - hitting - overallIntegerNumber of at groundballs
gofoseason - statistics - hitting - overallDecimalGround out/fly out ratio
ex. 2.0
goseason - statistics - hitting - overall - outsIntegerNumber of groundouts
gidpseason - statistics - hitting - overall - outsIntegerNumber of grounded into double plays
hbpseason - statistics - hitting - overall - onbaseIntegerNumber of hit by pitches
hseason - statistics - hitting - overall - onbaseIntegerNumber of hits
hit_rispseason - statistics - hitting - overallIntegerNumber of hits with runners in scoring position
hrseason - statistics - hitting - overall - onbaseIntegerNumber of homeruns
iballseason - statistics - hitting - overall - outcomeIntegerNumber of intentional balls taken
ibbseason - statistics - hitting - overall - onbaseIntegerNumber of intentional walks
isoseason - statistics - hitting - overallDecimalIsolated power
linedriveseason - statistics - hitting - overallIntegerNumber of at line drives
loseason - statistics - hitting - overall - outsIntegerNumber of lineouts
lidpseason - statistics - hitting - overall - outsIntegerNumber of lineouts into double plays
opsseason - statistics - hitting - overallDecimalOPS (On Base Percentage + Slugging Percentage)
ex. 0.833
obpseason - statistics - hitting - overallDecimalOn Base Percentage
pickoffseason - statistics - hitting - overall - stealIntegerNumber of times picked off
pitch_countseason - statistics - hitting - overallIntegerNumber of pitches seen
apseason - statistics - hitting - overallIntegerNumber of plate appearances
popupseason - statistics - hitting - overallIntegerNumber of popups
poseason - statistics - hitting - overall - outsIntegerNumber of putouts
roeseason - statistics - hitting - overall - onbaseIntegerNumber of times reached on error
rovseason - statistics - hitting - overall - onbaseIntegerNumber of at bats ending in a reached on violation
lobseason - statistics - hitting - overall - onbaseIntegerNumber of players left on base
lob_risp_2outseason - statistics - hitting - overall - onbaseIntegerNumber of players left on base with two outs and runners in scoring position
rbiseason - statistics - hitting - overall - onbaseIntegerNumber of RBI (Runs Batted In)
sacflyseason - statistics - hitting - overall - outsIntegerNumber of sacrifice flies
sachitseason - statistics - hitting - overall - outsIntegerNumber of sacrifice hits
secaseason - statistics - hitting - overallDecimalSecondary average
ex. 0.333
sseason - statistics - hitting - overall - onbaseIntegerNumber of singles
slgseason - statistics - hitting - overallDecimalSlugging Percentage
ex. 0.333
klookseason - statistics - hitting - overall - outsIntegerNumber of strikeouts looking
kswingseason - statistics - hitting - overall - outsIntegerNumber of strikeouts swinging
klookseason - statistics - hitting - overall - outcomeIntegerNumber of strikes looking
kswingseason - statistics - hitting - overall - outcomeIntegerNumber of strikes swinging
team_lobseason - statistics - hitting - overall - onbaseIntegerNumber of players left on base at the end of an inning
btotalseason - statistics - hitting - overall - pitchesIntegerNumber of balls seen
tbseason - statistics - hitting - overall - onbaseIntegerNumber of total bases
totalseason - statistics - hitting - overall - runsIntegerNumber of total runs scored
ktotalseason - statistics - hitting - overall - outsIntegerNumber of total strikeouts
ktotalseason - statistics - hitting - overall - outcomeIntegerNumber of strikes seen (not including balls in play)
ktotalseason - statistics - hitting - overall - pitchesIntegerNumber of strikes seen (including balls in play)
tseason - statistics - hitting - overall - onbaseIntegerNumber of triples
rbi_2outseason - statistics - hitting - overallIntegerNumber of 2-out RBI
bbseason - statistics - hitting - overall - onbaseIntegerNumber of walks
bbpaseason - statistics - hitting - overallDecimalWalks per plate appearance
ex. 0.25
bbkseason - statistics - hitting - overallDecimalWalks per strikeout
ex. 0.2
warseason - statistics - hitting - overallDecimalPosition player WAR
ex. 2.64635
bwarseason - statistics - hitting - overallDecimalBatting WAR (Batting runs above replacement)
ex. 13.7796
brwarseason - statistics - hitting - overallDecimalBaserunning WAR
ex. 2.69263
fwarseason - statistics - hitting - overallDecimalFielding WAR (Fielding runs above replacement)
ex. 2.46173
wgdpseason - statistics - hitting - overallDecimalWeighted Grounded into Double Plays
ex. -0.1
wobaseason - statistics - hitting - overallDecimalWeighted On-Base Average
ex. 0.38207
wraaseason - statistics - hitting - overallDecimalWeighted Runs Above Average
ex. 13.6581
wrcseason - statistics - hitting - overallDecimalwRC (Weighted Runs Created)
ex. 106.392
wrc_plusseason - statistics - hitting - overallDecimalwRC+ (Weighted Runs Created Plus)
ex. 133.134
Player Hitting Statcast Stats (Season):
Available with Statcast only
AttributeParent ElementTypeDescription
avgstatcast_metrics - hitting - max_heightDecimalAverage height of batted balls
countstatcast_metrics - hitting - max_heightIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - max_heightDecimalMaximum height of a batted ball
minstatcast_metrics - hitting - max_heightDecimalMinimum height of a batted ball
avgstatcast_metrics - hitting - launch_spin_rateDecimalAverage launch spin rate of batted balls
countstatcast_metrics - hitting - launch_spin_rateIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - launch_spin_rateDecimalMaximum launch spin rate of a batted ball
minstatcast_metrics - hitting - launch_spin_rateDecimalMinimum launch spin rate of a batted ball
avgstatcast_metrics - hitting - launch_speedDecimalAverage launch speed of batted balls
countstatcast_metrics - hitting - launch_speedIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - launch_speedDecimalMaximum exit velocity of a batted ball
minstatcast_metrics - hitting - launch_speedDecimalMinimum exity velocity of a batted ball
avgstatcast_metrics - hitting - barreled_ballDecimalThe average barrels per ball in play
countstatcast_metrics - hitting - barreled_ballIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - barreled_ballDecimalThe max barrels for a hitter on a ball in play (max is one)
minstatcast_metrics - hitting - barreled_ballDecimalThe minimum barrels for a hitter on a ball in play
avgstatcast_metrics - hitting - travel_timeDecimalAverage travel time of batted balls.
Travel time = The time (in seconds) from bat-on-ball contact until its return to ground level (z = 0)
countstatcast_metrics - hitting - travel_timeIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - travel_timeDecimalMaximum travel time of a batted ball
minstatcast_metrics - hitting - travel_timeDecimalMinimum travel time of a batted ball
avgstatcast_metrics - hitting - travel_distanceDecimalAverage travel distance of batted balls (in feet)
countstatcast_metrics - hitting - travel_distanceIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - travel_distanceDecimalMaximum travel distance of a batted ball
minstatcast_metrics - hitting - travel_distanceDecimalMinimum travel distance of a batted ball
avgstatcast_metrics - hitting - launch_angleDecimalAverage launch angle of batted balls
Launch angle = the vertical angle at which the ball leaves a player's bat after being struck
countstatcast_metrics - hitting - launch_angleIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - launch_angleDecimalMaximum launch angle of a batted ball
minstatcast_metrics - hitting - launch_angleDecimalMinimum launch angle of a batted ball
avgstatcast_metrics - hitting - hang_timeDecimalAverage hang time of batted balls
countstatcast_metrics - hitting - hang_timeIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - hang_timeDecimalMaximum hang time of a batted ball
minstatcast_metrics - hitting - hang_timeDecimalMinimum hang time of a batted ball
avgstatcast_metrics - hitting - homerun_distanceDecimalAverage home run distance
countstatcast_metrics - hitting - homerun_distanceIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - homerun_distanceDecimalMaximum home run distance
minstatcast_metrics - hitting - homerun_distanceDecimalMinimum home run distance
avgstatcast_metrics - hitting - generated_speedDecimalAverage generated speed in MPH
countstatcast_metrics - hitting - generated_speedIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - generated_speedDecimalMaximum generated speed
minstatcast_metrics - hitting - generated_speedDecimalMinimum generated speed
avgstatcast_metrics - hitting - distanceDecimalAverage hit ball before hitting the ground
countstatcast_metrics - hitting - distanceIntegerNumber of pitches counted towards the statistic
maxstatcast_metrics - hitting - distanceDecimalLongest hit ball before hitting the ground
minstatcast_metrics - hitting - distanceDecimalShortest hit ball before hitting the ground
Player Pitching Stats (Season):

Attribute

Parent Element

Type

Description

bk

season - statistics - pitching - overall / starters / bullpen

Integer

Number of balks

ball

season - statistics - pitching - overall / starters / bullpen - outcome

Integer

Number of balls thrown

bf

season - statistics - pitching - overall / starters / bullpen

Integer

Number of batters faced

bf_ip

season - statistics - pitching - overall / starters / bullpen

Decimal

Batters faced per inning pitched
ex. 3.5

bf_start

season - statistics - pitching - overall / starters / bullpen

Decimal

Batters faced per start
ex. 16.0

bqr

season - statistics - pitching - overall / starters / bullpen - runs

Integer

Number of bequeathed runners

bqra

season - statistics - pitching - overall / starters / bullpen - runs

Integer

Number of bequeathed runners allowed to score

blown_save

season - statistics - pitching - overall / starters / bullpen - games

Integer

Number of blown saves

ci

season - statistics - pitching - overall / starters / bullpen - onbase

Integer

Number of catcher's interferences allowed

complete

season - statistics - pitching - overall / starters / bullpen - games

Integer

Number of complete games

dirtball

season - statistics - pitching - overall / starters / bullpen - outcome

Integer

Number of dirtballs thrown

d

season - statistics - pitching - overall / starters / bullpen - onbase

Integer

Number of doubles allowed

era

season - statistics - pitching - overall / starters / bullpen

String

ERA (Earned Run Average)
ex. 4.5

Note: -- indicates an infinite ERA

era_minus

team - statistics - pitching - overall

Decimal

ERA- (ERA Minus)
ex. 76.7339

earned

season - statistics - pitching - overall / starters / bullpen - runs

Integer

Number of earned runs allowed

fc

season - statistics - pitching - overall / starters / bullpen - onbase

Integer

Number of fielder's choices allowed

fip

season - statistics - pitching - overall / starters / bullpen

Decimal

FIP (Fielding Independent Pitching)
ex. 4.5

fo

season - statistics - pitching - overall / starters / bullpen - outs

Integer

Number of fly outs

fidp

season - statistics - pitching - overall / starters / bullpen - outs

Integer

Number of fly outs into double plays

foul

season - statistics - hitting - overall / starters / bullpen - outcome

Integer

Number of foul balls

finish

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of games finished

play

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of games played

start

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of games started

gofo

season - statistics - hitting - overall / starters / bullpen

Decimal

Ground out/fly out ratio
ex. 2.0

go

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of groundouts

gidp

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of grounded into double plays

hbp

season - statistics - hitting - overall / starters / bullpen - onbase

Integer

Number of hit batters

h

season - statistics - hitting - overall / starters / bullpen - onbase

Integer

Number of hits allowed

h9

season - statistics - hitting - overall / starters / bullpen - onbase

Decimal

Hits allowed per nine innings
ex. 1.5

hold

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of holds

hr

season - statistics - hitting - overall / starters / bullpen - onbase

Integer

Number of homeruns allowed

hr9

season - statistics - hitting - overall / starters / bullpen - onbase

Decimal

Homeruns allowed per nine innings
ex. 4.5

ir

season - statistics - pitching - overall / starters / bullpen - runs

Integer

Number of inherited runners

ira

season - statistics - pitching - overall / starters / bullpen - runs

Integer

Number of inherited runners allowed to score

ip_1

season - statistics - hitting - overall / starters / bullpen

Integer

Total number of outs recorded

ip_2

season - statistics - hitting - overall / starters / bullpen

Decimal

Total number of innings pitched
ex. 7.2 (7 2/3 innings)

iball

season - statistics - pitching - overall / starters / bullpen - outcome

Integer

Number of intentional balls thrown

ibb

season - statistics - pitching - overall / starters / bullpen - outcome

Integer

Number of intentional walks

lo

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of lineouts

lidp

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of lineouts into double plays

loss

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of losses

oab

season - statistics - pitching - overall / starters / bullpen

Integer

Number of opponent at bats

oba

season - statistics - pitching - overall / starters / bullpen

Decimal

Opponents batting average
ex. 0.167

babip

season - statistics - pitching - overall / starters / bullpen

Decimal

Opponents BABIP (Batting average on balls in play)
ex. 0.333

flyball

season - statistics - pitching - overall / starters / bullpen - in-play

Integer

Number of fly balls allowed

gbfb

season - statistics - pitching - overall / starters / bullpen

Decimal

Opponents ground ball/fly ball ratio
ex. 2.5

groundball

season - statistics - pitching - overall / starters / bullpen - in-play

Integer

Number of ground balls allowed

linedrive

season - statistics - pitching - overall / starters / bullpen - in-play

Integer

Number of line drives allowed

obp

season - statistics - pitching - overall / starters / bullpen

Decimal

Opponents On Base Percentage

popups

season - statistics - pitching - overall / starters / bullpen - in-play

Integer

Number of popups allowed

lob

season - statistics - pitching - overall / starters / bullpen

Integer

Number of runners left on base

slg

season - statistics - pitching - overall / starters / bullpen

Decimal

Opponents Slugging Percentage
ex. 0.357

pickoff

season - statistics - pitching - overall / starters / bullpen - steal

Integer

Number of successful pickoffs

pitch_count

season - statistics - pitching - overall / starters / bullpen

Integer

Number of pitches thrown

per_bf

season - statistics - pitching - overall / starters / bullpen - pitches

Decimal

Number of pitches per batter faced
ex. - 3.813

per_ip

season - statistics - pitching - overall / starters / bullpen - pitches

Decimal

Number of pitches per inning pitched
ex. - 15.25

per_start

season - statistics - pitching - overall / starters / bullpen - pitches

Decimal

Number of pitches per start
ex. - 61.0

po

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of popouts

pitch_count

season - statistics - pitching - overall

Integer

Number of pitches thrown

gbfb

season - statistics - pitching - overall

Decimal

Opponents ground ball/fly ball ratio
ex. 2.5

qstart

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of quality starts (6 innings pitched & 3 or less earned runs allowed)

roe

season - statistics - hitting - overall / starters / bullpen - onbase

Integer

Number of times allowed to reached on error

rov

season - statistics - pitching - overall / starters / bullpen - onbase

Integer

Number of at bats ending in a reached on violation

caught

season - statistics - pitching - overall / starters / bullpen - steal

Integer

Number of times caught stealing

sacfly

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of sacrifice flies

sachit

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of sacrifice hits

svo

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of save opportunities

save

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of saves

shutout

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of shutouts

s

season - statistics - hitting - overall / starters / bullpen - onbase

Integer

Number of singles allowed

stolen

season - statistics - pitching - overall / starters / bullpen - steal

Integer

Number of stolen bases allowed

klook

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of strikeouts looking

k9

season - statistics - pitching - overall / starters / bullpen

Decimal

Strikeouts per nine innings
ex. 6.75

kbb

season - statistics - pitching - overall / starters / bullpen

Decimal

Strikeouts per walk ratio
ex. 1.5

kswing

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Number of strikeouts swinging

klook

season - statistics - pitching - overall / starters / bullpen - outcome

Integer

Number of strikes looking

kswing

season - statistics - pitching - overall / starters / bullpen - outcome

Integer

Number of strikes swinging

btotal

season - statistics - pitching - overall / starters / bullpen - pitches

Integer

Total number of balls thrown

tb

season - statistics - hitting - overall / starters / bullpen - onbase

Integer

Number of total bases allowed

count

season - statistics - pitching - overall / starters / bullpen - pitches

Integer

Total number of pitches thrown

total

season - statistics - pitching - overall / starters / bullpen - runs

Integer

Total number of runs allowed

ktotal

season - statistics - hitting - overall / starters / bullpen - outs

Integer

Total number of strikeouts

ktotal

season - statistics - pitching - overall / starters / bullpen - outcome

Integer

Total number of strikes thrown

ktotal

season - statistics - pitching - overall / starters / bullpen - pitches

Integer

Total number of strikes thrown

t

season - statistics - pitching - overall / starters / bullpen - onbase

Integer

Number of triples allowed

team_loss

season - statistics - pitching - overall / starters / bullpen - games

Integer

Number of team losses

team_win

season - statistics - pitching - overall / starters / bullpen - games

Integer

Number of team wins

unearned

season - statistics - pitching - overall / starters / bullpen - runs

Integer

Number of unearned runs allowed

bb

season - statistics - hitting - overall / starters / bullpen - onbase

Integer

Number of walks allowed

war

team - statistics - pitching - overall

Decimal

Pitching WAR
ex. 1.61167

whip

season - statistics - pitching - overall / starters / bullpen

Decimal

WHIP (Walks + Hits Per Inning Pitched)
ex. 4.75

wp

season - statistics - pitching - overall / starters / bullpen

Integer

Number of wild pitches thrown

win

season - statistics - hitting - overall / starters / bullpen - games

Integer

Number of wins

xfip

team - statistics - pitching - overall

Decimal

xFIP (Expected Fielding Independent Pitching)
ex. 3.03097

Player Pitching Statcast Stats (Season):
Available with Statcast only
AttributeParent ElementTypeDescription
avgstatcast_metrics - pitching - overall - launch_speedDecimalAverage launch speed of batted balls against
countstatcast_metrics - pitching - overall - launch_speedDecimalNumber of pitches counted towards the statistic
maxstatcast_metrics - pitching - overall - launch_speedDecimalMaximum launch speed of batted balls against
minstatcast_metrics - pitching - overall - launch_speedDecimalMinimum launch speed of batted balls against
Player Pitching Statcast Stats Per Pitch (Season):

Each of the below is available for every type of pitch (eg. Four-seam FB, Curveball) a pitcher throws\ Available with Statcast only

Attribute

Parent Element

Type

Description

type

statcast_metrics - pitching - pitch_types - pitch_type

Decimal

Type of pitch
ex. Four-seam FB

avg

statcast_metrics - pitching - pitch_types - launch_angle

Decimal

Average launch angle of batted balls
Launch angle = the vertical angle at which the ball leaves a player's bat after being struck

count

statcast_metrics - pitching - pitch_types - launch_angle

Decimal

Number of pitches counted towards the statistic

max

statcast_metrics - pitching - pitch_types - launch_angle

Decimal

Maximum launch angle of a batted ball

min

statcast_metrics - pitching - pitch_types - launch_angle

Decimal

Minimum launch angle of a batted ball

avg

statcast_metrics - pitching - pitch_types - release_spin_rate

Decimal

Average release spin rate
Spin rate = Rate of spin on the ball (in RPMs) after release by a pitcher

Available with Statcast only

count

statcast_metrics - pitching - pitch_types - release_spin_rate

Decimal

Number of pitches counted towards the statistic

max

statcast_metrics - pitching - pitch_types - release_spin_rate

Decimal

Maximum release spin rate

min

statcast_metrics - pitching - pitch_types - release_spin_rate

Decimal

Minimum release spin rate

avg

statcast_metrics - pitching - pitch_types - release_extension

Decimal

Average release extension
Extension = How much closer a pitcher's release point is to home plate relative to the 60 ft. 6 in. from the rubber

Available with Statcast only

count

statcast_metrics - pitching - pitch_types - release_extension

Decimal

Number of pitches counted towards the statistic

max

statcast_metrics - pitching - pitch_types - release_extension

Decimal

Maximum release extension

min

statcast_metrics - pitching - pitch_types - release_extension

Decimal

Minimum release extension

avg

statcast_metrics - pitching - pitch_types - release_speed

Decimal

Average release speed in MPH

count

statcast_metrics - pitching - pitch_types - release_speed

Decimal

Number of pitches counted towards the statistic

max

statcast_metrics - pitching - pitch_types - release_speed

Decimal

Maximum release speed

min

statcast_metrics - pitching - pitch_types - release_speed

Decimal

Minimum release speed

avg

statcast_metrics - pitching - pitch_types - effective_speed

Decimal

Average effective speed in MPH

count

statcast_metrics - pitching - pitch_types - effective_speed

Decimal

Number of pitches counted towards the statistic

max

statcast_metrics - pitching - pitch_types - effective_speed

Decimal

Maximum effective speed

min

statcast_metrics - pitching - pitch_types - effective_speed

Decimal

Minimum effective speed

avg

statcast_metrics - pitching - pitch_types - generated_speed

Decimal

Average generated speed in MPH

count

statcast_metrics - pitching - pitch_types - generated_speed

Decimal

Number of pitches counted towards the statistic

max

statcast_metrics - pitching - pitch_types - generated_speed

Decimal

Maximum generated speed

min

statcast_metrics - pitching - pitch_types - generated_speed

Decimal

Minimum generated speed

Teams:

All above stats are broken down by team affiliation (per season) under the team element.

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
Venue:
AttributeParent ElementTypeDescription
idvenueGUIDUnique ID of a venue
ex. 66a19c3d-24fe-477d-bee7-c6ef1b98352f
marketvenueStringMarket of a venue
ex. Los Angeles
namevenueStringName of a venue
ex. Dodger Stadium
surfacevenueStringSurface type of a venue
ex. grass
Language
Credentials
Header
Click Try It! to start a request and see the response here!