# ESPN API: Get player stats > 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. Unofficial. Not affiliated with or endorsed by ESPN. - Page: https://fous.com/methods/espn.com/get-player-stats - Method: `espn.com/get_player_stats`, version 1 - Website: espn.com - Returns: player profile, season and 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 | |---|---|---|---|---| | `league` | string | no | | League to distinguish players with the same name, for example NFL. Default "". | | `player` | string | yes | `"Patrick Mahomes"` | Player name, for example Patrick Mahomes. | | `season` | string | no | | Season year or season label, for example 2024 or 2024-25. Defaults to the latest available season. Default "". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "player": "Patrick Mahomes" } ``` Its output: ```json { "age": 31, "team": "Kansas City Chiefs", "stats": [ { "stat_name": "Games Played", "career_value": 131, "season_value": 5, "stat_abbreviation": "GP" }, { "stat_name": "Completions", "career_value": 3198, "season_value": 105, "stat_abbreviation": "CMP" }, { "stat_name": "Passing Attempts", "career_value": 4831, "season_value": 158, "stat_abbreviation": "ATT" } ], "height": "6' 2\"", "league": "NFL", "season": "2026", "weight": "225 lbs", "position": "Quarterback", "player_id": "3139477", "player_name": "Patrick Mahomes", "jersey_number": "15", "espn_player_link": "https://www.espn.com/nfl/player/_/id/3139477/patrick-mahomes", "headshot_image_link": "https://a.espncdn.com/i/headshots/nfl/players/full/3139477.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":"espn.com/get_player_stats","input":{"player":"Patrick Mahomes"}}' ``` 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 - Can you pull up Patrick Mahomes' stats from the 2023 NFL season on ESPN? - I need LeBron James' career averages and this season's numbers, plus his profile info. - Look up Stephen Curry's 2024-25 NBA stats and tell me his career totals. - What were Justin Jefferson's receiving stats in 2022 in the NFL? Include career numbers too. - Find the MLB player Shohei Ohtani on espn.com and show his latest season and career stats. ## Input schema ```json { "type": "object", "required": [ "player" ], "properties": { "league": { "type": "string", "default": "", "description": "League to distinguish players with the same name, for example NFL." }, "player": { "type": "string", "description": "Player name, for example Patrick Mahomes." }, "season": { "type": "string", "default": "", "description": "Season year or season label, for example 2024 or 2024-25. Defaults to the latest available season." } } } ``` ## Output schema ```json { "type": "object", "required": [ "player_name", "team", "league", "position", "jersey_number", "age", "height", "weight", "headshot_image_link", "espn_player_link", "season", "stats", "player_id" ], "properties": { "age": { "type": [ "integer", "null" ] }, "team": { "type": [ "string", "null" ] }, "stats": { "type": "array", "items": { "type": "object", "required": [ "stat_name", "season_value", "career_value", "stat_abbreviation" ], "properties": { "stat_name": { "type": "string" }, "career_value": { "type": "number" }, "season_value": { "type": "number" }, "stat_abbreviation": { "type": [ "string", "null" ], "x-fous-developer": true } }, "additionalProperties": false } }, "height": { "type": [ "string", "null" ] }, "league": { "type": "string" }, "season": { "type": "string" }, "weight": { "type": [ "string", "null" ] }, "position": { "type": [ "string", "null" ] }, "player_id": { "type": "string", "x-fous-developer": true }, "player_name": { "type": "string" }, "jersey_number": { "type": [ "string", "null" ] }, "espn_player_link": { "type": "string" }, "headshot_image_link": { "type": [ "string", "null" ] } }, "additionalProperties": false } ``` ## See more - [ESPN API: Get game summary](https://fous.com/methods/espn.com/get-game-summary.md): Finds the latest game between two teams, or their game on a given date, in major US leagues, MLS or the EPL. Returns the score, scoring by period, leading players, team stats and player box scores. - [ESPN API: Get team schedule](https://fous.com/methods/espn.com/get-team-schedule.md): Returns a team's past results and upcoming games for a season on ESPN, with opponents, local start times, scores, broadcasts and venues. Soccer fixtures include all competitions shown for the team. - [ESPN API: Get scores](https://fous.com/methods/espn.com/get-scores.md): Gets ESPN scores and the schedule for a league on a local day. You can filter by team, and start times are shown in your time zone. - [ESPN API: List news for a league or team](https://fous.com/methods/espn.com/list-news.md): Finds an ESPN league or team by name and lists the latest headlines ESPN publishes for it, newest first. - [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. - [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. - [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. - [All ESPN methods](https://fous.com/methods/espn.com.md)