MLB API endpoint
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.
/mlb/statcast-home-runs-detailsReturns individual home-run plays for one player in the selected Home Runs
Tracking table context. Use the player's player_id, player_type, year, and
cat from /api/v1/mlb/statcast-home-runs. The source returns plays for a
batter or for a pitcher who allowed home runs. Each row includes play and game
identifiers, event measurements, batter/pitcher identity, and park outcomes.
player_id: required positive MLB player id from a Home Runs Tracking row.player_type: Batter or Pitcher; defaults to Batter.year: 2019, 2020, 2021, 2022, 2023, 2024, 2025, or 2026 in
the live selector checked on 2026-09-30; defaults to the current season.cat: adj_xhr or xhr; defaults to adj_xhr.limit: 1–500; defaults to 100.offset: 0–5000; defaults to 0.The player_type determines which player id in each play is checked: batters
match batter_id, pitchers match pitcher_id. The endpoint returns play
identifiers and source links, not the linked video or trajectory graphic.
GET /api/v1/mlb/statcast-home-runs-details?player_id=691718&player_type=Batter&year=2026&cat=adj_xhr&limit=2
| Field | Filled in, of 40 checked | Values in the sample |
|---|---|---|
| ari | 40 | 0 to 1, median 1 |
| atl | 40 | 0 to 1, median 1 |
| bal | 40 | 0 to 1, median 1 |
| batter_id | 40 | |
| batter_name | 40 | Crow-Armstrong, Pete in all 40 |
| bos | 40 | 0 to 1, median 0 |
| cat | 40 | adj_xhr in all 40 |
| chc | 40 | 0 to 1, median 1 |
| cin | 40 | 0 to 1, median 1 |
| cle | 40 | 0 to 1, median 1 |
| col | 40 | 0 to 1, median 1 |
| ct | 40 | 1 to 30, median 26 |
| cws | 40 | 0 to 1, median 1 |
| det | 40 | 0 to 1, median 1 |
| exit_velocity | 40 | 94 to 112, median 103 |
| game_date | 40 | 2026-06-17 to 2026-09-20 |
| game_pk | 40 | 822,697 to 824,815, median 824,628 |
| hou | 40 | 0 to 1, median 1 |
| hr_cat | 40 | Mostly Gone (19), No Doubter (14), Doubter (7) |
| hr_distance | 40 | 325 to 444, median 391 |
| hr_trot | 31 | 20.59 to 33.25, median 25 |
| hr_type | 28 | no_doubter (14), doubter (7), mostly_gone (7) |
| kc | 40 | 0 to 1, median 1 |
| laa | 40 | 0 to 1, median 1 |
| lad | 40 | 0 to 1, median 1 |
| launch_angle | 40 | 20 to 42, median 28 |
| mia | 40 | 0 to 1, median 1 |
| mil | 40 | 0 to 1, median 1 |
| min | 40 | 0 to 1, median 1 |
| nym | 40 | 0 to 1, median 1 |
| nyy | 40 | 0 to 1, median 1 |
| oak | 40 | 0 to 1, median 1 |
| phi | 40 | 0 to 1, median 1 |
| pit | 40 | 0 to 1, median 1 |
| pitcher_id | 40 | |
| pitcher_name | 40 | “Spiers, Carson” and 32 other values |
| play_id | 40 | |
| play_url | 40 | research.mlb.com |
| result | 40 | home_run (31), double (5), triple (2) and 2 more |
| sd | 40 | 0 to 1, median 1 |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| player_id | string | Yes | Positive MLB player id from mlb-statcast-home-runs | 691718 | |
| player_type | string | No | Table type Allowed values: Batter, Pitcher. | ||
| year | string | No | Season Allowed values: 2019, 2020, 2021, 2022, 2023, 2024, 2025, 2026. | ||
| cat | string | No | Trajectory mode Allowed values: adj_xhr, xhr. | ||
| limit | integer | No | Rows per page (1-500) Minimum: 1. Maximum: 500. | ||
| offset | integer | No | Zero-based row offset Minimum: 0. Maximum: 5000. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/mlb/statcast-home-runs-details?player_id=691718&player_type=Batter&year=2019&cat=adj_xhr&limit=10" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"player_id": "691718",
"player_type": "Batter",
"year": "2026",
"cat": "adj_xhr",
"total": 61,
"offset": 0,
"limit": 2,
"plays": [
{
"game_pk": "824462",
"play_id": "6dd33523-6f40-3800-acde-939bb60aedd1",
"game_date": "2026-09-20",
"batter_id": "691718",
"pitcher_id": "686730",
"hr_distance": "411",
"hr_cat": "Mostly Gone"
}
]
}
}Request schema
No body schema
Response schema
#/definitions/mlb.statcastHomeRunsDetailsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| cat | string | No | adj_xhr | |||
| player_id | string | No | 691718 | |||
| player_type | string | No | Batter | |||
| plays | array | No | ||||
| total | integer | No | 61 | |||
| year | string | No | 2026 |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/mlb/statcast-home-runs-details?player_id=691718&player_type=Batter&year=2019&cat=adj_xhr&limit=10" \
-H "x-api-key: $CRAWLORA_API_KEY"