# Yahoo API: Get player stats > 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. Unofficial. Not affiliated with or endorsed by Yahoo. - Page: https://fous.com/methods/sports.yahoo.com/get-player-stats - Method: `sports.yahoo.com/get_player_stats`, version 1 - Website: sports.yahoo.com - Returns: player, team, league, position, age, headshot, season, stats (season and career values), player ID - 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 | |---|---|---|---|---| | `team` | string | no | | Team name to distinguish players, such as Philadelphia 76ers. Default "". | | `league` | string | no | `"NBA"` | League to search, such as NBA. If omitted, searches the main US leagues. Default "". | | `player` | string | yes | `"LeBron James"` | Player name, such as LeBron James. | | `season` | string | no | | Season year or season label, such as 2024 or 2024-25. Defaults to the latest season with statistics. Default "latest". | ## Output From a run on Oct 23, 2026, shortened. Its input: ```json { "league": "NBA", "player": "LeBron James" } ``` Its output: ```json { "age": 41, "team": "Philadelphia 76ers", "stats": [ { "stat_name": "Three-Points Made", "career_value": 2637, "season_value": 1, "stat_abbreviation": "3PM" }, { "stat_name": "Defensive Rebounds Per Game", "career_value": 6.3, "season_value": 8.5, "stat_abbreviation": "DR" }, { "stat_name": "Points", "career_value": 43471, "season_value": 31, "stat_abbreviation": "Pts" } ], "league": "NBA", "player": "LeBron James", "season": "2026-27", "position": "Small Forward, Power Forward", "player_id": "nba.p.3704", "headshot_image_link": "https://s.yimg.com/iu/api/res/1.2/seqKuxPVMBWA3DBzxjLvGg--~B/YXBwaWQ9c2hhcmVkO2ZpPWZpbGw7cT03NTtoPTE2MDt3PTE2MA--/https://s.yimg.com/xe/i/us/sp/v/nba_cutout/players_l/10082026/3704.1.png", "yahoo_sports_player_link": "https://sports.yahoo.com/nba/players/3704/" } ``` ## 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":"sports.yahoo.com/get_player_stats","input":{"league":"NBA","player":"LeBron James"}}' ``` 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 were Stephen Curry's regular season stats for the 2023-24 season, and how do they compare to his career averages? - Can you pull up Victor Wembanyama's season numbers for 2024-25 along with his career totals? - Show me Patrick Mahomes' passing stats for last season plus his career line on yahoo sports. - I need Aaron Judge's 2024 batting stats and career numbers for the Yankees. - Look up Caitlin Clark's latest season statistics with career totals in the WNBA. ## Input schema ```json { "type": "object", "required": [ "player" ], "properties": { "team": { "type": "string", "default": "", "description": "Team name to distinguish players, such as Philadelphia 76ers." }, "league": { "type": "string", "default": "", "description": "League to search, such as NBA. If omitted, searches the main US leagues." }, "player": { "type": "string", "description": "Player name, such as LeBron James." }, "season": { "type": "string", "default": "latest", "description": "Season year or season label, such as 2024 or 2024-25. Defaults to the latest season with statistics." } } } ``` ## Output schema ```json { "type": "object", "required": [ "player", "team", "league", "position", "age", "headshot_image_link", "yahoo_sports_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 } }, "league": { "type": "string" }, "player": { "type": "string" }, "season": { "type": "string" }, "position": { "type": [ "string", "null" ] }, "player_id": { "type": "string", "x-fous-developer": true }, "headshot_image_link": { "type": [ "string", "null" ] }, "yahoo_sports_player_link": { "type": "string" } }, "additionalProperties": false } ``` ## See more - [Yahoo API: Get team standings](https://fous.com/methods/sports.yahoo.com/get-standings.md): Returns Yahoo Sports team standings for a league and season, grouped by division or conference. - [Yahoo API: Get scores](https://fous.com/methods/sports.yahoo.com/get-scores.md): Gets scores and schedules for a league on a date, or for the football week that contains the date. Results can be limited to one team. Venue names come from each game page, for up to 22 games. - [Yahoo API: Get quote](https://fous.com/methods/finance.yahoo.com/get-quote.md): Looks up a stock, fund, index, or cryptocurrency by name or ticker and returns its latest displayed price and key statistics. Unavailable figures are null; quotes may be delayed. - [Yahoo API: Get price history](https://fous.com/methods/finance.yahoo.com/get-price-history.md): Returns Yahoo Finance daily, weekly or monthly price history and total adjusted-close return for a stock, fund, index or cryptocurrency. - [Yahoo API: Get company news](https://fous.com/methods/finance.yahoo.com/get-company-news.md): Looks up a company by name or ticker on Yahoo Finance and returns its latest news headlines, with article summaries when the article page provides one. - [Yahoo API: Read article](https://fous.com/methods/yahoo.com/read-article.md): Reads a public Yahoo News article from its link or headline and returns its text and details. Headline matching uses Yahoo News search results. - [Yahoo API: Get analyst ratings](https://fous.com/methods/finance.yahoo.com/get-analyst-ratings.md): Shows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance. - [Yahoo API: Get earnings calendar](https://fous.com/methods/finance.yahoo.com/get-earnings-calendar.md): Gets earnings reports for a date range, or the upcoming reports and up to four previous reports for one company. - [All Yahoo methods](https://fous.com/methods/yahoo.com.md)