get_plate_appearances
Read-only
Use for plate-appearance play-by-play: a whole game in order, or a batter's, pitcher's or team's season, with the base-out state before, the result, the batted ball (trajectory and location), runs, the win probability after (2019 on) and our run value (RE24). Filter by result, inning or runners in scoring position. Costs 10 credits.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| risp | No | Runners in scoring position only. | |
| team | No | Batting team (id or abbreviation). | |
| limit | No | Max rows (default 200). | |
| inning | No | ||
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| offset | No | ||
| result | No | e.g. home-run, strikeout, walk, single, double, ground-out. | |
| season | No | Season (a year; default: the latest; ignored with game_id). | |
| game_id | No | ||
| batter_id | No | ||
| pitcher_id | No | ||
| season_type | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes | ||
| next_offset | No | ||
| plate_appearances | Yes |