---
title: "Get Baseball Savant Expected Statistics"
method: GET
path: "/mlb/statcast-expected"
tags: ["MLB"]
---

# Get Baseball Savant Expected Statistics

`GET /mlb/statcast-expected`

## Request

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

Returns the separate Expected Statistics leaderboard with batter, pitcher, and team views; season, team, batter-position, BIP/PA qualifier and threshold filters; local metric sorting; and pagination. League-average values are returned separately.

## Query parameters

- `type` 'batter' | 'pitcher' | 'batter-team' | 'pitcher-team'
- `year` integer
- `team_id` string
- `position` 'C' | '1B' | '2B' | 'SS' | '3B' | 'LF' | 'CF' | 'RF' | 'DH'
- `filter_type` 'bip' | 'pa'
- `minimum` 'q' | '1' | '25' | '50' | '100' | '150' | '200' | '250' | '350' | '450' | '500' | '600'
- `sort` 'entity_name' | 'entity_team_name' | 'pa' | 'bip' | 'ba' | 'est_ba' | 'ba_minus_est_ba_diff' | 'slg' | 'est_slg' | 'slg_minus_est_slg_diff' | 'woba' | 'est_woba' | 'woba_minus_est_woba_diff' | 'wobacon' | 'est_wobacon' | 'wobacon_minus_est_wobacon_diff' | 'exit_velocity_avg' | 'hard_hit_percent' | 'barrels_per_bip' | 'barrels_per_pa'
- `sort_dir` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbStatcastBoardResponseDoc
  - `code` integer
  - `data` MlbStatcastBoardResponse
    - `board` string
    - `end_year` integer
    - `fetched_at` string
    - `filter_type` string
    - `league_average` unknown[]
      - unknown
    - `limit` integer
    - `minimum` string
    - `offset` integer
    - `position` string
    - `range` string
    - `roles` 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
    - `split` string
    - `start_year` integer
    - `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/028417aa35bb?raw)