MLB Stats API Docs

Type to search endpoints by name, path, or keyword.

GET/api/v1/stats/leaders

Stat leaders

Leaderboards for a stat category.

On this page

Try it

Query
https://statsapi.mlb.com/api/v1/stats/leaders?leaderCategories=homeRuns&season=2026&sportId=1&limit=5
const res = await fetch('https://statsapi.mlb.com/api/v1/stats/leaders?leaderCategories=homeRuns&season=2026&sportId=1&limit=5')
const data = await res.json()
curl -s 'https://statsapi.mlb.com/api/v1/stats/leaders?leaderCategories=homeRuns&season=2026&sportId=1&limit=5'

Reference

Query parameters

NameTypeRequiredDescription
leaderCategoriescsvyes

Stat category, e.g. homeRuns, era, battingAverage.

seasonnumberno

Four-digit year.

sportIdnumberno

Sport id. 1 is MLB.

statGrouphittingpitchingfieldingno

Stat group.

limitnumberno

How many leaders.

Response

Type: LeadersResponse

/** `GET /api/v1/stats/leaders` */
export interface LeadersResponse extends WithCopyright {
	leagueLeaders: LeaderCategory[]
}

Notes

  • Category names come from /api/v1/statsLeaders / /api/v1/baseballStats.

Build with it

Live examples powered by this endpoint with real data. Inspiration — restyle and remix freely.

Leaderboard

Top ten by category (HR, AVG, RBI, …) with headshots — switch the stat with a tap.

Loading leaders…

Example URLs

  • Home run leaders (2026): https://statsapi.mlb.com/api/v1/stats/leaders?leaderCategories=homeRuns&season=2026&sportId=1&limit=5