# NHL API: Get player stats > Looks up an NHL player by name, link or ID and returns the profile with regular-season stats for a season and career totals. Unofficial. Not affiliated with or endorsed by NHL. - Page: https://fous.com/methods/nhl.com/get-player-stats - Method: `nhl.com/get_player_stats`, version 1 - Website: nhl.com - Returns: name, team, position, age, country, season_stats, career_stats - 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 | |---|---|---|---|---| | `player` | string | yes | `"Connor McDavid"` | Player name, NHL player link, or player ID, e.g. Connor McDavid. | | `season` | integer | no | `2025` | Starting year of the season, e.g. 2025 for 2025-26. Omit for latest season with recorded games. | ## Output From a run on Oct 23, 2026. Its input: ```json { "player": "Connor McDavid", "season": 2025 } ``` Its output: ```json { "age": 29, "name": "Connor McDavid", "team": "Edmonton Oilers", "season": "2025-26", "country": "Canada", "position": "Center", "player_id": 8478402, "player_link": "https://www.nhl.com/player/connor-mcdavid-8478402", "career_stats": { "wins": null, "goals": 417, "losses": null, "points": 1251, "assists": 834, "shutouts": null, "plus_minus": 204, "games_played": 804, "penalty_minutes": 332, "save_percentage": null, "goals_against_average": null }, "season_stats": { "wins": null, "goals": 48, "losses": null, "points": 138, "assists": 90, "shutouts": null, "plus_minus": 17, "games_played": 82, "penalty_minutes": 44, "save_percentage": null, "goals_against_average": null }, "jersey_number": 97, "shoots_or_catches": "Left", "headshot_image_link": "https://assets.nhle.com/mugs/nhl/20262027/EDM/8478402.png" } ``` ## 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":"nhl.com/get_player_stats","input":{"player":"Connor McDavid","season":2025}}' ``` 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 - How many goals did Connor McDavid score in the 2024-25 season, and what are his career totals? - Show me Nathan MacKinnon's regular season stats for 2023-24 along with his career numbers on nhl.com. - What team does Auston Matthews play for, what position is he, and how old is he? - Pull up Cale Makar's profile with his season stats for 2025 and career totals. - Get the player profile for player ID 8478402 including country of birth and points for the 2022 season. ## Input schema ```json { "type": "object", "required": [ "player" ], "properties": { "player": { "type": "string", "description": "Player name, NHL player link, or player ID, e.g. Connor McDavid." }, "season": { "type": "integer", "description": "Starting year of the season, e.g. 2025 for 2025-26. Omit for latest season with recorded games." } } } ``` ## Output schema ```json { "type": "object", "required": [ "name", "team", "position", "shoots_or_catches", "jersey_number", "age", "country", "headshot_image_link", "player_link", "player_id", "season", "season_stats", "career_stats" ], "properties": { "age": { "type": [ "integer", "null" ], "description": "Age in years today." }, "name": { "type": "string", "description": "Player name." }, "team": { "type": [ "string", "null" ], "description": "Current NHL team, or most recent NHL team if no longer active." }, "season": { "type": "string", "description": "Selected NHL season, such as 2025-26." }, "country": { "type": [ "string", "null" ], "description": "Country of birth." }, "position": { "type": [ "string", "null" ], "description": "Playing position." }, "player_id": { "type": "integer", "description": "NHL player ID.", "x-fous-developer": true }, "player_link": { "type": "string", "description": "NHL player page." }, "career_stats": { "type": "object", "required": [ "games_played", "goals", "assists", "points", "plus_minus", "penalty_minutes", "wins", "losses", "save_percentage", "goals_against_average", "shutouts" ], "properties": { "wins": { "type": [ "integer", "null" ], "description": "NHL regular-season wins." }, "goals": { "type": [ "integer", "null" ], "description": "NHL regular-season goals." }, "losses": { "type": [ "integer", "null" ], "description": "NHL regular-season losses." }, "points": { "type": [ "integer", "null" ], "description": "NHL regular-season points." }, "assists": { "type": [ "integer", "null" ], "description": "NHL regular-season assists." }, "shutouts": { "type": [ "integer", "null" ], "description": "NHL regular-season shutouts." }, "plus_minus": { "type": [ "integer", "null" ], "description": "NHL regular-season plus minus." }, "games_played": { "type": [ "integer", "null" ], "description": "NHL regular-season games played." }, "penalty_minutes": { "type": [ "integer", "null" ], "description": "NHL regular-season penalty minutes." }, "save_percentage": { "type": [ "number", "null" ], "description": "NHL regular-season save percentage." }, "goals_against_average": { "type": [ "number", "null" ], "description": "NHL regular-season goals against average." } }, "description": "NHL regular-season career totals." }, "season_stats": { "type": "object", "required": [ "games_played", "goals", "assists", "points", "plus_minus", "penalty_minutes", "wins", "losses", "save_percentage", "goals_against_average", "shutouts" ], "properties": { "wins": { "type": [ "integer", "null" ], "description": "NHL regular-season wins." }, "goals": { "type": [ "integer", "null" ], "description": "NHL regular-season goals." }, "losses": { "type": [ "integer", "null" ], "description": "NHL regular-season losses." }, "points": { "type": [ "integer", "null" ], "description": "NHL regular-season points." }, "assists": { "type": [ "integer", "null" ], "description": "NHL regular-season assists." }, "shutouts": { "type": [ "integer", "null" ], "description": "NHL regular-season shutouts." }, "plus_minus": { "type": [ "integer", "null" ], "description": "NHL regular-season plus minus." }, "games_played": { "type": [ "integer", "null" ], "description": "NHL regular-season games played." }, "penalty_minutes": { "type": [ "integer", "null" ], "description": "NHL regular-season penalty minutes." }, "save_percentage": { "type": [ "number", "null" ], "description": "NHL regular-season save percentage." }, "goals_against_average": { "type": [ "number", "null" ], "description": "NHL regular-season goals against average." } }, "description": "NHL regular-season statistics across all teams in this season." }, "jersey_number": { "type": [ "integer", "null" ], "description": "Jersey number." }, "shoots_or_catches": { "type": [ "string", "null" ], "description": "Shoots or catches left or right." }, "headshot_image_link": { "type": [ "string", "null" ], "description": "Player headshot image link." } } } ``` ## See more - [NHL API: Get scores](https://fous.com/methods/nhl.com/get-scores.md): Lists NHL games for a date, optionally limited to one team, with start times in the chosen time zone, scores, status, and TV networks. - [NHL API: Get standings](https://fous.com/methods/nhl.com/get-standings.md): Gets NHL standings as of a date, ordered by conference, division and division rank, with each team's official homepage. - [NFL API: Get player stats](https://fous.com/methods/nfl.com/get-player-stats.md): Gets a named NFL player's season and career stats, with profile details. Active players are preferred when names match. - [MLB API: Get player stats](https://fous.com/methods/mlb.com/get-player-stats.md): Gets an MLB player's profile and regular-season hitting and pitching statistics for one season and for his career. Without a season it uses the current season, or the player's latest MLB season if he has no stats this year. - [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. - [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. - [Premier League API: Get player stats](https://fous.com/methods/premierleague.com/get-player-stats.md): Looks up a Premier League player by name and returns the profile and either career totals or the stats for a chosen season. If names clash, a current Premier League player is preferred. - [NBA API: Get player by name](https://fous.com/methods/nba.com/get-player.md): Looks up an NBA player by name, including retired players, and returns the bio and regular-season per-game averages for the reported season and career. - [All NHL methods](https://fous.com/methods/nhl.com.md)