# NFL Player Season Stats Leaderboard (ESPN)

> NFL Player Season Stats Leaderboard (ESPN) is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns NFL player season statistics as a paginated leaderboard sorted by a chosen stat category, covering passing, rushing, receiving, defense, scoring, returns, kicking, and punting for regular season or playoffs from 2004 to present.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/dev/pro-football-reference?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nfl-player-season-stats-leaderboard-espn-8fd8bfc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_A5y85mcZM4LZzp59JxHOV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nfl-player-season-stats-leaderboard-espn-8fd8bfc1
```

Example prompt: Pull me the NFL passing yards leaderboard for the 2024 regular season — show the top 25 qualified players including their completions, attempts, completion percentage, yards, touchdowns, interceptions, and passer rating.

## When to prefer this

Use this endpoint when you need structured, paginated NFL player stat leaderboards sourced from ESPN's public API — especially when Pro Football Reference's automated access restrictions are a concern. Prefer this for season-level player rankings across all major stat categories (passing, rushing, receiving, defense, kicking, punting) for any season from 2004 onward, both regular season and playoffs.

## Known failure modes

- Invalid season year outside 2004–present range returns empty results or error
- Invalid sort parameter value may default or return error
- Page number beyond available data returns empty results array
- qualifiedOnly=false may return very large datasets with many null stat fields
- ESPN upstream API unavailability causes request failure

## How this service works

NFL player season statistics, sorted leaderboard (default passing yards): per player team, position, games, completions, attempts, completion %, yards, Y/A, TD, INT, sacks, passer rating and QBR, plus rushing, receiving, defense, scoring, returns, kicking and punting. Regular season or playoffs, 2004 to now. Data from ESPN's public stats API (Pro Football Reference blocks automated access).

## Output

Returns a JSON object with pagination info (page, sort, season, source URL) and a results array where each entry contains the player's age, team, and a comprehensive stats object covering passing (completions, attempts, yards, TDs, INTs, QBR, passer rating, etc.), rushing, receiving, defensive, scoring, kicking, punting, and general stats — null fields indicate the stat category doesn't apply to that player.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "page": {
       "type": "string",
       "description": "Page, 1 to 40"
      },
      "sort": {
       "type": "string",
       "description": "passing, passtd, qbrating, qbr, rushing, rushtd, receiving, receptions, tackles, sacks, interceptions, points"
      },
      "limit": {
       "type": "string",
       "description": "Players per page, 1 to 50 (default 25)"
      },
      "season": {
       "type": "string",
       "description": "Season year, e.g. 2025 (default current)"
      },
      "seasonType": {
       "type": "string",
       "description": "regular (default) or playoffs"
      },
      "qualifiedOnly": {
       "type": "string",
       "description": "true (default) = only players meeting ESPN's minimums"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "sort": "passing",
  "season": 2026,
  "source": "https://www.espn.com/nfl/stats/player/_/season/2026/seasontype/2",
  "results": [
   {
    "age": 38,
    "team": "LAR",
    "stats": {
     "general": {
      "gamesPlayed": 6,
      "fumblesForced": 0,
      "fumblesRecovered": 1,
      "fumblesTouchdowns": 0
     },
     "kicking": {
      "fieldGoalPct": null,
      "extraPointPct": null,
      "fieldGoalsMade": null,
      "extraPointsMade": null,
      "fieldGoalsMade50": null,
      "fieldGoalAttempts": null,
      "longFieldGoalMade": null,
      "extraPointAttempts": null,
      "fieldGoalsMade1_19": null,
      "fieldGoalAttempts50": null,
      "fieldGoalsMade20_29": null,
      "fieldGoalsMade30_39": null,
      "fieldGoalsMade40_49": null,
      "fieldGoalAttempts1_19": null,
      "fieldGoalAttempts20_29": null,
      "fieldGoalAttempts30_39": null,
      "fieldGoalAttempts40_49": null
     },
     "passing": {
      "QBR": 67.34,
      "sacks": 10,
      "adjQBR": 64.22,
      "QBRating": 91.675,
      "completions": 164,
      "longPassing": 64,
      "passingYards": 1794,
      "completionPct": 65.863,
      "interceptions": 6,
      "sackYardsLost": 75,
      "passingAttempts": 249,
      "passingTouchdowns": 11,
      "passingYardsPerGame": 299,
      "yardsPerPassAttempt": 7.205
     },
     "punting": {
      "punts": null,
      "longPunt": null,
      "puntYards": null,
      "touchbacks": null,
      "fairCatches": null,
      "puntReturns": null,
      "puntsBlocked": null,
      "puntsInside20": null,
      "netAvgPuntYards": null,
      "puntReturnYards": null,
      "grossAvgPuntYards": null,
      "avgPuntReturnYards": null
     },
     "rushing": {
      "longRushing": 10,
      "rushingYards": 21,
      "rushingFumbles": 0,
      "rushingAttempts": 11,
      "rushingBigPlays": 0,
      "rushingFirstDowns": 2,
      "rushingTouchdowns": 0,
      "rushingFumblesLost": 0,
      "rushingYardsPerGame": 3.5,
      "yardsPerRushAttempt": 1.909
     },
     "scoring": {
      "fieldGoals": 0,
      "totalPoints": 0,
      "kickExtraPoints": 0,
      "totalTouchdowns": 0,
      "returnTouchdowns": 0,
      "rushingTouchdowns": 0,
      "totalPointsPerGame": 0,
      "totalTwoPointConvs": 0,
      "receivingTouchdowns": 0
     },
     "defensive": {
      "sacks": 0,
      "sackYards": 0,
      "soloTackles": 0,
      "totalTackles": 0,
      "assistTackles": 0,
      "passesDefended": 0,

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nfl-player-season-stats-leaderboard-espn-8fd8bfc1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)
