MLB

Get Baseball Savant Swing Path and Attack Angle rows

Returns batter, batting-team, or league Swing Path and Attack Angle rows with the first-party season, game, swing, team, date, side, contact, hard-hit, attack-zone, and pitcher-hand filters. Use mlb_discovery for exact values.

get/mlb/statcast-swing-path

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/mlb/statcast-swing-path
  • Auth: API key in header x-api-key

Query parameters

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

Row type

season_start'2023' | '2024' | '2025' | '2026'

First season

season_end'2023' | '2024' | '2025' | '2026'

Last season; must be >= season_start

game_type'Any' | 'Exhibition' | 'Playoff' | 'Regular'

Game type

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

Minimum swing threshold

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

Minimum swings per group

team_id'108' | '109' | '110' | '111' | '112' | '113' | '114' | '115' | '116' | '117' | '118' | '119' | '120' | '121' | '133' | '134' | '135' | '136' | '137' | '138' | '139' | '140' | '141' | '142' | '143' | '144' | '145' | '146' | '147' | '158'

Optional MLB team id

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

is_hard_hit'1' | '0'

Hard-hit filter

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

Attack zone

pitch_hand'L' | 'R'

Pitcher hand

sort'name' | 'team_name' | 'avg_sweetspot_speed_mph' | 'avg_plane_vertical_angle' | 'attack_angle' | 'attack_direction_pullopp' | 'rate_ideal_attack_angle' | 'avg_intercept_y_vs_plate' | 'avg_intercept_y_vs_batter' | 'avg_batter_y_position' | 'avg_batter_x_position' | 'avg_foot_sep0' | 'avg_foot_angle0' | 'n_swings'

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_typestring
rowsobject[]
season_endstring
season_startstring
totalinteger
typestring

Example response

{
  "board": "swing-path-attack-angle",
  "game_type": "Regular",
  "season_end": "2026",
  "season_start": "2026",
  "total": 203,
  "type": "batter"
}

Changes

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