MLB

Get Baseball Savant Year-to-Year Changes

Returns one of Baseball Savant's Year-to-Year Changes tables for batters, pitchers, batting teams, or pitching teams. Select one of the live statistic types and comparison start years; the page data contains available yearly values and differences. Table sorting and pagination are applied locally. Use mlb_discovery for all accepted group, type, and year values.

get/mlb/statcast-year-to-year

Request

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

Query parameters

group'Batter' | 'Pitcher' | 'Batter Team' | 'Pitcher Team'

Table group

type'ba' | 'xba' | 'obp' | 'xobp' | 'slg' | 'xslg' | 'iso' | 'xiso' | 'babip' | 'woba' | 'xwoba' | 'wobacon' | 'xwobacon' | 'bacon' | 'xbacon' | 'hard_hit_percent' | 'exit_velocity_avg' | 'sweet_spot_percent' | 'barrel_batted_rate' | 'launch_angle_avg' | 'avg_swing_speed' | 'attack_angle' | 'ideal_angle_rate' | 'attack_direction' | 'vertical_swing_path' | 'avg_swing_length' | 'fastball_velo' | 'breaking_velo' | 'offspeed_velo' | 'barrels' | 'popups_percent' | 'flyballs_percent' | 'linedrives_percent' | 'groundballs_percent' | 'pull_percent' | 'straightaway_percent' | 'opposite_percent' | 'poorlyweak_percent' | 'pull_percent_airballs' | 'poorlytopped_percent' | 'poorlyunder_percent' | 'flareburner_percent' | 'solidcontact_percent' | 'hr_flyballs_percent' | 'popups' | 'flyballs' | 'linedrives' | 'groundballs' | 'in_zone_percent' | 'out_zone_percent' | 'edge_percent' | 'z_swing_percent' | 'oz_swing_percent' | 'iz_contact_percent' | 'oz_contact_percent' | 'whiff_percent' | 'f_strike_percent' | 'f_swing_percent' | 'swing_percent' | 'meatball_swing_percent' | 'meatball_percent' | 'z_swing_miss_percent' | 'oz_swing_miss_percent' | 'in_zone' | 'out_zone' | 'edge' | 'in_zone_swing' | 'out_zone_swing' | 'in_zone_swing_miss' | 'out_zone_swing_miss' | 'pitch_count' | 'pa' | 'ab' | 'hit' | 'single' | 'double' | 'triple' | 'home_run' | 'walk' | 'strikeout' | 'k_percent' | 'bb_percent' | 'hbp' | 'batted_ball' | 'pitch_usage_fastball' | 'pitch_usage_offspeed' | 'pitch_usage_breaking' | 'pitch_count_fastball' | 'pitch_count_offspeed' | 'pitch_count_breaking'

Statistic type

year'2025' | '2024' | '2023' | '2022' | '2021' | '2020' | '2019' | '2018' | '2017'

Comparison start year; compares this season with the following year

sortstring

Local sortable column; name_display_last_first, year_YYYY, TYPE_YYYY, or TYPE_diff_YYYY. Defaults to the selected metric's difference for the selected comparison year.

sort_dir'asc' | 'desc'

Sort direction; defaults to Batter descending and Pitcher ascending

limitinteger

Rows per page (1-500)

offsetinteger

Zero-based row offset (0-5000)

Headers

x-api-keystring required

API key required

Response

OK

boardstring
fetched_atstring
groupstring
limitinteger
next_yearinteger
offsetinteger
rowsobject[]
sortstring
sort_dirstring
source_urlstring
totalinteger
typestring
yearstring

Example response

{
  "board": "year-to-year",
  "group": "Batter",
  "limit": 100,
  "next_year": 2026,
  "sort": "hard_hit_percent_diff_2025",
  "sort_dir": "desc",
  "total": 177,
  "type": "hard_hit_percent",
  "year": "2025"
}

Changes

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