MLB — MLB Statcast (Baseball Savant) — Leaderboard: year–park
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
type | type | Y | type query parameter. | ||
year | year | Y | year query parameter. | ||
team | team | Y | team query parameter. | ||
csv | csv | Y | csv 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_name | type | description |
|---|---|---|
name | character | Player (or entity) name. |
entity_id | integer | MLBAM id of the player/team entity. |
2015 | character | 2015. |
2016 | character | 2016. |
delta_2015_2016 | character | Delta 2015 2016. |
2017 | character | 2017. |
delta_2016_2017 | character | Delta 2016 2017. |
2018 | character | 2018. |
delta_2017_2018 | character | Delta 2017 2018. |
2019 | character | 2019. |
delta_2018_2019 | character | Delta 2018 2019. |
2020 | character | 2020. |
delta_2019_2020 | character | Delta 2019 2020. |
2021 | character | 2021. |
delta_2020_2021 | character | Delta 2020 2021. |
2022 | character | 2022. |
delta_2021_2022 | character | Delta 2021 2022. |
2023 | character | 2023. |
delta_2022_2023 | character | Delta 2022 2023. |
2024 | character | 2024. |
delta_2023_2024 | character | Delta 2023 2024. |
2025 | character | 2025. |
delta_2024_2025 | character | Delta 2024 2025. |
2026 | character | 2026. |
delta_2025_2026 | character | Delta 2025 2026. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_year_to_year()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
type | type | Y | type query parameter. | ||
year | year | Y | year query parameter. | ||
team | team | Y | team query parameter. | ||
csv | csv | Y | csv 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_name | type | description |
|---|---|---|
entity_id | character | MLBAM id of the player/team entity. |
entity_name | character | Player (or team) entity name. |
year | character | Season year. |
pitches | character | Pitches. |
all_violations | character | Pitch-timer violations (total). |
pitcher_timer | character | Pitcher timer. |
batter_timer | character | Batter timer. |
batter_timeout | character | Batter timeout. |
catcher_timer | character | Catcher timer. |
defensive_shift | character | Defensive shift. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_timer_infractions()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
type | type | Y | type query parameter. | ||
year | year | Y | year query parameter. | ||
selections | selections | Y | selections query parameter. | ||
filter | filter | Y | filter query parameter. | ||
min | min | Y | min query parameter. | ||
sort | sort | Y | sort query parameter. | ||
sortDir | sort_dir | Y | sortDir query parameter. | ||
csv | csv | Y | csv 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_name | type | description |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
year | integer | Season year. |
xba | numeric | Expected batting average. |
xslg | numeric | Expected slugging. |
xwoba | numeric | Expected wOBA. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_custom()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
type | type | Y | type query parameter. | ||
year | year | Y | year query parameter. | ||
team | team | Y | team 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_name | type | description |
|---|---|---|
total_runs | numeric | Total runs. |
inf_of_runs | character | Inf of runs. |
range_runs | character | Range runs. |
arm_runs | character | Arm runs. |
dp_runs | character | Dp runs. |
catching_runs | numeric | Catching runs. |
framing_runs | numeric | Framing runs. |
throwing_runs | numeric | Throwing runs. |
blocking_runs | numeric | Blocking runs. |
outs_total | integer | Outs total. |
tot_pa | integer | Tot pa. |
outs_2 | integer | Outs 2. |
outs_3 | integer | Outs 3. |
outs_4 | integer | Outs 4. |
outs_5 | integer | Outs 5. |
outs_6 | integer | Outs 6. |
outs_7 | integer | Outs 7. |
outs_8 | integer | Outs 8. |
outs_9 | integer | Outs 9. |
id | integer | MLBAM player id. |
name | character | Player (or entity) name. |
team_id | integer | MLBAM team id. |
n_teams | integer | Number of teams. |
team_name | character | Team name. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_fielding_run_value()
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
type | type | Y | type query parameter. | ||
year | year | Y | year query parameter. | ||
team | team | Y | team 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_name | type | description |
|---|---|---|
grouping_venue_conditions | character | Grouping venue conditions. |
key_is_year_rolling | integer | Key is year rolling. |
key_num_years_rolling | integer | Key num years rolling. |
key_year | integer | Key year. |
key_bat_side | character | Key bat side. |
venue_id | integer | Venue id. |
venue_name | character | Ballpark name. |
main_team_id | integer | Main team id. |
name_display_club | character | Club name. |
n_pa | integer | Number of plate appearances. |
index_runs | integer | Index runs. |
index_hardhit | integer | Index hardhit. |
index_woba | integer | Park factor index for wOBA (100 = neutral). |
index_wobatto | integer | Index wobatto. |
index_wobacon | integer | Index wobacon. |
index_xwobacon | integer | Index xwobacon. |
index_xbacon | integer | Index xbacon. |
index_obp | integer | Index obp. |
index_so | integer | Index so. |
index_bb | integer | Index bb. |
index_bacon | integer | Index bacon. |
index_hits | integer | Index hits. |
index_1b | integer | Index 1b. |
index_2b | integer | Index 2b. |
index_3b | integer | Index 3b. |
index_hr | integer | Index hr. |
year_range | character | Year range. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_park_factors()
Last validated n/a.