MLB

Get Baseball Savant Swing Timing and Miss Distance rows

Returns batter, batting-team, pitcher, pitching-team, or league rows with the page's season, game type, pitch-group, split, team, date, swing, contact, zone, pitch hand/type, count, timing-axis, and timing-flag filters. Sorting is local. Use mlb_discovery for exact values.

get/mlb/statcast-swing-timing

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/mlb/statcast-swing-timing
  • 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 types

splitsstring[]

One or more split dimensions

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

Minimum swing threshold

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

Minimum swings per split group

split_year'1' | '0'

Split years into separate rows

teamsstring[]

One or more MLB team ids

date_startstring

Optional range start in YYYY-MM-DD

date_endstring

Optional range end in YYYY-MM-DD

bat_side'L' | 'R'

Batter side

contact_type'2' | '4' | '9'

Contact type

attack_zone'0' | '1' | '1.1' | '2' | '3'

Attack zone

pitch_hand'L' | 'R'

Pitcher hand

pitch_typesstring[]

One or more pitch type codes

countsstring[]

One or more ball-strike counts

swing_timing_xstring[]

Tied-up, centered, or flailed

swing_timing_ystring[]

Early, on-time, or late

swing_timing_zstring[]

Under, lined-up, or over

flagsstring[]

Positive timing flags

not_flagsstring[]

Excluded timing flags

sort'name' | 'team_name' | 'pitch_hand_type' | 'bat_side_type' | 'n_swings' | 'competitive_swings' | 'strikes_swinging' | 'miss_distance' | 'flails' | 'centers' | 'tied_ups' | 'earlys' | 'on_times' | 'lates' | 'unders' | 'lined_ups' | 'overs' | 'delta_run_exp' | 'whiff_rate' | 'competitive_percent' | 'perfect_percent' | 'flawed_percent'

Local 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[]
rowsobject[]
seasonsstring[]
splitsstring[]
totalinteger
typestring

Example response

{
  "board": "swing-timing-miss-distance",
  "game_types": [
    "R"
  ],
  "seasons": [
    "2026"
  ],
  "splits": [
    "api_pitch_type_group09"
  ],
  "total": 926,
  "type": "batter"
}

Changes

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