MLB — MLB Statcast (Baseball Savant)
sportsdataverse.mlb — 39 endpoints.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
year | integer | Season year. |
pa | integer | Plate appearances. |
bip | integer | Balls in play. |
ba | numeric | Batting average. |
est_ba | numeric | Expected batting average (xBA). |
est_ba_minus_ba_diff | numeric | xBA minus actual BA (over/under-performance). |
slg | numeric | Slugging percentage. |
est_slg | numeric | Expected slugging (xSLG). |
est_slg_minus_slg_diff | numeric | xSLG minus actual SLG. |
woba | numeric | Weighted on-base average. |
est_woba | numeric | Expected wOBA (xwOBA). |
est_woba_minus_woba_diff | numeric | xwOBA minus actual wOBA. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_expected_stats()
Last validated n/a.
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
| 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 |
|---|---|---|
player_name | character | Player name. |
player_id | integer | MLBAM player id. |
year | integer | Season year. |
xwoba | character | Expected wOBA. |
xba | character | Expected batting average. |
xslg | character | Expected slugging. |
xiso | character | Expected isolated power. |
xobp | character | Expected on-base percentage. |
brl | character | Barrels. |
brl_percent | character | Barrel rate (% of batted balls). |
exit_velocity | character | Exit velocity (mph). |
max_ev | integer | Max ev. |
hard_hit_percent | character | Hard-hit rate (95+ mph EV). |
k_percent | character | Strikeout rate. |
bb_percent | character | Walk rate. |
whiff_percent | character | Whiff rate (swings and misses / swings). |
chase_percent | character | Chase rate. |
arm_strength | integer | Arm strength (mph, top throws). |
sprint_speed | integer | Sprint speed (ft/sec, top 50% of competitive runs). |
oaa | integer | Outs Above Average. |
bat_speed | character | Bat speed (mph). |
squared_up_rate | character | Squared up rate. |
swing_length | character | Swing length (ft, head travel). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_percentile_rankings()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
team_id | integer | MLBAM team id. |
team | character | Team abbreviation. |
position | character | Position. |
age | integer | Player age. |
competitive_runs | integer | Competitive runs (qualifying sprint-speed runs). |
bolts | integer | Bolts. |
hp_to_1b | numeric | Home-to-first time (s). |
sprint_speed | numeric | Sprint speed (ft/sec, top 50% of competitive runs). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_sprint_speed()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
name_abbrev | character | Team/name abbreviation. |
team_id | integer | MLBAM team id. |
position_name | character | Position name. |
age | integer | Player age. |
bat_side | character | Batter side (R/L/S). |
seconds_since_hit_000 | numeric | Seconds since hit 000. |
seconds_since_hit_005 | numeric | Seconds since hit 005. |
seconds_since_hit_010 | numeric | Seconds since hit 010. |
seconds_since_hit_015 | numeric | Seconds since hit 015. |
seconds_since_hit_020 | numeric | Seconds since hit 020. |
seconds_since_hit_025 | numeric | Seconds since hit 025. |
seconds_since_hit_030 | numeric | Seconds since hit 030. |
seconds_since_hit_035 | numeric | Seconds since hit 035. |
seconds_since_hit_040 | numeric | Seconds since hit 040. |
seconds_since_hit_045 | numeric | Seconds since hit 045. |
seconds_since_hit_050 | numeric | Seconds since hit 050. |
seconds_since_hit_055 | numeric | Seconds since hit 055. |
seconds_since_hit_060 | numeric | Seconds since hit 060. |
seconds_since_hit_065 | numeric | Seconds since hit 065. |
seconds_since_hit_070 | numeric | Seconds since hit 070. |
seconds_since_hit_075 | numeric | Seconds since hit 075. |
seconds_since_hit_080 | numeric | Seconds since hit 080. |
seconds_since_hit_085 | numeric | Seconds since hit 085. |
seconds_since_hit_090 | numeric | Seconds since hit 090. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_running_splits()
Last validated n/a.
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
| 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 |
|---|---|---|
id | integer | MLBAM player id. |
name | character | Player (or entity) name. |
swings_competitive | integer | Competitive swings. |
percent_swings_competitive | numeric | Share of swings that are competitive. |
contact | integer | Contact. |
avg_bat_speed | numeric | Average bat speed (mph). |
hard_swing_rate | numeric | Hard swing rate. |
squared_up_per_bat_contact | numeric | Squared up per bat contact. |
squared_up_per_swing | numeric | Squared-up rate per swing. |
blast_per_bat_contact | numeric | Blast per bat contact. |
blast_per_swing | numeric | Blasts per swing. |
swing_length | numeric | Swing length (ft, head travel). |
swords | integer | Swords. |
batter_run_value | numeric | Batter run value. |
whiffs | character | Whiffs. |
whiff_per_swing | character | Whiff per swing. |
batted_ball_events | integer | Batted ball events. |
batted_ball_event_per_swing | numeric | Batted ball event per swing. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_bat_tracking()
Last validated n/a.
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
| 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 |
|---|---|---|
id | integer | MLBAM player id. |
name | character | Player (or entity) name. |
side | character | Side. |
avg_bat_speed | numeric | Average bat speed (mph). |
swing_tilt | numeric | Swing tilt (deg). |
attack_angle | numeric | Attack angle (deg, bat path at contact). |
attack_direction | numeric | Attack direction (deg, pull/oppo). |
ideal_attack_angle_rate | numeric | Rate of swings in the ideal attack-angle window. |
avg_intercept_y_vs_plate | numeric | Avg intercept y vs plate. |
avg_intercept_y_vs_batter | numeric | Avg intercept y vs batter. |
avg_batter_y_position | numeric | Avg batter y position. |
avg_batter_x_position | numeric | Avg batter x position. |
competitive_swings | integer | Competitive swings. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_swing_path()
Last validated n/a.
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
| 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 |
|---|---|---|
id | integer | MLBAM player id. |
name | character | Player (or entity) name. |
year | integer | Season year. |
team_name | character | Team name. |
bat_side_formatted | character | Batter side (formatted). |
miss_distance | numeric | Average miss distance (in) on swings. |
flawed_percent | numeric | Flawed rate. |
perfect_percent | numeric | Perfect rate. |
tied_up_percent | numeric | Tied up rate. |
avg_x_tied_up | numeric | Avg x tied up. |
centered_percent | numeric | Centered rate. |
flailed_percent | numeric | Flailed rate. |
avg_x_flail | numeric | Avg x flail. |
early_percent | numeric | Early rate. |
avg_y_early | numeric | Avg y early. |
on_time_percent | numeric | On time rate. |
late_percent | numeric | Late rate. |
avg_y_late | numeric | Avg y late. |
n_swings | integer | Number of swings. |
whiff_rate | numeric | Whiff rate. |
competitive_percent | numeric | Competitive rate. |
over_percent | numeric | Over rate. |
avg_z_over | numeric | Avg z over. |
lined_up_percent | numeric | Lined up rate. |
under_percent | numeric | Under rate. |
avg_z_under | numeric | Avg z under. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_swing_timing()
Last validated n/a.
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
| 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 |
|---|---|---|
year | character | Season year. |
last_name, first_name | character | Last name, first name. |
player_id | character | MLBAM player id. |
team_id | character | MLBAM team id. |
pa | character | Plate appearances. |
pitches | character | Pitches. |
runs_all | character | Runs all. |
runs_heart | character | Runs heart. |
runs_shadow | character | Runs shadow. |
runs_chase | character | Runs chase. |
runs_waste | character | Runs waste. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_swing_take()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
attempts | integer | Opportunities/attempts. |
avg_hit_angle | numeric | Average launch angle (deg). |
anglesweetspotpercent | numeric | Anglesweetspotpercent. |
max_hit_speed | numeric | Max exit velocity (mph). |
avg_hit_speed | numeric | Average exit velocity (mph). |
ev50 | numeric | Ev50. |
fbld | numeric | Fbld. |
gb | numeric | Gb. |
max_distance | integer | Max distance. |
avg_distance | integer | Avg distance. |
avg_hr_distance | integer | Avg hr distance. |
ev95plus | integer | Ev95plus. |
ev95percent | numeric | Ev95percent. |
barrels | integer | Barrels. |
brl_percent | numeric | Barrel rate (% of batted balls). |
brl_pa | numeric | Barrels per plate appearance. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_exit_velocity_barrels()
Last validated n/a.
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
| 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 |
|---|---|---|
id | integer | MLBAM player id. |
name | character | Player (or entity) name. |
year | integer | Season year. |
bbe | integer | Batted-ball events. |
gb_rate | numeric | Gb rate. |
air_rate | numeric | Air rate. |
fb_rate | numeric | Fb rate. |
ld_rate | numeric | Ld rate. |
pu_rate | numeric | Pu rate. |
pull_rate | numeric | Pull rate. |
straight_rate | numeric | Straight rate. |
oppo_rate | numeric | Oppo rate. |
pull_gb_rate | numeric | Pull gb rate. |
straight_gb_rate | numeric | Straight gb rate. |
oppo_gb_rate | numeric | Oppo gb rate. |
pull_air_rate | numeric | Pull air rate. |
straight_air_rate | numeric | Straight air rate. |
oppo_air_rate | numeric | Oppo air rate. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_batted_ball()
Last validated n/a.
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
| 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 |
|---|---|---|
player | character | Player. |
player_id | integer | MLBAM player id. |
team_abbrev | character | Team abbreviation. |
year | integer | Season year. |
type | character | Record/pitch type. |
avg_hr_trot | numeric | Avg hr trot. |
doubters | integer | Doubters. |
mostly_gone | integer | Mostly gone. |
no_doubters | integer | No doubters. |
no_doubter_per | numeric | No doubter per. |
hr_total | integer | Hr total. |
xhr | numeric | Xhr. |
xhr_diff | numeric | Xhr diff. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_home_runs()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
pitcher | integer | MLBAM id of the pitcher. |
ff_batter | character | Ff batter. |
si_batter | character | Si batter. |
fc_batter | character | Fc batter. |
sl_batter | character | Sl batter. |
ch_batter | character | Ch batter. |
cu_batter | character | Cu batter. |
fs_batter | character | Fs batter. |
kn_batter | character | Kn batter. |
st_batter | character | St batter. |
sv_batter | character | Sv batter. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_pitch_arsenals()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
team_name_alt | character | Team name (alternate form). |
pitch_type | character | Pitch type code. |
pitch_name | character | Pitch type name. |
run_value_per_100 | numeric | Run value per 100 pitches. |
run_value | integer | Run value (runs). |
pitches | integer | Pitches. |
pitch_usage | numeric | Pitch usage. |
pa | integer | Plate appearances. |
ba | numeric | Batting average. |
slg | numeric | Slugging percentage. |
woba | numeric | Weighted on-base average. |
whiff_percent | numeric | Whiff rate (swings and misses / swings). |
k_percent | numeric | Strikeout rate. |
put_away | numeric | Put away. |
est_ba | numeric | Expected batting average (xBA). |
est_slg | numeric | Expected slugging (xSLG). |
est_woba | numeric | Expected wOBA (xwOBA). |
hard_hit_percent | numeric | Hard-hit rate (95+ mph EV). |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_pitch_arsenal_stats()
Last validated n/a.
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
| 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 |
|---|---|---|
year | integer | Season year. |
last_name, first_name | character | Last name, first name. |
pitcher_id | integer | MLBAM id of the pitcher. |
team_name | character | Team name. |
team_name_abbrev | character | Team name abbrev. |
pitch_hand | character | Pitcher handedness (R/L). |
avg_speed | integer | Average pitch velocity (mph). |
pitches_thrown | integer | Pitches thrown. |
total_pitches | integer | Total pitches. |
pitches_per_game | numeric | Pitches per game. |
pitch_per | numeric | Pitch per. |
pitch_type | character | Pitch type code. |
pitch_type_name | character | Pitch type name. |
pitcher_break_z | numeric | Pitcher break z. |
league_break_z | numeric | League break z. |
diff_z | numeric | Diff z. |
rise | integer | Rise. |
pitcher_break_z_induced | numeric | Pitcher break z induced. |
pitcher_break_x | numeric | Pitcher break x. |
league_break_x | numeric | League break x. |
diff_x | numeric | Diff x. |
tail | integer | Tail. |
percent_rank_diff_z | numeric | Percent rank diff z. |
percent_rank_diff_x | numeric | Percent rank diff x. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_pitch_movement()
Last validated n/a.
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
| 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 | integer | MLBAM id of the player/team entity. |
entity_name | character | Player (or team) entity name. |
entity_code | character | Entity code. |
team_id | integer | MLBAM team id. |
total_pitches | integer | Total pitches. |
total_pitches_empty | integer | Total pitches empty. |
median_seconds_empty | numeric | Median tempo (s) with bases empty. |
total_pitches_onbase | integer | Total pitches onbase. |
freq_hot | numeric | Freq hot. |
freq_warm | numeric | Freq warm. |
freq_cold | numeric | Freq cold. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_pitch_tempo()
Last validated n/a.
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
| 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_name | character | Player (or team) entity name. |
entity_id | integer | MLBAM id of the player/team entity. |
pitch_hand | character | Pitcher handedness (R/L). |
active_spin_fourseam | character | Active spin fourseam. |
active_spin_sinker | numeric | Active spin sinker. |
active_spin_cutter | numeric | Active spin cutter. |
active_spin_changeup | numeric | Active spin changeup. |
active_spin_splitter | character | Active spin splitter. |
active_spin_curve | character | Active spin curve. |
active_spin_slider | numeric | Active spin slider. |
active_spin_sweeper | numeric | Active spin sweeper. |
active_spin_slurve | character | Active spin slurve. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_active_spin()
Last validated n/a.
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
| 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 |
|---|---|---|
year | integer | Season year. |
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
pitch_hand | character | Pitcher handedness (R/L). |
api_pitch_type | character | Pitch type (API code). |
n_pitches | integer | Number of pitches. |
release_speed | numeric | Release speed. |
spin_rate | integer | Spin rate (rpm). |
movement_inches | numeric | Movement inches. |
alan_active_spin_pct | numeric | Alan active spin rate. |
active_spin | numeric | Active (useful) spin (%). |
hawkeye_measured | numeric | Hawkeye measured. |
movement_inferred | numeric | Movement inferred. |
api_pitch_name | character | Api pitch name. |
active_spin_formatted | integer | Active spin (formatted, %). |
hawkeye_measured_clock_minutes | integer | Hawkeye measured clock minutes. |
movement_inferred_clock_minutes | integer | Movement inferred clock minutes. |
diff_measured_inferred | numeric | Diff measured inferred. |
diff2 | numeric | Diff2. |
diff_measured_inferred_minutes | integer | Diff measured inferred minutes. |
hawkeye_measured_clock_hh | integer | Hawkeye measured clock hh. |
hawkeye_measured_clock_mm | integer | Hawkeye measured clock mm. |
movement_inferred_clock_hh | integer | Movement inferred clock hh. |
movement_inferred_clock_mm | integer | Movement inferred clock mm. |
diff_clock_hh | integer | Diff clock hh. |
diff_clock_mm | integer | Diff clock mm. |
hawkeye_measured_clock_label | character | Hawkeye measured clock label. |
movement_inferred_clock_label | character | Movement inferred clock label. |
diff_clock_label | character | Diff clock label. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_spin_direction()
Last validated n/a.
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
| 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 |
|---|---|---|
pitcher | integer | MLBAM id of the pitcher. |
pitcher_name | character | Pitcher name. |
pitch_hand | character | Pitcher handedness (R/L). |
n_pitches | integer | Number of pitches. |
team_id | integer | MLBAM team id. |
ball_angle | numeric | Arm slot angle (deg). |
relative_release_ball_x | numeric | Relative release ball x. |
release_ball_z | numeric | Release ball z. |
relative_shoulder_x | numeric | Relative shoulder x. |
shoulder_z | numeric | Shoulder z. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_arm_angles()
Last validated n/a.
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
| 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 |
|---|---|---|
player_id | integer | MLBAM player id. |
player_name | character | Player name. |
team_name | character | Team name. |
start_year | integer | First season in the range. |
end_year | integer | Last season in the range. |
key_target_base | character | Key target base. |
runs_prevented_on_running_attr | numeric | Runs prevented on running attr. |
n_pitcher_cs_aa | numeric | Number of pitcher cs aa. |
n_init | integer | Number of init. |
rate_sbx | numeric | Rate sbx. |
n_sb | integer | Stolen bases allowed (count). |
n_cs | integer | Caught stealing (count). |
n_pk | integer | Number of pk. |
n_bk | integer | Number of bk. |
n_fb | integer | Number of fb. |
n_plus | integer | Number of plus. |
n_minus | integer | Number of minus. |
net_attr_plus | numeric | Net attr plus. |
net_attr_minus | numeric | Net attr minus. |
r_primary_lead | numeric | Average primary lead distance (ft). |
r_secondary_lead | numeric | Average secondary lead (ft). |
r_sec_minus_prim_lead | numeric | R sec minus prim lead. |
r_primary_lead_sbx | numeric | R primary lead sbx. |
r_secondary_lead_sbx | numeric | R secondary lead sbx. |
r_sec_minus_prim_lead_sbx | numeric | R sec minus prim lead sbx. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_pitcher_running_game()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | character | MLBAM player id. |
display_team_name | character | Team display name. |
year | character | Season year. |
primary_pos_formatted | character | Primary position (formatted). |
fielding_runs_prevented | character | Fielding Run Value (runs). |
outs_above_average | character | Outs Above Average. |
outs_above_average_infront | character | Outs above average infront. |
outs_above_average_lateral_toward3bline | character | Outs above average lateral toward3bline. |
outs_above_average_lateral_toward1bline | character | Outs above average lateral toward1bline. |
outs_above_average_behind | character | Outs above average behind. |
outs_above_average_rhh | character | Outs above average rhh. |
outs_above_average_lhh | character | Outs above average lhh. |
actual_success_rate_formatted | character | Actual success rate formatted. |
adj_estimated_success_rate_formatted | character | Adj estimated success rate formatted. |
diff_success_rate_formatted | character | Diff success rate formatted. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_outs_above_average()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | integer | MLBAM player id. |
attempts | integer | Opportunities/attempts. |
n_outs_above_average | integer | Outs Above Average (count). |
n_oaa_slice_back_left | integer | Number of oaa slice back left. |
n_oaa_slice_back | integer | Number of oaa slice back. |
n_oaa_slice_back_right | integer | Number of oaa slice back right. |
n_oaa_slice_back_all | integer | Number of oaa slice back all. |
n_oaa_slice_in_left | integer | Number of oaa slice in left. |
n_oaa_slice_in | integer | Number of oaa slice in. |
n_oaa_slice_in_right | integer | Number of oaa slice in right. |
n_oaa_slice_in_all | integer | Number of oaa slice in all. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_outfield_directional_oaa()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
resp_fielder_id | integer | MLBAM id of the responsible fielder. |
year | integer | Season year. |
outs_above_average | integer | Outs Above Average. |
outs_per_play | numeric | Outs per play. |
rel_league_burst_distance | integer | Rel league burst distance. |
rel_league_reaction_distance | numeric | Rel league reaction distance. |
rel_league_routing_distance | numeric | Rel league routing distance. |
rel_league_bootup_distance | numeric | Rel league bootup distance. |
f_bootup_distance | numeric | F bootup distance. |
n | integer | Sample count (pitches/events). |
n_outs | integer | Number of outs. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_outfield_jump()
Last validated n/a.
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
| 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 |
|---|---|---|
last_name, first_name | character | Last name, first name. |
player_id | character | MLBAM player id. |
oaa | character | Outs Above Average. |
n_fieldout_5stars | character | 5-star (hardest) plays made. |
n_opp_5stars | character | 5-star play opportunities. |
n_5star_percent | character | Number of 5star rate. |
n_fieldout_4stars | character | Number of fieldout 4stars. |
n_opp_4stars | character | Number of opp 4stars. |
n_4star_percent | character | Number of 4star rate. |
n_fieldout_3stars | character | Number of fieldout 3stars. |
n_opp_3stars | character | Number of opp 3stars. |
n_3star_percent | character | Number of 3star rate. |
n_fieldout_2stars | character | Number of fieldout 2stars. |
n_opp_2stars | character | Number of opp 2stars. |
n_2star_percent | character | Number of 2star rate. |
n_fieldout_1stars | character | Number of fieldout 1stars. |
n_opp_1stars | character | Number of opp 1stars. |
n_1star_percent | character | Number of 1star rate. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_catch_probability()
Last validated n/a.
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
| 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 |
|---|---|---|
fielder_name | character | Fielder name. |
player_id | integer | MLBAM player id. |
team_name | character | Team name. |
primary_position | integer | Primary fielding position. |
primary_position_name | character | Primary position name. |
total_throws | integer | Total throws. |
total_throws_1b | integer | Total throws 1b. |
total_throws_2b | integer | Total throws 2b. |
total_throws_3b | integer | Total throws 3b. |
total_throws_ss | integer | Total throws ss. |
total_throws_lf | integer | Total throws lf. |
total_throws_cf | integer | Total throws cf. |
total_throws_rf | integer | Total throws rf. |
total_throws_inf | integer | Total throws inf. |
total_throws_of | integer | Total throws of. |
max_arm_strength | numeric | Max arm strength (mph). |
arm_1b | numeric | Arm 1b. |
arm_2b | character | Arm 2b. |
arm_3b | character | Arm 3b. |
arm_ss | character | Arm ss. |
arm_lf | character | Arm lf. |
arm_cf | character | Arm cf. |
arm_rf | character | Arm rf. |
arm_inf | character | Arm inf. |
arm_of | character | Arm of. |
arm_overall | numeric | Arm overall. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_arm_strength()
Last validated n/a.
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
| 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_name | character | Player (or team) entity name. |
entity_id | integer | MLBAM id of the player/team entity. |
team_id | integer | MLBAM team id. |
age | integer | Player age. |
maxeff_arm_2b_3b_sba | numeric | Max-effort arm velo to 2B/3B (mph). |
exchange_2b_3b_sba | numeric | Transfer/exchange time (s). |
pop_2b_sba_count | integer | Pop-time sample (throws to 2B). |
pop_2b_sba | numeric | Pop time to 2B on stolen-base attempts (s). |
pop_2b_cs | numeric | Pop 2b cs. |
pop_2b_sb | numeric | Pop 2b sb. |
pop_3b_sba_count | integer | Pop 3b sba count. |
pop_3b_sba | numeric | Pop 3b sba. |
pop_3b_cs | numeric | Pop 3b cs. |
pop_3b_sb | numeric | Pop 3b sb. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_poptime()
Last validated n/a.
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
| 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 |
|---|---|---|
id | integer | MLBAM player id. |
name | character | Player (or entity) name. |
pitches | integer | Pitches. |
rv_tot | numeric | Total framing run value. |
pct_tot | numeric | Total called-strike rate. |
rv_11 | integer | Rv 11. |
pct_11 | numeric | Pct 11. |
rv_12 | integer | Rv 12. |
pct_12 | numeric | Pct 12. |
rv_13 | integer | Rv 13. |
pct_13 | integer | Pct 13. |
rv_14 | integer | Rv 14. |
pct_14 | numeric | Pct 14. |
rv_16 | integer | Rv 16. |
pct_16 | numeric | Pct 16. |
rv_17 | integer | Rv 17. |
pct_17 | numeric | Pct 17. |
rv_18 | integer | Rv 18. |
pct_18 | numeric | Pct 18. |
rv_19 | integer | Rv 19. |
pct_19 | numeric | Pct 19. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_catcher_framing()
Last validated n/a.
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
| 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 |
|---|---|---|
player_id | integer | MLBAM player id. |
player_name | character | Player name. |
team_name | character | Team name. |
start_year | integer | First season in the range. |
end_year | character | Last season in the range. |
pitches | integer | Pitches. |
catcher_blocking_runs | integer | Catcher blocking runs. |
blocks_above_average | integer | Blocks above average. |
n_pbwp | integer | Number of pbwp. |
x_pbwp | numeric | X pbwp. |
blocks_above_average_per_game | numeric | Blocks above average per game. |
freq_pbwp_easy | numeric | Freq pbwp easy. |
freq_pbwp_medium | numeric | Freq pbwp medium. |
freq_pbwp_tough | numeric | Freq pbwp tough. |
diff_pbwp_easy | numeric | Diff pbwp easy. |
diff_pbwp_medium | numeric | Diff pbwp medium. |
diff_pbwp_tough | numeric | Diff pbwp tough. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_catcher_blocking()
Last validated n/a.
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
| 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 |
|---|---|---|
player_id | integer | MLBAM player id. |
player_name | character | Player name. |
team_name | character | Team name. |
start_year | integer | First season in the range. |
end_year | integer | Last season in the range. |
sb_attempts | integer | Sb attempts. |
catcher_stealing_runs | numeric | Catcher stealing runs. |
caught_stealing_above_average | numeric | Caught-stealing above average. |
n_cs | integer | Caught stealing (count). |
rate_cs | numeric | Rate cs. |
est_cs_pct | numeric | Expected caught stealing rate. |
cs_aa_per_throw | numeric | Cs aa per throw. |
seasonal_runner_speed | numeric | Seasonal runner speed. |
runner_distance_from_second | numeric | Runner distance from second. |
pop_time | numeric | Pop time. |
exchange_time | numeric | Exchange time. |
arm_strength | numeric | Arm strength (mph, top throws). |
n_xcs_with_flight_over_xcs | numeric | Number of xcs with flight over xcs. |
n_xcs_with_exchange_over_xcs | numeric | Number of xcs with exchange over xcs. |
n_xcs_with_accuracy_over_xcs | numeric | Number of xcs with accuracy over xcs. |
n_xcs_with_ground_other_over_xcs | numeric | Number of xcs with ground other over xcs. |
n_xcs_with_onfly_other_over_xcs | numeric | Number of xcs with onfly other over xcs. |
n_xcs_with_untracked_other_over_xcs | integer | Number of xcs with untracked other over xcs. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_catcher_throwing()
Last validated n/a.
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
| 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 |
|---|---|---|
id | integer | MLBAM player id. |
name | character | Player (or entity) name. |
year | integer | Season year. |
pitches | integer | Pitches. |
knee_down_pct | numeric | Share of pitches received in a knee-down stance. |
l_down_r_up_pct | numeric | L down r up rate. |
r_down_l_up_pct | numeric | R down l up rate. |
both_down_pct | numeric | Both down rate. |
both_up_pct | numeric | Both up rate. |
extended_leg_pct | numeric | Extended leg rate. |
inside_down_pct | numeric | Inside down rate. |
outside_down_pct | numeric | Outside down rate. |
one_knee_framing_rv | numeric | One knee framing rv. |
other_framing_rv | integer | Other framing rv. |
one_knee_calledstr_pct | numeric | One knee calledstr rate. |
other_calledstr_pct | character | Other calledstr rate. |
one_knee_blocking_rv | numeric | One knee blocking rv. |
other_blocking_rv | integer | Other blocking rv. |
one_knee_pbwp100 | numeric | One knee pbwp100. |
other_pbwp100 | character | Other pbwp100. |
one_knee_throwing_rv | integer | One knee throwing rv. |
other_throwing_rv | integer | Other throwing rv. |
one_knee_csaa100 | integer | One knee csaa100. |
other_csaa100 | character | Other csaa100. |
catching_rv | numeric | Catching rv. |
one_knee_pitching_rv | numeric | One knee pitching rv. |
other_pitching_rv | numeric | Other pitching rv. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_catcher_stance()
Last validated n/a.
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
| 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 |
|---|---|---|
player_id | integer | MLBAM player id. |
player_name | character | Player name. |
team_name | character | Team name. |
start_year | integer | First season in the range. |
end_year | integer | Last season in the range. |
key_target_base | character | Key target base. |
runs_stolen_on_running_act | numeric | Runs stolen on running act. |
n_init | integer | Number of init. |
rate_sbx | integer | Rate sbx. |
n_sb | integer | Stolen bases allowed (count). |
n_cs | integer | Caught stealing (count). |
n_pk | integer | Number of pk. |
n_bk | integer | Number of bk. |
n_fb | integer | Number of fb. |
n_plus | integer | Number of plus. |
n_minus | integer | Number of minus. |
net_act_plus | numeric | Net act plus. |
net_act_minus | numeric | Net act minus. |
r_primary_lead | numeric | Average primary lead distance (ft). |
r_secondary_lead | numeric | Average secondary lead (ft). |
r_sec_minus_prim_lead | numeric | R sec minus prim lead. |
r_primary_lead_sbx | character | R primary lead sbx. |
r_secondary_lead_sbx | character | R secondary lead sbx. |
r_sec_minus_prim_lead_sbx | character | R sec minus prim lead sbx. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_basestealing_run_value()
Last validated n/a.
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
| 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 |
|---|---|---|
player_id | integer | MLBAM player id. |
entity_name | character | Player (or team) entity name. |
team_name | character | Team name. |
start_year | integer | First season in the range. |
end_year | integer | Last season in the range. |
runner_runs_tot | numeric | Runner runs tot. |
runner_runs_xb | numeric | Runner runs xb. |
runner_runs_sbx | numeric | Runner runs sbx. |
n_runner_moved | integer | Number of runner moved. |
runner_runs_xb_swipe | numeric | Runner runs xb swipe. |
runner_runs_xb_snipe | integer | Runner runs xb snipe. |
runner_runs_xb_freeze | numeric | Runner runs xb freeze. |
n_runner_moved_xb | integer | Number of runner moved xb. |
runner_runs_sb2 | numeric | Runner runs sb2. |
runner_runs_sb3 | numeric | Runner runs sb3. |
simple_stolen_on_running_act_sb2 | numeric | Simple stolen on running act sb2. |
simple_stolen_on_running_act_sb3 | numeric | Simple stolen on running act sb3. |
n_runner_moved_sbx | integer | Number of runner moved sbx. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_baserunning_run_value()
Last validated n/a.
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
| 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_name | character | Player (or team) entity name. |
entity_id | integer | MLBAM id of the player/team entity. |
team_name | character | Team name. |
year | integer | Season year. |
runner_runs | numeric | Baserunning run value as a runner. |
fielder_runs | numeric | Run value from the defense's perspective. |
runner_runs_advances | numeric | Runner runs advances. |
runner_runs_thrown_out | integer | Runner runs thrown out. |
runner_runs_hold | numeric | Runner runs hold. |
fielder_runs_advances | numeric | Fielder runs advances. |
fielder_runs_thrown_out | integer | Fielder runs thrown out. |
fielder_runs_hold | numeric | Fielder runs hold. |
n_opp_xb | integer | Number of opp xb. |
n_att_xb | integer | Number of att xb. |
rate_att_xb | numeric | Rate att xb. |
est_rate_att_generic_runner | numeric | Expected rate att generic runner. |
est_rate_att_generic_fielder | numeric | Expected rate att generic fielder. |
n_out | integer | Number of out. |
n_safe | integer | Number of safe. |
rate_safe | numeric | Rate safe. |
rate_safe_per_attempt | integer | Rate safe per attempt. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_leaderboard_baserunning()
Last validated n/a.
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
| 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
| 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
| 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.
mlb_statcast_gamefeed
GET /gf — Savant per-game JSON feed (pitch-by-pitch tracking).
Endpoint URL: GET https://baseballsavant.mlb.com/gf
Valid URL: https://baseballsavant.mlb.com/gf
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
game_pk | game_pk | Y | game_pk query parameter. | ||
at_bat_number | at_bat_number | Y | at_bat_number 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 |
|---|---|---|
type | character | Record/pitch type. |
year | character | Season year. |
sport_id | character | Sport id. |
play_id | character | Statcast play UUID. |
inning | character | Inning. |
half_inning | character | Half inning. |
ab_number | character | Ab number. |
cap_index | character | Cap index. |
outs | character | Outs. |
batter | character | MLBAM id of the batter. |
stand | character | Batter stance side (R/L). |
batter_name | character | Batter name. |
pitcher | character | MLBAM id of the pitcher. |
p_throws | character | Pitcher throwing hand (R/L). |
pitcher_name | character | Pitcher name. |
catcher | character | Catcher. |
catcher_name | character | Catcher name. |
team_batting | character | Team batting. |
team_fielding | character | Team fielding. |
team_batting_id | character | Team batting id. |
team_fielding_id | character | Team fielding id. |
result | character | Result. |
des | character | Des. |
events | character | Events. |
strikes | character | Strikes. |
balls | character | Balls. |
pre_strikes | character | Pre strikes. |
pre_balls | character | Pre balls. |
call | character | Call. |
call_name | character | Call name. |
pitch_type | character | Pitch type code. |
pitch_name | character | Pitch type name. |
description | character | Description. |
result_code | character | Result code. |
pitch_call | character | Pitch call. |
is_strike_swinging | character | Is strike swinging. |
balls_and_strikes | character | Balls and strikes. |
start_speed | character | Start speed. |
end_speed | character | End speed. |
sz_top | character | Sz top. |
sz_bot | character | Sz bot. |
extension | character | Release extension (ft). |
plate_time | character | Plate time. |
zone | character | Zone. |
spin_rate | character | Spin rate (rpm). |
break_x | character | Break x. |
induced_break_z | character | Induced break z. |
break_z | character | Break z. |
px | character | Px. |
pz | character | Pz. |
pfx_x | character | Horizontal movement (in, pitcher perspective). |
pfx_z | character | Induced vertical movement (in). |
is_bip_out | character | Is bip out. |
pitch_number | character | Pitch number. |
plate_x | character | Plate x. |
plate_z | character | Plate z. |
hit_speed | character | Hit speed. |
hit_distance | character | Hit distance. |
xba | character | Expected batting average. |
hit_angle | character | Hit angle. |
is_barrel | character | Is barrel. |
hc_x | character | Hc x. |
hc_y | character | Hc y. |
launch_speed | character | Exit velocity of the batted ball (mph). |
launch_angle | character | Launch angle (deg). |
game_total_pitches | character | Game total pitches. |
game_pk | character | MLBAM game id. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_gamefeed()
Last validated n/a.
mlb_statcast_schedule
GET /schedule — Savant schedule feed (one row per game).
Endpoint URL: GET https://baseballsavant.mlb.com/schedule
Valid URL: https://baseballsavant.mlb.com/schedule
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
date | date | Y | date 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 |
|---|---|---|
game_pk | integer | MLBAM game id. |
game_guid | character | Game GUID. |
link | character | Stats API resource link. |
game_type | character | Game type code (R/F/D/L/W/S/E/A). |
season | character | Season year. |
game_date | character | Game date/time (ISO 8601, UTC offset). |
official_date | character | Official game date (YYYY-MM-DD). |
game_number | integer | Game number (1, or 2 for the nightcap of a doubleheader). |
public_facing | logical | Public facing. |
double_header | character | Doubleheader flag (Y/N/S). |
gameday_type | character | Gameday type. |
tiebreaker | character | Tiebreaker. |
calendar_event_id | character | Calendar event id. |
season_display | character | Season display. |
day_night | character | Day or night game. |
scheduled_innings | integer | Scheduled innings (usually 9). |
reverse_home_away_status | logical | Reverse home away status. |
inning_break_length | integer | Inning break length. |
games_in_series | integer | Total games in the series. |
series_game_number | integer | Game number within the series. |
series_description | character | Series description. |
record_source | character | Record source. |
if_necessary | character | If necessary. |
if_necessary_description | character | If necessary description. |
status_abstract_game_state | character | Status abstract game state. |
status_coded_game_state | character | Status coded game state. |
status_detailed_state | character | Status detailed state. |
status_status_code | character | Status status code. |
status_start_time_tbd | logical | Status start time tbd. |
status_abstract_game_code | character | Status abstract game code. |
teams_away_team_spring_league_id | integer | Away team team spring league id. |
teams_away_team_spring_league_name | character | Away team team spring league name. |
teams_away_team_spring_league_link | character | Away team team spring league link. |
teams_away_team_spring_league_abbreviation | character | Away team team spring league abbreviation. |
teams_away_team_all_star_status | character | Away team team all star status. |
teams_away_team_id | integer | Away team team id. |
teams_away_team_name | character | Away team team name. |
teams_away_team_link | character | Away team team link. |
teams_away_team_season | integer | Away team team season. |
teams_away_team_venue_id | integer | Away team team venue id. |
teams_away_team_venue_name | character | Away team team venue name. |
teams_away_team_venue_link | character | Away team team venue link. |
teams_away_team_spring_venue_id | integer | Away team team spring venue id. |
teams_away_team_spring_venue_link | character | Away team team spring venue link. |
teams_away_team_team_code | character | Away team team team code. |
teams_away_team_file_code | character | Away team team file code. |
teams_away_team_abbreviation | character | Away team team abbreviation. |
teams_away_team_team_name | character | Away team team team name. |
teams_away_team_location_name | character | Away team team location name. |
teams_away_team_first_year_of_play | character | Away team team first year of play. |
teams_away_team_league_id | integer | Away team team league id. |
teams_away_team_league_name | character | Away team team league name. |
teams_away_team_league_link | character | Away team team league link. |
teams_away_team_division_id | integer | Away team team division id. |
teams_away_team_division_name | character | Away team team division name. |
teams_away_team_division_link | character | Away team team division link. |
teams_away_team_sport_id | integer | Away team team sport id. |
teams_away_team_sport_link | character | Away team team sport link. |
teams_away_team_sport_name | character | Away team team sport name. |
teams_away_team_short_name | character | Away team team short name. |
teams_away_team_franchise_name | character | Away team team franchise name. |
teams_away_team_club_name | character | Away team team club name. |
teams_away_team_active | logical | Away team team active. |
teams_away_league_record_wins | integer | Away team league record wins. |
teams_away_league_record_losses | integer | Away team league record losses. |
teams_away_league_record_ties | integer | Away team league record ties. |
teams_away_league_record_pct | character | Away team league record rate. |
teams_away_probable_pitcher_id | integer | Away team probable pitcher id. |
teams_away_probable_pitcher_full_name | character | Away team probable pitcher full name. |
teams_away_probable_pitcher_link | character | Away team probable pitcher link. |
teams_away_probable_pitcher_first_name | character | Away team probable pitcher first name. |
teams_away_probable_pitcher_last_name | character | Away team probable pitcher last name. |
teams_away_probable_pitcher_primary_number | character | Away team probable pitcher primary number. |
teams_away_probable_pitcher_birth_date | character | Away team probable pitcher birth date. |
teams_away_probable_pitcher_current_age | integer | Away team probable pitcher current age. |
teams_away_probable_pitcher_birth_city | character | Away team probable pitcher birth city. |
teams_away_probable_pitcher_birth_state_province | character | Away team probable pitcher birth state province. |
teams_away_probable_pitcher_birth_country | character | Away team probable pitcher birth country. |
teams_away_probable_pitcher_height | character | Away team probable pitcher height. |
teams_away_probable_pitcher_weight | integer | Away team probable pitcher weight. |
teams_away_probable_pitcher_active | logical | Away team probable pitcher active. |
teams_away_probable_pitcher_primary_position_code | character | Away team probable pitcher primary position code. |
teams_away_probable_pitcher_primary_position_name | character | Away team probable pitcher primary position name. |
teams_away_probable_pitcher_primary_position_type | character | Away team probable pitcher primary position type. |
teams_away_probable_pitcher_primary_position_abbreviation | character | Away team probable pitcher primary position abbreviation. |
teams_away_probable_pitcher_use_name | character | Away team probable pitcher use name. |
teams_away_probable_pitcher_use_last_name | character | Away team probable pitcher use last name. |
teams_away_probable_pitcher_middle_name | character | Away team probable pitcher middle name. |
teams_away_probable_pitcher_boxscore_name | character | Away team probable pitcher boxscore name. |
teams_away_probable_pitcher_gender | character | Away team probable pitcher gender. |
teams_away_probable_pitcher_is_player | logical | Away team probable pitcher is player. |
teams_away_probable_pitcher_is_verified | logical | Away team probable pitcher is verified. |
teams_away_probable_pitcher_draft_year | integer | Away team probable pitcher draft year. |
teams_away_probable_pitcher_mlb_debut_date | character | Away team probable pitcher mlb debut date. |
teams_away_probable_pitcher_bat_side_code | character | Away team probable pitcher bat side code. |
teams_away_probable_pitcher_bat_side_description | character | Away team probable pitcher bat side description. |
teams_away_probable_pitcher_pitch_hand_code | character | Away team probable pitcher pitch hand code. |
teams_away_probable_pitcher_pitch_hand_description | character | Away team probable pitcher pitch hand description. |
teams_away_probable_pitcher_name_first_last | character | Away team probable pitcher name first last. |
teams_away_probable_pitcher_name_slug | character | Away team probable pitcher name slug. |
teams_away_probable_pitcher_first_last_name | character | Away team probable pitcher first last name. |
teams_away_probable_pitcher_last_first_name | character | Away team probable pitcher last first name. |
teams_away_probable_pitcher_last_init_name | character | Away team probable pitcher last init name. |
teams_away_probable_pitcher_init_last_name | character | Away team probable pitcher init last name. |
teams_away_probable_pitcher_full_fml_name | character | Away team probable pitcher full fml name. |
teams_away_probable_pitcher_full_lfm_name | character | Away team probable pitcher full lfm name. |
teams_away_probable_pitcher_strike_zone_top | numeric | Away team probable pitcher strike zone top. |
teams_away_probable_pitcher_strike_zone_bottom | numeric | Away team probable pitcher strike zone bottom. |
teams_away_split_squad | logical | Away team split squad. |
teams_away_series_number | integer | Away team series number. |
teams_away_spring_league_id | integer | Away team spring league id. |
teams_away_spring_league_name | character | Away team spring league name. |
teams_away_spring_league_link | character | Away team spring league link. |
teams_away_spring_league_abbreviation | character | Away team spring league abbreviation. |
teams_home_team_spring_league_id | integer | Home team team spring league id. |
teams_home_team_spring_league_name | character | Home team team spring league name. |
teams_home_team_spring_league_link | character | Home team team spring league link. |
teams_home_team_spring_league_abbreviation | character | Home team team spring league abbreviation. |
teams_home_team_all_star_status | character | Home team team all star status. |
teams_home_team_id | integer | Home team team id. |
teams_home_team_name | character | Home team team name. |
teams_home_team_link | character | Home team team link. |
teams_home_team_season | integer | Home team team season. |
teams_home_team_venue_id | integer | Home team team venue id. |
teams_home_team_venue_name | character | Home team team venue name. |
teams_home_team_venue_link | character | Home team team venue link. |
teams_home_team_spring_venue_id | integer | Home team team spring venue id. |
teams_home_team_spring_venue_link | character | Home team team spring venue link. |
teams_home_team_team_code | character | Home team team team code. |
teams_home_team_file_code | character | Home team team file code. |
teams_home_team_abbreviation | character | Home team team abbreviation. |
teams_home_team_team_name | character | Home team team team name. |
teams_home_team_location_name | character | Home team team location name. |
teams_home_team_first_year_of_play | character | Home team team first year of play. |
teams_home_team_league_id | integer | Home team team league id. |
teams_home_team_league_name | character | Home team team league name. |
teams_home_team_league_link | character | Home team team league link. |
teams_home_team_division_id | integer | Home team team division id. |
teams_home_team_division_name | character | Home team team division name. |
teams_home_team_division_link | character | Home team team division link. |
teams_home_team_sport_id | integer | Home team team sport id. |
teams_home_team_sport_link | character | Home team team sport link. |
teams_home_team_sport_name | character | Home team team sport name. |
teams_home_team_short_name | character | Home team team short name. |
teams_home_team_franchise_name | character | Home team team franchise name. |
teams_home_team_club_name | character | Home team team club name. |
teams_home_team_active | logical | Home team team active. |
teams_home_league_record_wins | integer | Home team league record wins. |
teams_home_league_record_losses | integer | Home team league record losses. |
teams_home_league_record_ties | integer | Home team league record ties. |
teams_home_league_record_pct | character | Home team league record rate. |
teams_home_probable_pitcher_id | integer | Home team probable pitcher id. |
teams_home_probable_pitcher_full_name | character | Home team probable pitcher full name. |
teams_home_probable_pitcher_link | character | Home team probable pitcher link. |
teams_home_probable_pitcher_first_name | character | Home team probable pitcher first name. |
teams_home_probable_pitcher_last_name | character | Home team probable pitcher last name. |
teams_home_probable_pitcher_primary_number | character | Home team probable pitcher primary number. |
teams_home_probable_pitcher_birth_date | character | Home team probable pitcher birth date. |
teams_home_probable_pitcher_current_age | integer | Home team probable pitcher current age. |
teams_home_probable_pitcher_birth_city | character | Home team probable pitcher birth city. |
teams_home_probable_pitcher_birth_state_province | character | Home team probable pitcher birth state province. |
teams_home_probable_pitcher_birth_country | character | Home team probable pitcher birth country. |
teams_home_probable_pitcher_height | character | Home team probable pitcher height. |
teams_home_probable_pitcher_weight | integer | Home team probable pitcher weight. |
teams_home_probable_pitcher_active | logical | Home team probable pitcher active. |
teams_home_probable_pitcher_primary_position_code | character | Home team probable pitcher primary position code. |
teams_home_probable_pitcher_primary_position_name | character | Home team probable pitcher primary position name. |
teams_home_probable_pitcher_primary_position_type | character | Home team probable pitcher primary position type. |
teams_home_probable_pitcher_primary_position_abbreviation | character | Home team probable pitcher primary position abbreviation. |
teams_home_probable_pitcher_use_name | character | Home team probable pitcher use name. |
teams_home_probable_pitcher_use_last_name | character | Home team probable pitcher use last name. |
teams_home_probable_pitcher_middle_name | character | Home team probable pitcher middle name. |
teams_home_probable_pitcher_boxscore_name | character | Home team probable pitcher boxscore name. |
teams_home_probable_pitcher_nick_name | character | Home team probable pitcher nick name. |
teams_home_probable_pitcher_gender | character | Home team probable pitcher gender. |
teams_home_probable_pitcher_is_player | logical | Home team probable pitcher is player. |
teams_home_probable_pitcher_is_verified | logical | Home team probable pitcher is verified. |
teams_home_probable_pitcher_draft_year | integer | Home team probable pitcher draft year. |
teams_home_probable_pitcher_mlb_debut_date | character | Home team probable pitcher mlb debut date. |
teams_home_probable_pitcher_bat_side_code | character | Home team probable pitcher bat side code. |
teams_home_probable_pitcher_bat_side_description | character | Home team probable pitcher bat side description. |
teams_home_probable_pitcher_pitch_hand_code | character | Home team probable pitcher pitch hand code. |
teams_home_probable_pitcher_pitch_hand_description | character | Home team probable pitcher pitch hand description. |
teams_home_probable_pitcher_name_first_last | character | Home team probable pitcher name first last. |
teams_home_probable_pitcher_name_slug | character | Home team probable pitcher name slug. |
teams_home_probable_pitcher_first_last_name | character | Home team probable pitcher first last name. |
teams_home_probable_pitcher_last_first_name | character | Home team probable pitcher last first name. |
teams_home_probable_pitcher_last_init_name | character | Home team probable pitcher last init name. |
teams_home_probable_pitcher_init_last_name | character | Home team probable pitcher init last name. |
teams_home_probable_pitcher_full_fml_name | character | Home team probable pitcher full fml name. |
teams_home_probable_pitcher_full_lfm_name | character | Home team probable pitcher full lfm name. |
teams_home_probable_pitcher_strike_zone_top | numeric | Home team probable pitcher strike zone top. |
teams_home_probable_pitcher_strike_zone_bottom | numeric | Home team probable pitcher strike zone bottom. |
teams_home_split_squad | logical | Home team split squad. |
teams_home_series_number | integer | Home team series number. |
teams_home_spring_league_id | integer | Home team spring league id. |
teams_home_spring_league_name | character | Home team spring league name. |
teams_home_spring_league_link | character | Home team spring league link. |
teams_home_spring_league_abbreviation | character | Home team spring league abbreviation. |
linescore_scheduled_innings | integer | Linescore scheduled innings. |
linescore_innings | character | Linescore innings. |
linescore_defense_team_id | integer | Linescore defense team id. |
linescore_defense_team_name | character | Linescore defense team name. |
linescore_defense_team_link | character | Linescore defense team link. |
linescore_offense_team_id | integer | Linescore offense team id. |
linescore_offense_team_name | character | Linescore offense team name. |
linescore_offense_team_link | character | Linescore offense team link. |
venue_id | integer | MLBAM venue id. |
venue_name | character | Ballpark name. |
venue_link | character | Venue link. |
content_link | character | Content link. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
mlb_statcast_schedule()
Last validated n/a.