Skip to main content

MLB — MLB Statcast (Baseball Savant) — Leaderboard: expected–catcher

mlb_statcast_leaderboard_expected_stats​

GET /leaderboard/expected_statistics — xBA/xSLG/xwOBA/xISO expected-statistics leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/expected_statistics

Valid URL: https://baseballsavant.mlb.com/leaderboard/expected_statistics?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idInt64MLBAM player id.
yearInt64Season year.
paInt64Plate appearances.
bipInt64Balls in play.
baFloat64Batting average.
est_baFloat64Expected batting average (xBA).
est_ba_minus_ba_diffFloat64xBA minus actual BA (over/under-performance).
slgFloat64Slugging percentage.
est_slgFloat64Expected slugging (xSLG).
est_slg_minus_slg_diffFloat64xSLG minus actual SLG.
wobaFloat64Weighted on-base average.
est_wobaFloat64Expected wOBA (xwOBA).
est_woba_minus_woba_diffFloat64xwOBA minus actual wOBA.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_expected_stats()

mlb_statcast_leaderboard_percentile_rankings​

GET /leaderboard/percentile-rankings — player percentile-ranking sliders (xwOBA/xBA/xSLG/…).

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/percentile-rankings

Valid URL: https://baseballsavant.mlb.com/leaderboard/percentile-rankings?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
player_nameStringPlayer name.
player_idInt64MLBAM player id.
yearInt64Season year.
xwobaStringExpected wOBA.
xbaStringExpected batting average.
xslgStringExpected slugging.
xisoStringExpected isolated power.
xobpStringExpected on-base percentage.
brlStringBarrels.
brl_percentStringBarrel rate (% of batted balls).
exit_velocityStringExit velocity (mph).
max_evInt64Max ev.
hard_hit_percentStringHard-hit rate (95+ mph EV).
k_percentStringStrikeout rate.
bb_percentStringWalk rate.
whiff_percentStringWhiff rate (swings and misses / swings).
chase_percentStringChase rate.
arm_strengthInt64Arm strength (mph, top throws).
sprint_speedInt64Sprint speed (ft/sec, top 50% of competitive runs).
oaaInt64Outs Above Average.
bat_speedStringBat speed (mph).
squared_up_rateStringSquared up rate.
swing_lengthStringSwing length (ft, head travel).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_percentile_rankings()

mlb_statcast_leaderboard_sprint_speed​

GET /leaderboard/sprint_speed — sprint-speed (ft/sec) leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/sprint_speed

Valid URL: https://baseballsavant.mlb.com/leaderboard/sprint_speed?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idInt64MLBAM player id.
team_idInt64MLBAM team id.
teamStringTeam abbreviation.
positionStringPosition.
ageInt64Player age.
competitive_runsInt64Competitive runs (qualifying sprint-speed runs).
boltsInt64Bolts.
hp_to_1bFloat64Home-to-first time (s).
sprint_speedFloat64Sprint speed (ft/sec, top 50% of competitive runs).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_sprint_speed()

mlb_statcast_leaderboard_running_splits​

GET /leaderboard/running_splits — 90-foot running splits leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/running_splits

Valid URL: https://baseballsavant.mlb.com/leaderboard/running_splits?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idInt64MLBAM player id.
name_abbrevStringTeam/name abbreviation.
team_idInt64MLBAM team id.
position_nameStringPosition name.
ageInt64Player age.
bat_sideStringBatter side (R/L/S).
seconds_since_hit_000Float64Seconds since hit 000.
seconds_since_hit_005Float64Seconds since hit 005.
seconds_since_hit_010Float64Seconds since hit 010.
seconds_since_hit_015Float64Seconds since hit 015.
seconds_since_hit_020Float64Seconds since hit 020.
seconds_since_hit_025Float64Seconds since hit 025.
seconds_since_hit_030Float64Seconds since hit 030.
seconds_since_hit_035Float64Seconds since hit 035.
seconds_since_hit_040Float64Seconds since hit 040.
seconds_since_hit_045Float64Seconds since hit 045.
seconds_since_hit_050Float64Seconds since hit 050.
seconds_since_hit_055Float64Seconds since hit 055.
seconds_since_hit_060Float64Seconds since hit 060.
seconds_since_hit_065Float64Seconds since hit 065.
seconds_since_hit_070Float64Seconds since hit 070.
seconds_since_hit_075Float64Seconds since hit 075.
seconds_since_hit_080Float64Seconds since hit 080.
seconds_since_hit_085Float64Seconds since hit 085.
seconds_since_hit_090Float64Seconds since hit 090.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_running_splits()

mlb_statcast_leaderboard_bat_tracking​

GET /leaderboard/bat-tracking — bat-tracking (swing speed / squared-up) leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/bat-tracking

Valid URL: https://baseballsavant.mlb.com/leaderboard/bat-tracking?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64MLBAM player id.
nameStringPlayer (or entity) name.
swings_competitiveInt64Competitive swings.
percent_swings_competitiveFloat64Share of swings that are competitive.
contactInt64Contact.
avg_bat_speedFloat64Average bat speed (mph).
hard_swing_rateFloat64Hard swing rate.
squared_up_per_bat_contactFloat64Squared up per bat contact.
squared_up_per_swingFloat64Squared-up rate per swing.
blast_per_bat_contactFloat64Blast per bat contact.
blast_per_swingFloat64Blasts per swing.
swing_lengthFloat64Swing length (ft, head travel).
swordsInt64Swords.
batter_run_valueFloat64Batter run value.
whiffsStringWhiffs.
whiff_per_swingStringWhiff per swing.
batted_ball_eventsInt64Batted ball events.
batted_ball_event_per_swingFloat64Batted ball event per swing.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_bat_tracking()

mlb_statcast_leaderboard_swing_path​

GET /leaderboard/bat-tracking/swing-path-attack-angle — swing path & attack-angle leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/bat-tracking/swing-path-attack-angle

Valid URL: https://baseballsavant.mlb.com/leaderboard/bat-tracking/swing-path-attack-angle?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64MLBAM player id.
nameStringPlayer (or entity) name.
sideStringSide.
avg_bat_speedFloat64Average bat speed (mph).
swing_tiltFloat64Swing tilt (deg).
attack_angleFloat64Attack angle (deg, bat path at contact).
attack_directionFloat64Attack direction (deg, pull/oppo).
ideal_attack_angle_rateFloat64Rate of swings in the ideal attack-angle window.
avg_intercept_y_vs_plateFloat64Avg intercept y vs plate.
avg_intercept_y_vs_batterFloat64Avg intercept y vs batter.
avg_batter_y_positionFloat64Avg batter y position.
avg_batter_x_positionFloat64Avg batter x position.
competitive_swingsInt64Competitive swings.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_swing_path()

mlb_statcast_leaderboard_swing_timing​

GET /leaderboard/bat-tracking/swing-timing-miss-distance — swing timing & miss-distance leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/bat-tracking/swing-timing-miss-distance

Valid URL: https://baseballsavant.mlb.com/leaderboard/bat-tracking/swing-timing-miss-distance?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64MLBAM player id.
nameStringPlayer (or entity) name.
yearInt64Season year.
team_nameStringTeam name.
bat_side_formattedStringBatter side (formatted).
miss_distanceFloat64Average miss distance (in) on swings.
flawed_percentFloat64Flawed rate.
perfect_percentFloat64Perfect rate.
tied_up_percentFloat64Tied up rate.
avg_x_tied_upFloat64Avg x tied up.
centered_percentFloat64Centered rate.
flailed_percentFloat64Flailed rate.
avg_x_flailFloat64Avg x flail.
early_percentFloat64Early rate.
avg_y_earlyFloat64Avg y early.
on_time_percentFloat64On time rate.
late_percentFloat64Late rate.
avg_y_lateFloat64Avg y late.
n_swingsInt64Number of swings.
whiff_rateFloat64Whiff rate.
competitive_percentFloat64Competitive rate.
over_percentFloat64Over rate.
avg_z_overFloat64Avg z over.
lined_up_percentFloat64Lined up rate.
under_percentFloat64Under rate.
avg_z_underFloat64Avg z under.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_swing_timing()

mlb_statcast_leaderboard_swing_take​

GET /leaderboard/swing-take — swing/take run-value leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/swing-take

Valid URL: https://baseballsavant.mlb.com/leaderboard/swing-take?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
yearStringSeason year.
last_name, first_nameStringLast name, first name.
player_idStringMLBAM player id.
team_idStringMLBAM team id.
paStringPlate appearances.
pitchesStringPitches.
runs_allStringRuns all.
runs_heartStringRuns heart.
runs_shadowStringRuns shadow.
runs_chaseStringRuns chase.
runs_wasteStringRuns waste.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_swing_take()

mlb_statcast_leaderboard_exit_velocity_barrels​

GET /leaderboard/statcast — exit velocity & barrels leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/statcast

Valid URL: https://baseballsavant.mlb.com/leaderboard/statcast?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idInt64MLBAM player id.
attemptsInt64Opportunities/attempts.
avg_hit_angleFloat64Average launch angle (deg).
anglesweetspotpercentFloat64Anglesweetspotpercent.
max_hit_speedFloat64Max exit velocity (mph).
avg_hit_speedFloat64Average exit velocity (mph).
ev50Float64Ev50.
fbldFloat64Fbld.
gbFloat64Gb.
max_distanceInt64Max distance.
avg_distanceInt64Avg distance.
avg_hr_distanceInt64Avg hr distance.
ev95plusInt64Ev95plus.
ev95percentFloat64Ev95percent.
barrelsInt64Barrels.
brl_percentFloat64Barrel rate (% of batted balls).
brl_paFloat64Barrels per plate appearance.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_exit_velocity_barrels()

mlb_statcast_leaderboard_batted_ball​

GET /leaderboard/batted-ball — batted-ball profile leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/batted-ball

Valid URL: https://baseballsavant.mlb.com/leaderboard/batted-ball?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64MLBAM player id.
nameStringPlayer (or entity) name.
yearInt64Season year.
bbeInt64Batted-ball events.
gb_rateFloat64Gb rate.
air_rateFloat64Air rate.
fb_rateFloat64Fb rate.
ld_rateFloat64Ld rate.
pu_rateFloat64Pu rate.
pull_rateFloat64Pull rate.
straight_rateFloat64Straight rate.
oppo_rateFloat64Oppo rate.
pull_gb_rateFloat64Pull gb rate.
straight_gb_rateFloat64Straight gb rate.
oppo_gb_rateFloat64Oppo gb rate.
pull_air_rateFloat64Pull air rate.
straight_air_rateFloat64Straight air rate.
oppo_air_rateFloat64Oppo air rate.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_batted_ball()

mlb_statcast_leaderboard_home_runs​

GET /leaderboard/home-runs — Statcast home-runs leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/home-runs

Valid URL: https://baseballsavant.mlb.com/leaderboard/home-runs?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
playerStringPlayer.
player_idInt64MLBAM player id.
team_abbrevStringTeam abbreviation.
yearInt64Season year.
typeStringRecord/pitch type.
avg_hr_trotFloat64Avg hr trot.
doubtersInt64Doubters.
mostly_goneInt64Mostly gone.
no_doubtersInt64No doubters.
no_doubter_perFloat64No doubter per.
hr_totalInt64Hr total.
xhrFloat64Xhr.
xhr_diffFloat64Xhr diff.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_home_runs()

mlb_statcast_leaderboard_pitch_arsenals​

GET /leaderboard/pitch-arsenals — pitch arsenals (velo/spin/movement) leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/pitch-arsenals

Valid URL: https://baseballsavant.mlb.com/leaderboard/pitch-arsenals?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
pitcherInt64MLBAM id of the pitcher.
ff_batterStringFf batter.
si_batterStringSi batter.
fc_batterStringFc batter.
sl_batterStringSl batter.
ch_batterStringCh batter.
cu_batterStringCu batter.
fs_batterStringFs batter.
kn_batterStringKn batter.
st_batterStringSt batter.
sv_batterStringSv batter.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_pitch_arsenals()

mlb_statcast_leaderboard_pitch_arsenal_stats​

GET /leaderboard/pitch-arsenal-stats — per-pitch-type outcome stats leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/pitch-arsenal-stats

Valid URL: https://baseballsavant.mlb.com/leaderboard/pitch-arsenal-stats?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idInt64MLBAM player id.
team_name_altStringTeam name (alternate form).
pitch_typeStringPitch type code.
pitch_nameStringPitch type name.
run_value_per_100Float64Run value per 100 pitches.
run_valueInt64Run value (runs).
pitchesInt64Pitches.
pitch_usageFloat64Pitch usage.
paInt64Plate appearances.
baFloat64Batting average.
slgFloat64Slugging percentage.
wobaFloat64Weighted on-base average.
whiff_percentFloat64Whiff rate (swings and misses / swings).
k_percentFloat64Strikeout rate.
put_awayFloat64Put away.
est_baFloat64Expected batting average (xBA).
est_slgFloat64Expected slugging (xSLG).
est_wobaFloat64Expected wOBA (xwOBA).
hard_hit_percentFloat64Hard-hit rate (95+ mph EV).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_pitch_arsenal_stats()

mlb_statcast_leaderboard_pitch_movement​

GET /leaderboard/pitch-movement — pitch-movement leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/pitch-movement

Valid URL: https://baseballsavant.mlb.com/leaderboard/pitch-movement?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
yearInt64Season year.
last_name, first_nameStringLast name, first name.
pitcher_idInt64MLBAM id of the pitcher.
team_nameStringTeam name.
team_name_abbrevStringTeam name abbrev.
pitch_handStringPitcher handedness (R/L).
avg_speedInt64Average pitch velocity (mph).
pitches_thrownInt64Pitches thrown.
total_pitchesInt64Total pitches.
pitches_per_gameFloat64Pitches per game.
pitch_perFloat64Pitch per.
pitch_typeStringPitch type code.
pitch_type_nameStringPitch type name.
pitcher_break_zFloat64Pitcher break z.
league_break_zFloat64League break z.
diff_zFloat64Diff z.
riseInt64Rise.
pitcher_break_z_inducedFloat64Pitcher break z induced.
pitcher_break_xFloat64Pitcher break x.
league_break_xFloat64League break x.
diff_xFloat64Diff x.
tailInt64Tail.
percent_rank_diff_zFloat64Percent rank diff z.
percent_rank_diff_xFloat64Percent rank diff x.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_pitch_movement()

mlb_statcast_leaderboard_pitch_tempo​

GET /leaderboard/pitch-tempo — pitch-tempo leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/pitch-tempo

Valid URL: https://baseballsavant.mlb.com/leaderboard/pitch-tempo?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
entity_idInt64MLBAM id of the player/team entity.
entity_nameStringPlayer (or team) entity name.
entity_codeStringEntity code.
team_idInt64MLBAM team id.
total_pitchesInt64Total pitches.
total_pitches_emptyInt64Total pitches empty.
median_seconds_emptyFloat64Median tempo (s) with bases empty.
total_pitches_onbaseInt64Total pitches onbase.
freq_hotFloat64Freq hot.
freq_warmFloat64Freq warm.
freq_coldFloat64Freq cold.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_pitch_tempo()

mlb_statcast_leaderboard_active_spin​

GET /leaderboard/active-spin — active-spin leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/active-spin

Valid URL: https://baseballsavant.mlb.com/leaderboard/active-spin?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
entity_nameStringPlayer (or team) entity name.
entity_idInt64MLBAM id of the player/team entity.
pitch_handStringPitcher handedness (R/L).
active_spin_fourseamStringActive spin fourseam.
active_spin_sinkerFloat64Active spin sinker.
active_spin_cutterFloat64Active spin cutter.
active_spin_changeupFloat64Active spin changeup.
active_spin_splitterStringActive spin splitter.
active_spin_curveStringActive spin curve.
active_spin_sliderFloat64Active spin slider.
active_spin_sweeperFloat64Active spin sweeper.
active_spin_slurveStringActive spin slurve.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_active_spin()

mlb_statcast_leaderboard_spin_direction​

GET /leaderboard/spin-direction-pitches — spin-direction (per-pitch) leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/spin-direction-pitches

Valid URL: https://baseballsavant.mlb.com/leaderboard/spin-direction-pitches?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
yearInt64Season year.
last_name, first_nameStringLast name, first name.
player_idInt64MLBAM player id.
pitch_handStringPitcher handedness (R/L).
api_pitch_typeStringPitch type (API code).
n_pitchesInt64Number of pitches.
release_speedFloat64Release speed.
spin_rateInt64Spin rate (rpm).
movement_inchesFloat64Movement inches.
alan_active_spin_pctFloat64Alan active spin rate.
active_spinFloat64Active (useful) spin (%).
hawkeye_measuredFloat64Hawkeye measured.
movement_inferredFloat64Movement inferred.
api_pitch_nameStringApi pitch name.
active_spin_formattedInt64Active spin (formatted, %).
hawkeye_measured_clock_minutesInt64Hawkeye measured clock minutes.
movement_inferred_clock_minutesInt64Movement inferred clock minutes.
diff_measured_inferredFloat64Diff measured inferred.
diff2Float64Diff2.
diff_measured_inferred_minutesInt64Diff measured inferred minutes.
hawkeye_measured_clock_hhInt64Hawkeye measured clock hh.
hawkeye_measured_clock_mmInt64Hawkeye measured clock mm.
movement_inferred_clock_hhInt64Movement inferred clock hh.
movement_inferred_clock_mmInt64Movement inferred clock mm.
diff_clock_hhInt64Diff clock hh.
diff_clock_mmInt64Diff clock mm.
hawkeye_measured_clock_labelStringHawkeye measured clock label.
movement_inferred_clock_labelStringMovement inferred clock label.
diff_clock_labelStringDiff clock label.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_spin_direction()

mlb_statcast_leaderboard_arm_angles​

GET /leaderboard/pitcher-arm-angles — pitcher arm-angle leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/pitcher-arm-angles

Valid URL: https://baseballsavant.mlb.com/leaderboard/pitcher-arm-angles?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
pitcherInt64MLBAM id of the pitcher.
pitcher_nameStringPitcher name.
pitch_handStringPitcher handedness (R/L).
n_pitchesInt64Number of pitches.
team_idInt64MLBAM team id.
ball_angleFloat64Arm slot angle (deg).
relative_release_ball_xFloat64Relative release ball x.
release_ball_zFloat64Release ball z.
relative_shoulder_xFloat64Relative shoulder x.
shoulder_zFloat64Shoulder z.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_arm_angles()

mlb_statcast_leaderboard_pitcher_running_game​

GET /leaderboard/pitcher-running-game — pitcher running-game (holding runners) leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/pitcher-running-game

Valid URL: https://baseballsavant.mlb.com/leaderboard/pitcher-running-game?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
player_idInt64MLBAM player id.
player_nameStringPlayer name.
team_nameStringTeam name.
start_yearInt64First season in the range.
end_yearInt64Last season in the range.
key_target_baseStringKey target base.
runs_prevented_on_running_attrFloat64Runs prevented on running attr.
n_pitcher_cs_aaFloat64Number of pitcher cs aa.
n_initInt64Number of init.
rate_sbxFloat64Rate sbx.
n_sbInt64Stolen bases allowed (count).
n_csInt64Caught stealing (count).
n_pkInt64Number of pk.
n_bkInt64Number of bk.
n_fbInt64Number of fb.
n_plusInt64Number of plus.
n_minusInt64Number of minus.
net_attr_plusFloat64Net attr plus.
net_attr_minusFloat64Net attr minus.
r_primary_leadFloat64Average primary lead distance (ft).
r_secondary_leadFloat64Average secondary lead (ft).
r_sec_minus_prim_leadFloat64R sec minus prim lead.
r_primary_lead_sbxFloat64R primary lead sbx.
r_secondary_lead_sbxFloat64R secondary lead sbx.
r_sec_minus_prim_lead_sbxFloat64R sec minus prim lead sbx.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_pitcher_running_game()

mlb_statcast_leaderboard_outs_above_average​

GET /leaderboard/outs_above_average — Outs Above Average (OAA) fielding leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/outs_above_average

Valid URL: https://baseballsavant.mlb.com/leaderboard/outs_above_average?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idStringMLBAM player id.
display_team_nameStringTeam display name.
yearStringSeason year.
primary_pos_formattedStringPrimary position (formatted).
fielding_runs_preventedStringFielding Run Value (runs).
outs_above_averageStringOuts Above Average.
outs_above_average_infrontStringOuts above average infront.
outs_above_average_lateral_toward3blineStringOuts above average lateral toward3bline.
outs_above_average_lateral_toward1blineStringOuts above average lateral toward1bline.
outs_above_average_behindStringOuts above average behind.
outs_above_average_rhhStringOuts above average rhh.
outs_above_average_lhhStringOuts above average lhh.
actual_success_rate_formattedStringActual success rate formatted.
adj_estimated_success_rate_formattedStringAdj estimated success rate formatted.
diff_success_rate_formattedStringDiff success rate formatted.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_outs_above_average()

mlb_statcast_leaderboard_outfield_directional_oaa​

GET /leaderboard/outfield_directional_outs_above_average — outfield directional OAA leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/outfield_directional_outs_above_average

Valid URL: https://baseballsavant.mlb.com/leaderboard/outfield_directional_outs_above_average?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idInt64MLBAM player id.
attemptsInt64Opportunities/attempts.
n_outs_above_averageInt64Outs Above Average (count).
n_oaa_slice_back_leftInt64Number of oaa slice back left.
n_oaa_slice_backInt64Number of oaa slice back.
n_oaa_slice_back_rightInt64Number of oaa slice back right.
n_oaa_slice_back_allInt64Number of oaa slice back all.
n_oaa_slice_in_leftInt64Number of oaa slice in left.
n_oaa_slice_inInt64Number of oaa slice in.
n_oaa_slice_in_rightInt64Number of oaa slice in right.
n_oaa_slice_in_allInt64Number of oaa slice in all.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_outfield_directional_oaa()

mlb_statcast_leaderboard_outfield_jump​

GET /leaderboard/outfield_jump — outfielder jump leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/outfield_jump

Valid URL: https://baseballsavant.mlb.com/leaderboard/outfield_jump?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
resp_fielder_idInt64MLBAM id of the responsible fielder.
yearInt64Season year.
outs_above_averageInt64Outs Above Average.
outs_per_playFloat64Outs per play.
rel_league_burst_distanceInt64Rel league burst distance.
rel_league_reaction_distanceFloat64Rel league reaction distance.
rel_league_routing_distanceFloat64Rel league routing distance.
rel_league_bootup_distanceFloat64Rel league bootup distance.
f_bootup_distanceFloat64F bootup distance.
nInt64Sample count (pitches/events).
n_outsInt64Number of outs.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_outfield_jump()

mlb_statcast_leaderboard_catch_probability​

GET /leaderboard/catch_probability — outfielder catch-probability leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/catch_probability

Valid URL: https://baseballsavant.mlb.com/leaderboard/catch_probability?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
last_name, first_nameStringLast name, first name.
player_idStringMLBAM player id.
oaaStringOuts Above Average.
n_fieldout_5starsString5-star (hardest) plays made.
n_opp_5starsString5-star play opportunities.
n_5star_percentStringNumber of 5star rate.
n_fieldout_4starsStringNumber of fieldout 4stars.
n_opp_4starsStringNumber of opp 4stars.
n_4star_percentStringNumber of 4star rate.
n_fieldout_3starsStringNumber of fieldout 3stars.
n_opp_3starsStringNumber of opp 3stars.
n_3star_percentStringNumber of 3star rate.
n_fieldout_2starsStringNumber of fieldout 2stars.
n_opp_2starsStringNumber of opp 2stars.
n_2star_percentStringNumber of 2star rate.
n_fieldout_1starsStringNumber of fieldout 1stars.
n_opp_1starsStringNumber of opp 1stars.
n_1star_percentStringNumber of 1star rate.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_catch_probability()

mlb_statcast_leaderboard_arm_strength​

GET /leaderboard/arm-strength — fielder arm-strength leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/arm-strength

Valid URL: https://baseballsavant.mlb.com/leaderboard/arm-strength?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
fielder_nameStringFielder name.
player_idInt64MLBAM player id.
team_nameStringTeam name.
primary_positionInt64Primary fielding position.
primary_position_nameStringPrimary position name.
total_throwsInt64Total throws.
total_throws_1bInt64Total throws 1b.
total_throws_2bInt64Total throws 2b.
total_throws_3bInt64Total throws 3b.
total_throws_ssInt64Total throws ss.
total_throws_lfInt64Total throws lf.
total_throws_cfInt64Total throws cf.
total_throws_rfInt64Total throws rf.
total_throws_infInt64Total throws inf.
total_throws_ofInt64Total throws of.
max_arm_strengthFloat64Max arm strength (mph).
arm_1bFloat64Arm 1b.
arm_2bStringArm 2b.
arm_3bStringArm 3b.
arm_ssStringArm ss.
arm_lfStringArm lf.
arm_cfStringArm cf.
arm_rfStringArm rf.
arm_infStringArm inf.
arm_ofStringArm of.
arm_overallFloat64Arm overall.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_arm_strength()

mlb_statcast_leaderboard_poptime​

GET /leaderboard/poptime — catcher pop-time leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/poptime

Valid URL: https://baseballsavant.mlb.com/leaderboard/poptime?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
entity_nameStringPlayer (or team) entity name.
entity_idInt64MLBAM id of the player/team entity.
team_idInt64MLBAM team id.
ageInt64Player age.
maxeff_arm_2b_3b_sbaFloat64Max-effort arm velo to 2B/3B (mph).
exchange_2b_3b_sbaFloat64Transfer/exchange time (s).
pop_2b_sba_countInt64Pop-time sample (throws to 2B).
pop_2b_sbaFloat64Pop time to 2B on stolen-base attempts (s).
pop_2b_csFloat64Pop 2b cs.
pop_2b_sbFloat64Pop 2b sb.
pop_3b_sba_countInt64Pop 3b sba count.
pop_3b_sbaFloat64Pop 3b sba.
pop_3b_csFloat64Pop 3b cs.
pop_3b_sbFloat64Pop 3b sb.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_poptime()

mlb_statcast_leaderboard_catcher_framing​

GET /leaderboard/catcher-framing — catcher framing leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/catcher-framing

Valid URL: https://baseballsavant.mlb.com/leaderboard/catcher-framing?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
idInt64MLBAM player id.
nameStringPlayer (or entity) name.
pitchesInt64Pitches.
rv_totFloat64Total framing run value.
pct_totFloat64Total called-strike rate.
rv_11Int64Rv 11.
pct_11Float64Pct 11.
rv_12Int64Rv 12.
pct_12Float64Pct 12.
rv_13Int64Rv 13.
pct_13Int64Pct 13.
rv_14Int64Rv 14.
pct_14Float64Pct 14.
rv_16Int64Rv 16.
pct_16Float64Pct 16.
rv_17Int64Rv 17.
pct_17Float64Pct 17.
rv_18Int64Rv 18.
pct_18Float64Pct 18.
rv_19Int64Rv 19.
pct_19Float64Pct 19.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_catcher_framing()

mlb_statcast_leaderboard_catcher_blocking​

GET /leaderboard/catcher-blocking — catcher blocking leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/catcher-blocking

Valid URL: https://baseballsavant.mlb.com/leaderboard/catcher-blocking?csv=true

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam query parameter.
csvcsvYcsv query parameter.

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
player_idInt64MLBAM player id.
player_nameStringPlayer name.
team_nameStringTeam name.
start_yearInt64First season in the range.
end_yearStringLast season in the range.
pitchesInt64Pitches.
catcher_blocking_runsInt64Catcher blocking runs.
blocks_above_averageInt64Blocks above average.
n_pbwpInt64Number of pbwp.
x_pbwpFloat64X pbwp.
blocks_above_average_per_gameFloat64Blocks above average per game.
freq_pbwp_easyFloat64Freq pbwp easy.
freq_pbwp_mediumFloat64Freq pbwp medium.
freq_pbwp_toughFloat64Freq pbwp tough.
diff_pbwp_easyFloat64Diff pbwp easy.
diff_pbwp_mediumFloat64Diff pbwp medium.
diff_pbwp_toughFloat64Diff pbwp tough.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

mlb_statcast_leaderboard_catcher_blocking()