---
title: "Get Baseball Savant Batted Ball Profile rows"
method: GET
path: "/mlb/statcast-batted-ball"
tags: ["MLB"]
---

# Get Baseball Savant Batted Ball Profile rows

`GET /mlb/statcast-batted-ball`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/mlb/statcast-batted-ball`
- Auth: API key in header `x-api-key`

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.

## Query parameters

- `type` 'batter' | 'batting-team' | 'pitcher' | 'pitching-team' | 'league'
- `seasons` string[]
- `game_types` string[]
- `splits` string[]
- `min` 'q' | '1' | '5' | '10' | '25' | '50' | '100' | '200' | '500' | '1000'
- `min_split` '1' | '5' | '10' | '25' | '50' | '100' | '200' | '500' | '1000'
- `split_year` '1' | '0'
- `teams` string[]
- `date_start` string
- `date_end` string
- `bat_side` 'L' | 'R'
- `pitch_hand` 'L' | 'R'
- `pitch_types` string[]
- `include_league_average` boolean
- `sort` 'name' | 'team_name' | 'num_bbe' | 'gb_rate' | 'air_rate' | 'fb_rate' | 'ld_rate' | 'pu_rate' | 'pull_rate' | 'straight_rate' | 'oppo_rate' | 'pull_gb_rate' | 'straight_gb_rate' | 'oppo_gb_rate' | 'pull_air_rate' | 'straight_air_rate' | 'oppo_air_rate'
- `sort_dir` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbStatcastBattedBallResponseDoc
  - `board` string
  - `game_types` string[]
  - `league_average` object[]
  - `min` string
  - `min_split` string
  - `rows` object[]
  - `seasons` string[]
  - `show_league_average` boolean
  - `total` integer
  - `type` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)