mlb_statcast_swing_timing
Retrieve Baseball Savant swing timing and miss distance rows for batters, pitchers, teams, or leagues, filtered by season, count, pitch type, zone, and timing flags.
Instructions
Get Baseball Savant Swing Timing and Miss Distance rows. Returns batter, batting-team, pitcher, pitching-team, or league rows with the page's season, game type, pitch-group, split, team, date, swing, contact, zone, pitch hand/type, count, timing-axis, and timing-flag filters. Sorting is local. Use mlb_discovery for exact values.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Local sort field | |
| type | No | Row type | |
| flags | No | Positive timing flags | |
| limit | No | Rows per page (1-500) | |
| teams | No | One or more MLB team ids | |
| counts | No | One or more ball-strike counts | |
| offset | No | Zero-based row offset | |
| splits | No | One or more split dimensions | |
| seasons | No | One or more seasons | |
| bat_side | No | Batter side | |
| date_end | No | Optional range end in YYYY-MM-DD | |
| sort_dir | No | Sort direction | |
| min_split | No | Minimum swings per split group | |
| not_flags | No | Excluded timing flags | |
| date_start | No | Optional range start in YYYY-MM-DD | |
| game_types | No | One or more game types | |
| min_swings | No | Minimum swing threshold | |
| pitch_hand | No | Pitcher hand | |
| split_year | No | Split years into separate rows | |
| attack_zone | No | Attack zone | |
| pitch_types | No | One or more pitch type codes | |
| contact_type | No | Contact type | |
| swing_timing_x | No | Tied-up, centered, or flailed | |
| swing_timing_y | No | Early, on-time, or late | |
| swing_timing_z | No | Under, lined-up, or over |