# NFL API: Get player stats > Gets a named NFL player's season and career stats, with profile details. Active players are preferred when names match. Unofficial. Not affiliated with or endorsed by NFL. - Page: https://fous.com/methods/nfl.com/get-player-stats - Method: `nfl.com/get_player_stats`, version 1 - Website: nfl.com - Returns: name, team, position, jersey number, headshot, 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 | `"Josh Allen"` | Player name, for example Josh Allen. | | `season` | integer | no | | Season starting year, for example 2025. Defaults to the latest season shown. | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "player": "Josh Allen" } ``` Its output: ```json { "name": "Josh Allen", "team": "Buffalo Bills", "stats": [ { "group": "passing", "stat_name": "Completions", "career_value": 2729, "season_value": 114, "stat_abbreviation": "COMP" }, { "group": "passing", "stat_name": "Passing attempts", "career_value": 4259, "season_value": 171, "stat_abbreviation": "ATT" }, { "group": "passing", "stat_name": "Passing yards", "career_value": 31606, "season_value": 1504, "stat_abbreviation": "YDS" } ], "season": 2026, "position": "QB", "player_id": "josh-allen", "player_link": "https://www.nfl.com/players/josh-allen/", "jersey_number": 17, "headshot_image_link": "https://static.www.nfl.com/image/upload/t_player_profile_landscape/t_lazy/f_auto/league/ynrhq9iv30ysjpwmrfdv" } ``` ## 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":"nfl.com/get_player_stats","input":{"player":"Josh Allen"}}' ``` 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 - What are Patrick Mahomes' passing stats for the 2024 season? - Show me Christian McCaffrey's career rushing totals and his jersey number. - how many touchdowns did Lamar Jackson throw in 2023 - Get the profile and season stats for CeeDee Lamb on nfl.com. - Which team does Travis Kelce play for, and what were his receiving yards in 2022? ## Input schema ```json { "type": "object", "required": [ "player" ], "properties": { "player": { "type": "string", "minLength": 1, "description": "Player name, for example Josh Allen." }, "season": { "type": "integer", "description": "Season starting year, for example 2025. Defaults to the latest season shown." } } } ``` ## Output schema ```json { "type": "object", "required": [ "name", "team", "position", "jersey_number", "headshot_image_link", "player_link", "season", "stats", "player_id" ], "properties": { "name": { "type": "string" }, "team": { "type": [ "string", "null" ] }, "stats": { "type": "array", "items": { "type": "object", "required": [ "group", "stat_name", "season_value", "career_value", "stat_abbreviation" ], "properties": { "group": { "type": "string" }, "stat_name": { "type": "string" }, "career_value": { "type": "number" }, "season_value": { "type": [ "number", "null" ] }, "stat_abbreviation": { "type": "string", "x-fous-developer": true } }, "additionalProperties": false } }, "season": { "type": [ "integer", "null" ] }, "position": { "type": [ "string", "null" ] }, "player_id": { "type": "string", "description": "NFL player profile slug.", "x-fous-developer": true }, "player_link": { "type": "string" }, "jersey_number": { "type": [ "integer", "null" ] }, "headshot_image_link": { "type": [ "string", "null" ] } } } ``` ## See more - [NFL API: Get standings](https://fous.com/methods/nfl.com/get-standings.md): Gets NFL regular-season standings by conference and division for a season, with clinch status when shown. - [NFL API: Get team roster](https://fous.com/methods/nfl.com/get-team-roster.md): Gets an NFL team's current NFL.com roster by team name, nickname or city. You can limit it to offense, defense or special teams. Released players are left out. - [NFL API: Get scores](https://fous.com/methods/nfl.com/get-scores.md): Gets NFL scores and scheduled games for the week that contains a date. You can keep only one team's games. Kickoff times are in US Eastern time unless you choose another time zone. - [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. - [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. - [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. - [All NFL methods](https://fous.com/methods/nfl.com.md)