Skip to main content

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

mlb_statcast_leaderboard_catcher_throwing​

GET /leaderboard/catcher-throwing — catcher throwing leaderboard.

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

Valid URL: https://baseballsavant.mlb.com/leaderboard/catcher-throwing?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.
sb_attemptsInt64Sb attempts.
catcher_stealing_runsFloat64Catcher stealing runs.
caught_stealing_above_averageFloat64Caught-stealing above average.
n_csInt64Caught stealing (count).
rate_csFloat64Rate cs.
est_cs_pctFloat64Expected caught stealing rate.
cs_aa_per_throwFloat64Cs aa per throw.
seasonal_runner_speedFloat64Seasonal runner speed.
runner_distance_from_secondFloat64Runner distance from second.
pop_timeFloat64Pop time.
exchange_timeFloat64Exchange time.
arm_strengthFloat64Arm strength (mph, top throws).
n_xcs_with_flight_over_xcsFloat64Number of xcs with flight over xcs.
n_xcs_with_exchange_over_xcsFloat64Number of xcs with exchange over xcs.
n_xcs_with_accuracy_over_xcsFloat64Number of xcs with accuracy over xcs.
n_xcs_with_ground_other_over_xcsFloat64Number of xcs with ground other over xcs.
n_xcs_with_onfly_other_over_xcsFloat64Number of xcs with onfly other over xcs.
n_xcs_with_untracked_other_over_xcsInt64Number of xcs with untracked other over xcs.

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_throwing()

mlb_statcast_leaderboard_catcher_stance​

GET /leaderboard/catcher-stance — catcher stance leaderboard.

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

Valid URL: https://baseballsavant.mlb.com/leaderboard/catcher-stance?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.
pitchesInt64Pitches.
knee_down_pctFloat64Share of pitches received in a knee-down stance.
l_down_r_up_pctFloat64L down r up rate.
r_down_l_up_pctFloat64R down l up rate.
both_down_pctFloat64Both down rate.
both_up_pctFloat64Both up rate.
extended_leg_pctFloat64Extended leg rate.
inside_down_pctFloat64Inside down rate.
outside_down_pctFloat64Outside down rate.
one_knee_framing_rvFloat64One knee framing rv.
other_framing_rvInt64Other framing rv.
one_knee_calledstr_pctFloat64One knee calledstr rate.
other_calledstr_pctStringOther calledstr rate.
one_knee_blocking_rvFloat64One knee blocking rv.
other_blocking_rvInt64Other blocking rv.
one_knee_pbwp100Float64One knee pbwp100.
other_pbwp100StringOther pbwp100.
one_knee_throwing_rvInt64One knee throwing rv.
other_throwing_rvInt64Other throwing rv.
one_knee_csaa100Int64One knee csaa100.
other_csaa100StringOther csaa100.
catching_rvFloat64Catching rv.
one_knee_pitching_rvFloat64One knee pitching rv.
other_pitching_rvFloat64Other pitching rv.

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_stance()

mlb_statcast_leaderboard_basestealing_run_value​

GET /leaderboard/basestealing-run-value — basestealing run-value leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/basestealing-run-value

Valid URL: https://baseballsavant.mlb.com/leaderboard/basestealing-run-value?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_stolen_on_running_actFloat64Runs stolen on running act.
n_initInt64Number of init.
rate_sbxInt64Rate 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_act_plusFloat64Net act plus.
net_act_minusFloat64Net act 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_sbxStringR primary lead sbx.
r_secondary_lead_sbxStringR secondary lead sbx.
r_sec_minus_prim_lead_sbxStringR 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_basestealing_run_value()

mlb_statcast_leaderboard_baserunning_run_value​

GET /leaderboard/baserunning-run-value — baserunning run-value leaderboard.

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/baserunning-run-value

Valid URL: https://baseballsavant.mlb.com/leaderboard/baserunning-run-value?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.
entity_nameStringPlayer (or team) entity name.
team_nameStringTeam name.
start_yearInt64First season in the range.
end_yearInt64Last season in the range.
runner_runs_totFloat64Runner runs tot.
runner_runs_xbFloat64Runner runs xb.
runner_runs_sbxFloat64Runner runs sbx.
n_runner_movedInt64Number of runner moved.
runner_runs_xb_swipeFloat64Runner runs xb swipe.
runner_runs_xb_snipeInt64Runner runs xb snipe.
runner_runs_xb_freezeFloat64Runner runs xb freeze.
n_runner_moved_xbInt64Number of runner moved xb.
runner_runs_sb2Float64Runner runs sb2.
runner_runs_sb3Float64Runner runs sb3.
simple_stolen_on_running_act_sb2Float64Simple stolen on running act sb2.
simple_stolen_on_running_act_sb3Float64Simple stolen on running act sb3.
n_runner_moved_sbxInt64Number of runner moved 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_baserunning_run_value()

mlb_statcast_leaderboard_baserunning​

GET /leaderboard/baserunning — extra-bases-taken run-value leaderboard.

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

Valid URL: https://baseballsavant.mlb.com/leaderboard/baserunning?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_nameStringTeam name.
yearInt64Season year.
runner_runsFloat64Baserunning run value as a runner.
fielder_runsFloat64Run value from the defense's perspective.
runner_runs_advancesFloat64Runner runs advances.
runner_runs_thrown_outInt64Runner runs thrown out.
runner_runs_holdFloat64Runner runs hold.
fielder_runs_advancesFloat64Fielder runs advances.
fielder_runs_thrown_outInt64Fielder runs thrown out.
fielder_runs_holdFloat64Fielder runs hold.
n_opp_xbInt64Number of opp xb.
n_att_xbInt64Number of att xb.
rate_att_xbFloat64Rate att xb.
est_rate_att_generic_runnerFloat64Expected rate att generic runner.
est_rate_att_generic_fielderFloat64Expected rate att generic fielder.
n_outInt64Number of out.
n_safeInt64Number of safe.
rate_safeFloat64Rate safe.
rate_safe_per_attemptInt64Rate safe per attempt.

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_baserunning()

mlb_statcast_leaderboard_year_to_year​

GET /leaderboard/statcast-year-to-year — year-to-year metric change leaderboard.

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

Valid URL: https://baseballsavant.mlb.com/leaderboard/statcast-year-to-year?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
nameStringPlayer (or entity) name.
entity_idInt64MLBAM id of the player/team entity.
2015String2015.
2016String2016.
delta_2015_2016StringDelta 2015 2016.
2017String2017.
delta_2016_2017StringDelta 2016 2017.
2018String2018.
delta_2017_2018StringDelta 2017 2018.
2019String2019.
delta_2018_2019StringDelta 2018 2019.
2020String2020.
delta_2019_2020StringDelta 2019 2020.
2021String2021.
delta_2020_2021StringDelta 2020 2021.
2022String2022.
delta_2021_2022StringDelta 2021 2022.
2023String2023.
delta_2022_2023StringDelta 2022 2023.
2024String2024.
delta_2023_2024StringDelta 2023 2024.
2025String2025.
delta_2024_2025StringDelta 2024 2025.
2026String2026.
delta_2025_2026StringDelta 2025 2026.

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_year_to_year()

mlb_statcast_leaderboard_timer_infractions​

GET /leaderboard/pitch-timer-infractions — pitch-timer infractions leaderboard.

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

Valid URL: https://baseballsavant.mlb.com/leaderboard/pitch-timer-infractions?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_idStringMLBAM id of the player/team entity.
entity_nameStringPlayer (or team) entity name.
yearStringSeason year.
pitchesStringPitches.
all_violationsStringPitch-timer violations (total).
pitcher_timerStringPitcher timer.
batter_timerStringBatter timer.
batter_timeoutStringBatter timeout.
catcher_timerStringCatcher timer.
defensive_shiftStringDefensive shift.

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_timer_infractions()

mlb_statcast_leaderboard_custom​

GET /leaderboard/custom — build-your-own metric leaderboard (comma-separated selections).

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

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

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
selectionsselectionsYselections query parameter.
filterfilterYfilter query parameter.
minminYmin query parameter.
sortsortYsort query parameter.
sortDirsort_dirYsortDir 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.
xbaFloat64Expected batting average.
xslgFloat64Expected slugging.
xwobaFloat64Expected 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_custom()

mlb_statcast_leaderboard_fielding_run_value​

GET /leaderboard/fielding-run-value — fielding run-value leaderboard (HTML-embedded JSON).

Endpoint URL: GET https://baseballsavant.mlb.com/leaderboard/fielding-run-value

Valid URL: https://baseballsavant.mlb.com/leaderboard/fielding-run-value

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam 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
total_runsFloat64Total runs.
inf_of_runsStringInf of runs.
range_runsStringRange runs.
arm_runsStringArm runs.
dp_runsStringDp runs.
catching_runsFloat64Catching runs.
framing_runsFloat64Framing runs.
throwing_runsFloat64Throwing runs.
blocking_runsFloat64Blocking runs.
outs_totalInt64Outs total.
tot_paInt64Tot pa.
outs_2Int64Outs 2.
outs_3Int64Outs 3.
outs_4Int64Outs 4.
outs_5Int64Outs 5.
outs_6Int64Outs 6.
outs_7Int64Outs 7.
outs_8Int64Outs 8.
outs_9Int64Outs 9.
idInt64MLBAM player id.
nameStringPlayer (or entity) name.
team_idInt64MLBAM team id.
n_teamsInt64Number of teams.
team_nameStringTeam name.

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_fielding_run_value()

mlb_statcast_leaderboard_park_factors​

GET /leaderboard/statcast-park-factors — Statcast park-factors leaderboard (HTML-embedded JSON).

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

Valid URL: https://baseballsavant.mlb.com/leaderboard/statcast-park-factors

API ParameterPythonPatternRequiredNullableDescription
typetypeYtype query parameter.
yearyearYyear query parameter.
teamteamYteam 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
grouping_venue_conditionsStringGrouping venue conditions.
key_is_year_rollingInt64Key is year rolling.
key_num_years_rollingInt64Key num years rolling.
key_yearInt64Key year.
key_bat_sideStringKey bat side.
venue_idInt64Venue id.
venue_nameStringBallpark name.
main_team_idInt64Main team id.
name_display_clubStringClub name.
n_paInt64Number of plate appearances.
index_runsInt64Index runs.
index_hardhitInt64Index hardhit.
index_wobaInt64Park factor index for wOBA (100 = neutral).
index_wobattoInt64Index wobatto.
index_wobaconInt64Index wobacon.
index_xwobaconInt64Index xwobacon.
index_xbaconInt64Index xbacon.
index_obpInt64Index obp.
index_soInt64Index so.
index_bbInt64Index bb.
index_baconInt64Index bacon.
index_hitsInt64Index hits.
index_1bInt64Index 1b.
index_2bInt64Index 2b.
index_3bInt64Index 3b.
index_hrInt64Index hr.
year_rangeStringYear range.

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_park_factors()