MLB

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.

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

Query parameters

type'batter' | 'batting-team' | 'pitcher' | 'pitching-team' | 'league'

Row type

seasonsstring[]

One or more seasons

game_typesstring[]

One or more game type codes

splitsstring[]

One or more split dimensions

min'q' | '1' | '5' | '10' | '25' | '50' | '100' | '200' | '500' | '1000'

Minimum batted-ball events

min_split'1' | '5' | '10' | '25' | '50' | '100' | '200' | '500' | '1000'

Minimum rows per split group

split_year'1' | '0'

Split seasons into separate rows

teamsstring[]

One or more MLB team ids

date_startstring

YYYY-MM-DD date range start (2015-04-05 through today)

date_endstring

YYYY-MM-DD date range end (2015-04-05 through today)

bat_side'L' | 'R'

Batter side

pitch_hand'L' | 'R'

Pitcher throwing hand

pitch_typesstring[]

One or more pitch type codes

include_league_averageboolean

Include the first-party league-average reference row

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'

Local table sort field

sort_dir'asc' | 'desc'

Sort direction

limitinteger

Rows per page (1-500)

offsetinteger

Zero-based row offset

Headers

x-api-keystring required

API key required

Response

OK

boardstring
game_typesstring[]
league_averageobject[]
minstring
min_splitstring
rowsobject[]
seasonsstring[]
show_league_averageboolean
totalinteger
typestring

Example response

{
  "board": "batted-ball",
  "game_types": [
    "R"
  ],
  "min": "q",
  "min_split": "1",
  "seasons": [
    "2026"
  ],
  "show_league_average": true,
  "total": 346,
  "type": "batter"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.