---
title: "Get Baseball Savant Statcast leaderboard data"
method: GET
path: "/mlb/statcast-leaders"
tags: ["MLB"]
---

# Get Baseball Savant Statcast leaderboard data

`GET /mlb/statcast-leaders`

## Request

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

Returns the standard anonymous Baseball Savant Statcast leaderboard for batters, pitchers, teams, or pitcher teams. Supports the page's season, team, batter position, minimum batted-ball event, and sortable metric filters, plus local pagination. Use mlb_discovery for exact filter sets. Other Baseball Savant leaderboard pages are listed there but are not represented by this route.

## Query parameters

- `type` 'batter' | 'pitcher' | 'batter-team' | 'pitcher-team'
- `year` integer
- `team_id` string
- `position` 'C' | '1B' | '2B' | 'SS' | '3B' | 'LF' | 'CF' | 'RF' | 'DH'
- `min_bbe` 'q' | '1' | '25' | '50' | '100' | '150' | '200' | '250' | '350' | '450' | '500' | '600'
- `sort` 'entity_name' | 'bip' | 'launch_angle_avg' | 'sweet_spot_percent' | 'exit_velocity_max' | 'exit_velocity_avg' | 'avg_best_speed' | 'exit_velocity_fbld' | 'distance_max' | 'distance_hr_avg' | 'hard_hit_ct' | 'hard_hit_percent' | 'hard_hit_per_swing' | 'barrel_ct' | 'barrels_per_bip' | 'barrels_per_pa'
- `sort_dir` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbStatcastResponseDoc
  - `code` integer
  - `data` MlbStatcastResponse
    - `fetched_at` string
    - `limit` integer
    - `min_bbe` string
    - `offset` integer
    - `position` string
    - `rows` MlbStatcastRow[]
      - `entity_id` string
      - `metrics` object
      - `name` string
      - `position` string
      - `qualified` boolean
      - `rank` integer
      - `team` string
      - `team_id` string
    - `sort` string
    - `sort_dir` string
    - `source_url` string
    - `team_id` integer
    - `total` integer
    - `type` string
    - `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/0497899e2016?raw)