ESPN statistical leaders API

Use the ESPN statistical leaders API to retrieve category or menu structure and sports records as structured JSON from ESPN. Supply league in the query; optionally select sport, season and category to set the requested scope. Use these results to compare positions within the selected table and follow reported standings for the relevant competitors. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.

Selected price
$0.002 / billing creditPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
League slug: nfl, college-football, nba, wnba, mens-college-basketball, womens-college-basketball, mlb, nhl, soccer competitions (eng.1 Premier League, esp.1 LaLiga, uefa.champions ...), f1, pga, atp, ufc. Other ESPN leagues work with `sport`.
Optional parameters (10)
Only needed for a league not listed under `league` (it is inferred for those).
Season year (2023 = the 2023 NFL season; NBA, NHL and other leagues that start in autumn use the year the season ends). Default: the current season.
1 preseason, 2 regular season, 3 postseason, 4 off season. Default: the current part of the season.
Leaders per category, 1-25 (default 10).
One category name from the `categories` list of the response, for example passingYards, points, rebounds.
0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
1 skips the 24-hour cache and fetches live.
JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.
With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.

Sample response

{
  "applied_filters": {
    "category": null,
    "limit": 1,
    "season": null,
    "seasontype": null
  },
  "cached": false,
  "categories": [
    "passingYards",
    "rushingYards",
    "receivingYards",
    "totalTackles",
    "sacks",
    "kickoffYards",
    "interceptions",
    "passingTouchdowns",
    "quarterbackRating",
    "rushingTouchdowns",
    "receptions",
    "receivingTouchdowns",
    "totalPoints",
    "totalTouchdowns",
    "puntYards",
    "passesDefended"
  ],
  "count": 16,
  "credits_used": 1,
  "fetched_at": "2026-11-19T12:21:13.266Z",
  "items": [
    {
      "abbreviation": "YDS",
      "category": "passingYards",
      "category_label": "Passing Yards",
      "display_value": "2838",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4036378.png",
        "id": "4036378",
        "jersey": "10",
        "name": "Jordan Love",
        "position": "QB",
        "short_name": "J. Love",
        "url": "https://www.espn.com/nfl/player/_/id/4036378/jordan-love"
      },
      "rank": 1,
      "team": {
        "abbreviation": "GB",
        "alternate_color": "ffb612",
        "color": "204e32",
        "id": "9",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/gb.png",
        "name": "Green Bay Packers",
        "nickname": "Packers",
        "short_name": "Packers",
        "url": "https://www.espn.com/nfl/team/_/name/gb/green-bay-packers"
      },
      "value": 2838
    },
    {
      "abbreviation": "YDS",
      "category": "rushingYards",
      "category_label": "Rushing Yards",
      "display_value": "1000",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4429795.png",
        "id": "4429795",
        "jersey": "0",
        "name": "Jahmyr Gibbs",
        "position": "RB",
        "short_name": "J. Gibbs",
        "url": "https://www.espn.com/nfl/player/_/id/4429795/jahmyr-gibbs"
      },
      "rank": 1,
      "team": {
        "abbreviation": "DET",
        "alternate_color": "bbbbbb",
        "color": "0076b6",
        "id": "8",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/det.png",
        "name": "Detroit Lions",
        "nickname": "Lions",
        "short_name": "Lions",
        "url": "https://www.espn.com/nfl/team/_/name/det/detroit-lions"
      },
      "value": 1000
    },
    {
      "abbreviation": "YDS",
      "category": "receivingYards",
      "category_label": "Receiving Yards",
      "display_value": "1207",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4430878.png",
        "id": "4430878",
        "jersey": "11",
        "name": "Jaxon Smith-Njigba",
        "position": "WR",
        "short_name": "J. Smith-Njigba",
        "url": "https://www.espn.com/nfl/player/_/id/4430878/jaxon-smith-njigba"
      },
      "rank": 1,
      "team": {
        "abbreviation": "SEA",
        "alternate_color": "69be28",
        "color": "002a5c",
        "id": "26",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sea.png",
        "name": "Seattle Seahawks",
        "nickname": "Seahawks",
        "short_name": "Seahawks",
        "url": "https://www.espn.com/nfl/team/_/name/sea/seattle-seahawks"
      },
      "value": 1207
    },
    {
      "abbreviation": "TOT",
      "category": "totalTackles",
      "category_label": "Total Tackles",
      "display_value": "107",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/2612151.png",
        "id": "2612151",
        "jersey": "49",
        "name": "Alex Singleton",
        "position": "LB",
        "short_name": "A. Singleton",
        "url": "https://www.espn.com/nfl/player/_/id/2612151/alex-singleton"
      },
      "rank": 1,
      "team": {
        "abbreviation": "DEN",
        "alternate_color": "fc4c02",
        "color": "0a2343",
        "id": "7",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/den.png",
        "name": "Denver Broncos",
        "nickname": "Broncos",
        "short_name": "Broncos",
        "url": "https://www.espn.com/nfl/team/_/name/den/denver-broncos"
      },
      "value": 107
    },
    {
      "abbreviation": "SACK",
      "category": "sacks",
      "category_label": "Sacks",
      "display_value": "10",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4685724.png",
        "id": "4685724",
        "jersey": "51",
        "name": "Will Anderson Jr.",
        "position": "DE",
        "short_name": "W. Anderson Jr.",
        "url": "https://www.espn.com/nfl/player/_/id/4685724/will-anderson-jr"
      },
      "rank": 1,
      "team": {
        "abbreviation": "HOU",
        "alternate_color": "eb0028",
        "color": "021018",
        "id": "34",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/hou.png",
        "name": "Houston Texans",
        "nickname": "Texans",
        "short_name": "Texans",
        "url": "https://www.espn.com/nfl/team/_/name/hou/houston-texans"
      },
      "value": 10.5
    },
    {
      "abbreviation": "KYDS",
      "category": "kickoffYards",
      "category_label": "Kickoff Yards",
      "display_value": "3500",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/3953687.png",
        "id": "3953687",
        "jersey": "17",
        "name": "Brandon Aubrey",
        "position": "PK",
        "short_name": "B. Aubrey",
        "url": "https://www.espn.com/nfl/player/_/id/3953687/brandon-aubrey"
      },
      "rank": 1,
      "team": {
        "abbreviation": "DAL",
        "alternate_color": "b0b7bc",
        "color": "002a5c",
        "id": "6",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/dal.png",
        "name": "Dallas Cowboys",
        "nickname": "Cowboys",
        "short_name": "Cowboys",
        "url": "https://www.espn.com/nfl/team/_/name/dal/dallas-cowboys"
      },
      "value": 3500
    },
    {
      "abbreviation": "INT",
      "category": "interceptions",
      "category_label": "Interceptions",
      "display_value": "6",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4241470.png",
        "id": "4241470",
        "jersey": "29",
        "name": "Xavier McKinney",
        "position": "S",
        "short_name": "X. McKinney",
        "url": "https://www.espn.com/nfl/player/_/id/4241470/xavier-mckinney"
      },
      "rank": 1,
      "team": {
        "abbreviation": "GB",
        "alternate_color": "ffb612",
        "color": "204e32",
        "id": "9",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/gb.png",
        "name": "Green Bay Packers",
        "nickname": "Packers",
        "short_name": "Packers",
        "url": "https://www.espn.com/nfl/team/_/name/gb/green-bay-packers"
      },
      "value": 6
    },
    {
      "abbreviation": "TD",
      "category": "passingTouchdowns",
      "category_label": "Passing Touchdowns",
      "display_value": "27",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/3915511.png",
        "id": "3915511",
        "jersey": "9",
        "name": "Joe Burrow",
        "position": "QB",
        "short_name": "J. Burrow",
        "url": "https://www.espn.com/nfl/player/_/id/3915511/joe-burrow"
      },
      "rank": 1,
      "team": {
        "abbreviation": "CIN",
        "alternate_color": "000000",
        "color": "fb4f14",
        "id": "4",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/cin.png",
        "name": "Cincinnati Bengals",
        "nickname": "Bengals",
        "short_name": "Bengals",
        "url": "https://www.espn.com/nfl/team/_/name/cin/cincinnati-bengals"
      },
      "value": 27
    },
    {
      "abbreviation": "RAT",
      "category": "quarterbackRating",
      "category_label": "Quarterback Rating",
      "display_value": "126",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4689114.png",
        "id": "4689114",
        "jersey": "6",
        "name": "Jaxson Dart",
        "position": "QB",
        "short_name": "J. Dart",
        "url": "https://www.espn.com/nfl/player/_/id/4689114/jaxson-dart"
      },
      "rank": 1,
      "team": {
        "abbreviation": "NYG",
        "alternate_color": "c9243f",
        "color": "003c7f",
        "id": "19",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/nyg.png",
        "name": "New York Giants",
        "nickname": "Giants",
        "short_name": "Giants",
        "url": "https://www.espn.com/nfl/team/_/name/nyg/new-york-giants"
      },
      "value": 125.85800170898438
    },
    {
      "abbreviation": "TD",
      "category": "rushingTouchdowns",
      "category_label": "Rushing Touchdowns",
      "display_value": "11",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/3918298.png",
        "id": "3918298",
        "jersey": "17",
        "name": "Josh Allen",
        "position": "QB",
        "short_name": "J. Allen",
        "url": "https://www.espn.com/nfl/player/_/id/3918298/josh-allen"
      },
      "rank": 1,
      "team": {
        "abbreviation": "BUF",
        "alternate_color": "d50a0a",
        "color": "00338d",
        "id": "2",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/buf.png",
        "name": "Buffalo Bills",
        "nickname": "Bills",
        "short_name": "Bills",
        "url": "https://www.espn.com/nfl/team/_/name/buf/buffalo-bills"
      },
      "value": 11
    },
    {
      "abbreviation": "REC",
      "category": "receptions",
      "category_label": "Receptions",
      "display_value": "79",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4430878.png",
        "id": "4430878",
        "jersey": "11",
        "name": "Jaxon Smith-Njigba",
        "position": "WR",
        "short_name": "J. Smith-Njigba",
        "url": "https://www.espn.com/nfl/player/_/id/4430878/jaxon-smith-njigba"
      },
      "rank": 1,
      "team": {
        "abbreviation": "SEA",
        "alternate_color": "69be28",
        "color": "002a5c",
        "id": "26",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sea.png",
        "name": "Seattle Seahawks",
        "nickname": "Seahawks",
        "short_name": "Seahawks",
        "url": "https://www.espn.com/nfl/team/_/name/sea/seattle-seahawks"
      },
      "value": 79
    },
    {
      "abbreviation": "TD",
      "category": "receivingTouchdowns",
      "category_label": "Receiving Touchdowns",
      "display_value": "10",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4430878.png",
        "id": "4430878",
        "jersey": "11",
        "name": "Jaxon Smith-Njigba",
        "position": "WR",
        "short_name": "J. Smith-Njigba",
        "url": "https://www.espn.com/nfl/player/_/id/4430878/jaxon-smith-njigba"
      },
      "rank": 1,
      "team": {
        "abbreviation": "SEA",
        "alternate_color": "69be28",
        "color": "002a5c",
        "id": "26",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sea.png",
        "name": "Seattle Seahawks",
        "nickname": "Seahawks",
        "short_name": "Seahawks",
        "url": "https://www.espn.com/nfl/team/_/name/sea/seattle-seahawks"
      },
      "value": 10
    },
    {
      "abbreviation": "TP",
      "category": "totalPoints",
      "category_label": "Total Points",
      "display_value": "88",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/3124679.png",
        "id": "3124679",
        "jersey": "19",
        "name": "Jason Sanders",
        "position": "PK",
        "short_name": "J. Sanders",
        "url": "https://www.espn.com/nfl/player/_/id/3124679/jason-sanders"
      },
      "rank": 1,
      "team": {
        "abbreviation": "NYJ",
        "alternate_color": "ffffff",
        "color": "115740",
        "id": "20",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/nyj.png",
        "name": "New York Jets",
        "nickname": "Jets",
        "short_name": "Jets",
        "url": "https://www.espn.com/nfl/team/_/name/nyj/new-york-jets"
      },
      "value": 88
    },
    {
      "abbreviation": "TTD",
      "category": "totalTouchdowns",
      "category_label": "Total Touchdowns",
      "display_value": "13",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/3117251.png",
        "id": "3117251",
        "jersey": "23",
        "name": "Christian McCaffrey",
        "position": "RB",
        "short_name": "C. McCaffrey",
        "url": "https://www.espn.com/nfl/player/_/id/3117251/christian-mccaffrey"
      },
      "rank": 1,
      "team": {
        "abbreviation": "SF",
        "alternate_color": "b3995d",
        "color": "aa0000",
        "id": "25",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/sf.png",
        "name": "San Francisco 49ers",
        "nickname": "49ers",
        "short_name": "49ers",
        "url": "https://www.espn.com/nfl/team/_/name/sf/san-francisco-49ers"
      },
      "value": 13
    },
    {
      "abbreviation": "PYDS",
      "category": "puntYards",
      "category_label": "Punt Yards",
      "display_value": "2393",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4039396.png",
        "id": "4039396",
        "jersey": "13",
        "name": "Corey Bojorquez",
        "position": "P",
        "short_name": "C. Bojorquez",
        "url": "https://www.espn.com/nfl/player/_/id/4039396/corey-bojorquez"
      },
      "rank": 1,
      "team": {
        "abbreviation": "CLE",
        "alternate_color": "ff3c00",
        "color": "472a08",
        "id": "5",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/cle.png",
        "name": "Cleveland Browns",
        "nickname": "Browns",
        "short_name": "Browns",
        "url": "https://www.espn.com/nfl/team/_/name/cle/cleveland-browns"
      },
      "value": 2393
    },
    {
      "abbreviation": "PD",
      "category": "passesDefended",
      "category_label": "Passes Defended",
      "display_value": "14",
      "player": {
        "country": null,
        "flag": null,
        "headshot": "https://a.espncdn.com/i/headshots/nfl/players/full/4912847.png",
        "id": "4912847",
        "jersey": "25",
        "name": "Jacob Parrish",
        "position": "CB",
        "short_name": "J. Parrish",
        "url": "https://www.espn.com/nfl/player/_/id/4912847/jacob-parrish"
      },
      "rank": 1,
      "team": {
        "abbreviation": "TB",
        "alternate_color": "3e3a35",
        "color": "bd1c36",
        "id": "27",
        "location": null,
        "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/tb.png",
        "name": "Tampa Bay Buccaneers",
        "nickname": "Buccaneers",
        "short_name": "Buccaneers",
        "url": "https://www.espn.com/nfl/team/_/name/tb/tampa-bay-buccaneers"
      },
      "value": 14
    }
  ],
  "league": "nfl",
  "season": {
    "name": "2026",
    "type": "Regular Season",
    "year": 2026
  },
  "sport": "football"
}

Response result

Response structure

Inferred from examples
  • applied_filtersobject
    • categorynull
    • limitinteger
    • seasonnull
    • seasontypenull
  • cachedboolean
  • categoriesstring[]
  • countinteger
  • credits_usedinteger
  • fetched_atstring
  • itemsobject[]
    • abbreviationstring
    • categorystring
    • category_labelstring
    • display_valuestring
    • playerobject
      • countrynull
      • flagnull
      • headshotstring
      • idstring
      • jerseystring
      • namestring
      • positionstring
      • short_namestring
      • urlstring
    • rankinteger
    • teamobject
      • abbreviationstring
      • alternate_colorstring
      • colorstring
      • idstring
      • locationnull
      • logostring
      • namestring
      • nicknamestring
      • short_namestring
      • urlstring
    • valuenumber
  • leaguestring
  • seasonobject
    • namestring
    • typestring
    • yearinteger
  • sportstring

Loading related APIs…

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use ESPN statistical leaders API with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.