Endpoint Playground
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.
14 Oct 2026: 40 rows; 23 fields had a value in every checked item.
Sample value profiles: air_rate: 0.59 to 0.74, median 0.66; b_name_display_first_last: “Crow-Armstrong, Pete” and 39 other values; fb_rate: 0.23 to 0.43, median 0.33.
curl 'https://api.crawlora.net/api/v1/mlb/statcast-batted-ball?type=batter&min=q&min_split=1&split_year=1&bat_side=L&pitch_hand=L&sort=name&sort_dir=asc' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| type | string | No | batter | Row type |
| seasons | array | No | One or more seasons | |
| game_types | array | No | One or more game type codes | |
| splits | array | No | One or more split dimensions | |
| min | string | No | q | Minimum batted-ball events |
| min_split | string | No | 1 | Minimum rows per split group |
| split_year | string | No | 1 | Split seasons into separate rows |
| teams | array | No | One or more MLB team ids | |
| date_start | string | No | YYYY-MM-DD date range start (2015-04-05 through today) | |
| date_end | string | No | YYYY-MM-DD date range end (2015-04-05 through today) | |
| bat_side | string | No | L | Batter side |
| pitch_hand | string | No | L | Pitcher throwing hand |
| pitch_types | array | No | One or more pitch type codes | |
| include_league_average | boolean | No | Include the first-party league-average reference row | |
| sort | string | No | name | Local table sort field |
| sort_dir | string | No | asc | Sort direction |
| limit | integer | No | Rows per page (1-500) | |
| offset | integer | No | Zero-based row offset |
{
"code": 200,
"data": {
"board": "batted-ball",
"type": "batter",
"seasons": [
"2026"
],
"game_types": [
"R"
],
"min": "q",
"total": 346,
"rows": [
{
"name": "Rojas, Miguel",
"team_name": "Dodgers",
"num_bbe": 207,
"pull_air_rate": 0.169
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.