# SofaScore API: Get player season stats > Gets a football player's season statistics on SofaScore by name, with an optional competition and season (defaults: the player's main league and the current season). Unavailable statistics are null. Unofficial. Not affiliated with or endorsed by SofaScore. - Page: https://fous.com/methods/sofascore.com/get-player-season-stats - Method: `sofascore.com/get_player_season_stats`, version 1 - Website: sofascore.com - Returns: player, team, position, nationality, age, competition, season, appearances, starts, minutes, goals, assists, xG, rating, cards, saves, clean sheets - 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 | `"Erling Haaland"` | Football player name, for example Erling Haaland. | | `season` | string | no | `"2025/26"` | Season, for example 2025/26. Defaults to the current season. Default "". | | `competition` | string | no | `"Premier League"` | Competition name, for example Premier League. Defaults to the player's main league. Default "". | ## Output From a run on Oct 31, 2026. Its input: ```json { "player": "Erling Haaland", "season": "2025/26", "competition": "Premier League" } ``` Its output: ```json { "age": 26, "team": "Manchester City", "goals": 27, "saves": null, "player": "Erling Haaland", "season": "2025/26", "starts": 34, "assists": 8, "position": "Forward", "player_id": 839956, "red_cards": 0, "appearances": 35, "competition": "Premier League", "nationality": "Norway", "clean_sheets": null, "yellow_cards": 2, "expected_goals": 25.4326, "minutes_played": 2958, "sofascore_link": "https://www.sofascore.com/football/player/erling-haaland/839956", "photo_image_link": "https://img.sofascore.com/api/v1/player/839956/image", "average_sofascore_rating": 7.3114285714286 } ``` ## 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":"sofascore.com/get_player_season_stats","input":{"player":"Erling Haaland","season":"2025/26","competition":"Premier League"}}' ``` 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 and assists does Bukayo Saka have in the Premier League this season, and what's his average rating? - Pull Jude Bellingham's 2023/24 La Liga numbers from SofaScore: appearances, minutes, xG, and cards. - I need clean sheets and saves for Gianluigi Donnarumma in the Champions League 2024/25. - Check SofaScore for Lamine Yamal's current season stats — starts, goals, assists, rating. - What were Victor Osimhen's Serie A stats in 2022/23? Goals, xG, minutes played and yellow/red cards. ## Input schema ```json { "type": "object", "required": [ "player" ], "properties": { "player": { "type": "string", "minLength": 1, "description": "Football player name, for example Erling Haaland." }, "season": { "type": "string", "default": "", "description": "Season, for example 2025/26. Defaults to the current season." }, "competition": { "type": "string", "default": "", "description": "Competition name, for example Premier League. Defaults to the player's main league." } } } ``` ## Output schema ```json { "type": "object", "required": [ "player", "team", "position", "nationality", "age", "photo_image_link", "sofascore_link", "competition", "season", "appearances", "starts", "minutes_played", "goals", "assists", "expected_goals", "average_sofascore_rating", "yellow_cards", "red_cards", "saves", "clean_sheets", "player_id" ], "properties": { "age": { "type": [ "integer", "null" ], "description": "Age in years." }, "team": { "type": [ "string", "null" ], "description": "Team for this competition and season." }, "goals": { "type": [ "integer", "null" ], "description": "Goals." }, "saves": { "type": [ "integer", "null" ], "description": "Saves for goalkeepers." }, "player": { "type": [ "string", "null" ], "description": "Player name." }, "season": { "type": [ "string", "null" ], "description": "Season used." }, "starts": { "type": [ "integer", "null" ], "description": "Matches started." }, "assists": { "type": [ "integer", "null" ], "description": "Assists." }, "position": { "type": [ "string", "null" ], "description": "Playing position." }, "player_id": { "type": [ "integer", "null" ], "description": "SofaScore player ID." }, "red_cards": { "type": [ "integer", "null" ], "description": "Red cards." }, "appearances": { "type": [ "integer", "null" ], "description": "Appearances in the season." }, "competition": { "type": [ "string", "null" ], "description": "Competition used." }, "nationality": { "type": [ "string", "null" ], "description": "Country of nationality." }, "clean_sheets": { "type": [ "integer", "null" ], "description": "Clean sheets for goalkeepers." }, "yellow_cards": { "type": [ "integer", "null" ], "description": "Yellow cards." }, "expected_goals": { "type": [ "number", "null" ], "description": "Expected goals." }, "minutes_played": { "type": [ "integer", "null" ], "description": "Minutes played." }, "sofascore_link": { "type": [ "string", "null" ], "description": "Player page link on SofaScore." }, "photo_image_link": { "type": [ "string", "null" ], "description": "Player photo image link." }, "average_sofascore_rating": { "type": [ "number", "null" ], "description": "Average SofaScore rating from 0 to 10." } } } ``` ## See more - [SofaScore API: Get football match](https://fous.com/methods/sofascore.com/get-match.md): Finds a football match between two teams on SofaScore (on a given date, or their latest played or live match) and returns its score, goals, red cards, team statistics and player ratings. - [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. - [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. - [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. - [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. - [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. - [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. - [All SofaScore methods](https://fous.com/methods/sofascore.com.md)