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

# Get Baseball Savant Home Runs play details

`GET /mlb/statcast-home-runs-details`

## Request

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

Returns the home-run plays expanded from one batter or pitcher leaderboard row, with event measurements and park outcomes. Provide the exact player id, player type, year, and mode from the row. Play identifiers and source links are returned; trajectory images, video media, and CSV output are not included.

## Query parameters

- `player_id` string, required
- `player_type` 'Batter' | 'Pitcher'
- `year` '2019' | '2020' | '2021' | '2022' | '2023' | '2024' | '2025' | '2026'
- `cat` 'adj_xhr' | 'xhr'
- `limit` integer
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbStatcastHomeRunsDetailsResponseDoc
  - `cat` string
  - `player_id` string
  - `player_type` string
  - `plays` object[]
  - `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/028417aa35bb?raw)