---
title: "Get MLB league leaders"
method: GET
path: "/mlb/league-leaders"
tags: ["MLB"]
---

# Get MLB league leaders

`GET /mlb/league-leaders`

## Request

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

Returns ranked MLB leader entries for one or more validated categories. Use mlb-discovery for all accepted categories, groups, and game type codes.

## Query parameters

- `categories` string, required
- `season` integer
- `group` 'hitting' | 'pitching' | 'fielding' | 'catching' | 'running' | 'game' | 'team' | 'streak'
- `game_type` 'S' | 'R' | 'F' | 'D' | 'L' | 'W' | 'C' | 'P' | 'A' | 'I' | 'E'
- `league_id` '103' | '104'
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- MlbLeagueLeadersResponseDoc
  - `code` integer
  - `data` MlbLeagueLeadersResponse
    - `categories` string[]
    - `count` integer
    - `fetched_at` string
    - `results` MlbLeaderCategory[]
      - `category` string
      - `game_type` string
      - `group` string
      - `leaders` MlbLeaderEntry[]
        - `league` MlbNamedRef
          - `id` integer: MLB id of the player or league.
          - `name` string: Name of the player or league.
        - `player` MlbNamedRef
          - `id` integer: MLB id of the player or league.
          - `name` string: Name of the player or league.
        - `rank` integer
        - `season` string
        - `stats` object
        - `team` MlbTeamRef
          - `abbreviation` string: Short team abbreviation, for example `NYY`. Omitted when not available.
          - `id` integer: MLB team id.
          - `name` string: Full team name.
        - `value` string
      - `season` string
      - `total` integer
    - `season` integer
    - `source_url` string
  - `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)