# Sports Reference API: List season leaders

> Lists league leaders for a season and statistic in NBA basketball, NFL football, MLB baseball or NHL hockey. If no season is given, it uses the latest season with published leaders.

Unofficial. Not affiliated with or endorsed by Sports Reference.

- Page: https://fous.com/methods/sports-reference.com/list-season-leaders
- Method: `sports-reference.com/list_season_leaders`, version 1
- Website: sports-reference.com
- Returns: sport, league, season, stat name, leaders page link, leaders (rank, player, team, value, player link)
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `stat` | string | yes | `"points per game"` | Statistic in plain words. Example: points per game. |
| `sport` | string | yes | `"basketball"` | Sport: basketball, football, baseball, or hockey. Example: basketball. One of "basketball", "football", "baseball", "hockey". |
| `season` | integer | no | `2025` | Year the season ends, for example 2025. Defaults to the latest season with stats. |
| `max_results` | integer | no | `50` | Number of leaders to list, for example 10. Default 10, maximum 50. Default 10. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "stat": "points per game",
  "sport": "basketball",
  "season": 2025,
  "max_results": 50
}
```

Its output:

```json
{
  "sport": "basketball",
  "league": "NBA",
  "season": 2025,
  "leaders": [
    {
      "rank": 1,
      "team": "OKC",
      "value": 32.7,
      "player": "Shai Gilgeous-Alexander",
      "player_link": "https://www.basketball-reference.com/players/g/gilgesh01.html"
    },
    {
      "rank": 2,
      "team": "MIL",
      "value": 30.4,
      "player": "Giannis Antetokounmpo",
      "player_link": "https://www.basketball-reference.com/players/a/antetgi01.html"
    },
    {
      "rank": 3,
      "team": "DEN",
      "value": 29.6,
      "player": "Nikola Jokić",
      "player_link": "https://www.basketball-reference.com/players/j/jokicni01.html"
    }
  ],
  "stat_name": "Points Per Game",
  "leaders_page_link": "https://www.basketball-reference.com/leagues/NBA_2025_leaders.html#leaders_pts_per_g"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"sports-reference.com/list_season_leaders","input":{"stat":"points per game","sport":"basketball","season":2025,"max_results":50}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Who led the NBA in points per game in the 2024 season? Show me the top 10.
- Top 15 NFL passing yards leaders for the 2023 season, please.
- List the MLB home run leaders from 1998 with the top 20 players.
- Show the NHL goals leaders for the 2019 season on sports-reference.com.
- What were the latest basketball assists per game leaders, top 5 only?

## Input schema

```json
{
  "type": "object",
  "required": [
    "sport",
    "stat"
  ],
  "properties": {
    "stat": {
      "type": "string",
      "description": "Statistic in plain words. Example: points per game."
    },
    "sport": {
      "enum": [
        "basketball",
        "football",
        "baseball",
        "hockey"
      ],
      "type": "string",
      "description": "Sport: basketball, football, baseball, or hockey. Example: basketball."
    },
    "season": {
      "type": "integer",
      "minimum": 1900,
      "description": "Year the season ends, for example 2025. Defaults to the latest season with stats."
    },
    "max_results": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Number of leaders to list, for example 10. Default 10, maximum 50."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "sport",
    "league",
    "season",
    "stat_name",
    "leaders_page_link",
    "leaders"
  ],
  "properties": {
    "sport": {
      "type": "string"
    },
    "league": {
      "type": "string"
    },
    "season": {
      "type": "integer"
    },
    "leaders": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "player",
          "value",
          "player_link"
        ],
        "properties": {
          "rank": {
            "type": "integer"
          },
          "team": {
            "type": [
              "string",
              "null"
            ]
          },
          "value": {
            "type": "number"
          },
          "player": {
            "type": "string"
          },
          "player_link": {
            "type": "string"
          }
        }
      }
    },
    "stat_name": {
      "type": "string"
    },
    "leaders_page_link": {
      "type": "string"
    }
  }
}
```

## See more

- [Sports Reference API: Get player career statistics](https://fous.com/methods/sports-reference.com/get-player-career.md): Finds a player on Basketball, Pro Football, Baseball or Hockey Reference and returns regular-season career statistics, awards and a season-by-season record.
- [Premier League API: List top players by stat](https://fous.com/methods/premierleague.com/list-top-scorers.md): Ranks Premier League players for a season by goals, assists or goalkeeper clean sheets, with each player's club and nationality.
- [ESPN API: Get player stats](https://fous.com/methods/espn.com/get-player-stats.md): Looks up an ESPN player by name and returns season and career statistics. Use a league to tell apart players with the same name, and a season year or label to pick a past season.
- [Yahoo API: Get player stats](https://fous.com/methods/sports.yahoo.com/get-player-stats.md): Looks up a Yahoo Sports player by name and returns the player's regular-season statistics for a season, alongside career totals. Each stat includes season and career values.
- [Yahoo API: Get team standings](https://fous.com/methods/sports.yahoo.com/get-standings.md): Returns Yahoo Sports team standings for a league and season, grouped by division or conference.
- [MLB API: Get standings](https://fous.com/methods/mlb.com/get-standings.md): Returns MLB regular-season division standings for a season: records, win percentage, games back, streak, last 10 games and wild-card games back. Defaults to the current year.
- [NHL API: Get player stats](https://fous.com/methods/nhl.com/get-player-stats.md): Looks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals.
- [NBA API: Get standings](https://fous.com/methods/nba.com/get-standings.md): Returns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page.
- [All Sports Reference methods](https://fous.com/methods/sports-reference.com.md)
