mlb_statcast_batted_ball
Get Baseball Savant Batted Ball Profile rows for batters, pitchers, teams, or league totals with filters for season, game type, split, date, hand, pitch type, and minimum events.
Instructions
Get Baseball Savant Batted Ball Profile rows. Returns the Batted Ball Profile table for batters, batting teams, pitchers, pitching teams, or league totals. Supports first-party season, game type, split, team, date, side, hand, pitch type, event threshold, and split-group threshold filters. The All-Star A game type is accepted by the live page query although its checkbox is hidden. Sorting and pagination are local. The league-average reference row is returned separately when requested; CSV and visualization controls are outside this JSON contract.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| min | No | Minimum batted-ball events | |
| sort | No | Local table sort field | |
| type | No | Row type | |
| limit | No | Rows per page (1-500) | |
| teams | No | One or more MLB team ids | |
| 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 | YYYY-MM-DD date range end (2015-04-05 through today) | |
| sort_dir | No | Sort direction | |
| min_split | No | Minimum rows per split group | |
| date_start | No | YYYY-MM-DD date range start (2015-04-05 through today) | |
| game_types | No | One or more game type codes | |
| pitch_hand | No | Pitcher throwing hand | |
| split_year | No | Split seasons into separate rows | |
| pitch_types | No | One or more pitch type codes | |
| include_league_average | No | Include the first-party league-average reference row |