---
title: "Get expanded standard Baseball Savant Statcast player plays"
method: GET
path: "/mlb/statcast-player-details"
tags: ["MLB"]
---

# Get expanded standard Baseball Savant Statcast player plays

`GET /mlb/statcast-player-details`

## Request

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

Returns the game-level pitch or batted-ball rows shown when expanding a batter or pitcher row in the standard Statcast leaderboard, including matchup, date, event, exit velocity, launch angle, distance, play id, and video availability.

## Query parameters

- `player_id` string, required
- `player_type` 'batter' | 'pitcher'
- `year` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbStatcastPlayerDetailsResponseDoc
  - `code` integer
  - `data` MlbStatcastPlayerDetailsResponse
    - `fetched_at` string
    - `player_id` string
    - `player_type` string
    - `plays` object[]
    - `source_url` string
    - `total` integer
    - `year` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `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)