List season leaders for a stat

{
  "data": [
    {
      "player_id": "string",
      "value": 1.1
    }
  ],
  "players": [
    {
      "id": "string",
      "first_name": "string",
      "last_name": "string",
      "full_name": "string",
      "abbr_name": "string",
      "birth_date": "2023-01-15",
      "birth_place": "string",
      "height_in": 1,
      "weight_lb": 1,
      "bats": "L",
      "throws": "L",
      "primary_position": "QB",
      "college": "string",
      "rookie_year": 1,
      "draft": {
        "year": 1,
        "round": 1,
        "pick": 1,
        "team_id": "string"
      },
      "version": 1,
      "updated_at": "2024-01-15T09:30:00Z"
    }
  ],
  "next_cursor": "string"
}

Players ranked by one stat of their season totals across teams. Ties are broken by player id, so pages are stable.

Authentication

AuthorizationBearer

An API key, sent as Authorization: Bearer <key>.

Path parameters

leaguestringRequiredformat: "^[a-z][a-z0-9]*$"

The league's alias.

yearintegerRequired

season_typeenumRequired

Preseason, regular season, postseason, play-in tournament or all-star.

Allowed values:

Query parameters

categorystringRequired

statstringRequired

The stat code to rank by.

orderenumOptionalDefaults to desc

desc ranks high values first; asc suits low-is-better stats such as ERA.

Allowed values:

min_gamesintegerOptional>=0Defaults to 0

qualifierstringOptional

A second stat a player needs at least qualifier_min of, such as attempts.

qualifier_mindoubleOptionalDefaults to 0

cursorstringOptional

next_cursor from the previous page. Omit it for the first page.

limitintegerOptional1-500Defaults to 100

Page size.

Response headers

RateLimit-PolicystringOptional

Your plan’s allowance: q requests per period of w seconds. See Rate limits.

RateLimitstringOptional

Requests left this period after this response (r) and seconds until it resets (t). See Rate limits.

Response

A page of leaders with their players.

datalist of objects

playerslist of objects

next_cursorstring or null

Pass as cursor for the next page; null on the last page.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error