---
title: "Get Baseball Savant Home Runs Tracking"
method: GET
path: "/mlb/statcast-home-runs"
tags: ["MLB"]
---

# Get Baseball Savant Home Runs Tracking

`GET /mlb/statcast-home-runs`

## Request

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

Returns Batter or Pitcher Home Runs Tracking rows. Year, team id, minimum home runs, and Standard/Adjusted mode are first-party filters. The first-party table sorts client-side; this endpoint applies a named local sort and pagination. Use mlb_discovery for the exact filter sets. Per-player home-run plays are available from mlb-statcast-home-runs-details; trajectory images, video media, and CSV downloads are separate representations.

## Query parameters

- `player_type` 'Batter' | 'Pitcher'
- `year` '2019' | '2020' | '2021' | '2022' | '2023' | '2024' | '2025' | '2026'
- `team` '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'
- `min` '0' | '5' | '10' | '15' | '20' | '25'
- `cat` 'adj_xhr' | 'xhr'
- `sort` 'player' | 'team' | 'year' | 'cat' | 'avg_hr_trot' | 'doubters' | 'mostly_gone' | 'no_doubters' | 'no_doubter_per' | 'hr_total' | 'xhr' | 'xhr_diff'
- `sort_dir` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbStatcastHomeRunsResponseDoc
  - `board` string
  - `cat` string
  - `min` string
  - `player_type` string
  - `rows` object[]
  - `sort` string
  - `sort_dir` string
  - `team` string
  - `total` integer
  - `year` 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)