Skip to content
PuckAPI

get_skater_season_stats

5 creditsStats + aggregationPOST /v1/get_skater_season_stats

Data refreshed · changelog

Skater leaderboard sorted by points, goals, assists, plus/minus, or shots.

Use it when you want to rank skaters across the league or within a team, with special-teams production and usage alongside the counting stats. Use get_goalie_stats for goaltenders and get_player_stats for one player in depth.

Parameters

teamstringoptional
Filter by team abbreviation
seasonstringoptional
Season (e.g. "20252026"). Defaults to current.
min_gamesintegeroptional
Minimum games played (default 10)
sort_bystringoptional
points, goals, assists, plus_minus, or shots (default points)
limitintegeroptional
Max results (1-50, default 20)
leagueenum: nhl | pwhl | ohl | whl | qmjhl | echl | ahl | ushloptional
League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.

Notes

  • Over MCP, ask for it in plain English and the client calls get_skater_season_stats itself. Point any MCP client at https://mcp.puckapi.com/mcp?key=YOUR_API_KEY.
  • Each call costs 5 credits, taken before it runs and refunded if the server errors.
  • Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.puckapi.com/v1/get_skater_season_stats \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": "20242025",
  "sort_by": "points",
  "limit": 3
}'

Response

json
{
  "skaters": [
    {
      "playerId": 8476453,
      "playerName": "Nikita Kucherov",
      "team": "TBL",
      "position": "RW",
      "gamesPlayed": 78,
      "goals": 37,
      "assists": 84,
      "points": 121,
      "plusMinus": 22,
      "shots": 265,
      "shootingPct": 0.1396,
      "avgToiPerGame": 1271
    }
  ],
  "count": 1
}

Response fields

skaters[].playerIdinteger
Player ID
skaters[].playerNamestring
Skater name
skaters[].teamstring
Team abbreviation
skaters[].teamNamestring
Full team name
skaters[].positionstring
Position (C, LW, RW, D)
skaters[].gamesPlayedinteger
Games played
skaters[].goalsinteger
Goals
skaters[].assistsinteger
Assists
skaters[].pointsinteger
Points
skaters[].plusMinusinteger
Plus/minus
skaters[].piminteger
Penalty minutes
skaters[].powerPlayGoalsinteger
Power play goals
skaters[].powerPlayPointsinteger
Power play points
skaters[].shorthandedGoalsinteger
Shorthanded goals
skaters[].shorthandedPointsinteger
Shorthanded points
skaters[].gameWinningGoalsinteger
Game-winning goals
skaters[].otGoalsinteger
Overtime goals
skaters[].shotsinteger
Shots on goal
skaters[].shootingPctnumber
Shooting percentage, as a fraction
skaters[].faceoffPctnumber
Faceoff win percentage, as a fraction
skaters[].avgToiPerGameinteger
Average time on ice per game, in SECONDS
skaters[].snapshotDatestring
Date the season snapshot was taken (YYYY-MM-DD)
countinteger
Number of skaters returned
filtersobject
The filters applied, echoed back

Related endpoints

get_player_stats5 cr

Takes the player_id this one returns.

Player bio and goalie stats (if goalie). For skaters, returns bio info and team context.

get_player_game_log5 cr

Takes the player_id this one returns.

A player's game-by-game stat lines for a season: date, opponent, home/away, and the box score for each game.

list_teams1 cr

Returns the team this one takes.

All 32 active NHL teams with divisions, conferences, and arenas.

get_standings2 cr

Returns the team this one takes.

Current standings with points, point pace, goal differential, and 5v5 possession: Corsi%, Fenwick% and expected goals.

Try it

500 free credits every month: 100 calls to get_skater_season_stats, and no card.

Get a free keyAll NHL endpoints