# NBA API: Get player by name > 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. Unofficial. Not affiliated with or endorsed by NBA. - Page: https://fous.com/methods/nba.com/get-player - Method: `nba.com/get_player`, version 1 - Website: nba.com - Returns: name, team, jersey number, position, height, weight, age, draft, college, season and career averages - 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 | `"Stephen Curry"` | NBA player name, such as Stephen Curry. | ## Output From a run on Oct 23, 2026. Its input: ```json { "player": "Stephen Curry" } ``` Its output: ```json { "age": 38, "name": "Stephen Curry", "team": "Golden State Warriors", "draft": "2009 Round 1, Pick 7", "height": "6 ft 2 in", "season": "2026-27", "country": "USA", "position": "Guard", "height_cm": 188, "player_url": "https://www.nba.com/player/201939/stephen-curry", "date_of_birth": "1988-03-14", "jersey_number": "30", "nba_player_id": 201939, "weight_pounds": 205, "career_averages": { "blocks": 0.3, "points": 24.8, "steals": 1.5, "assists": 6.3, "minutes": 33.9, "rebounds": 4.6, "games_played": 1070, "field_goal_percentage": 47.1, "free_throw_percentage": 91.2, "three_point_percentage": 42.2 }, "season_averages": { "blocks": 0, "points": 23, "steals": 2, "assists": 1, "minutes": 21, "rebounds": 2, "games_played": 1, "field_goal_percentage": 46.7, "free_throw_percentage": 100, "three_point_percentage": 28.6 }, "years_in_league": 17, "headshot_image_url": "https://cdn.nba.com/headshots/nba/latest/1040x760/201939.png", "college_or_last_club": "Davidson" } ``` ## 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":"nba.com/get_player","input":{"player":"Stephen Curry"}}' ``` 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 LeBron James' career per-game averages and bio details like height and draft year? - Look up Kobe Bryant's jersey number, college, and season averages from his playing days - Can you find the position, weight, and team history for Dirk Nowitzki on nba.com? - I need Allen Iverson's draft info and career scoring average per game - Show me the current season stats and age for Jayson Tatum ## Input schema ```json { "type": "object", "required": [ "player" ], "properties": { "player": { "type": "string", "description": "NBA player name, such as Stephen Curry." } } } ``` ## Output schema ```json { "type": "object", "required": [ "name", "team", "jersey_number", "position", "height", "height_cm", "weight_pounds", "age", "date_of_birth", "country", "college_or_last_club", "draft", "years_in_league", "headshot_image_url", "player_url", "season", "nba_player_id", "season_averages", "career_averages" ], "properties": { "age": { "type": [ "integer", "null" ], "description": "Age in years." }, "name": { "type": [ "string", "null" ], "description": "Player's full name." }, "team": { "type": [ "string", "null" ], "description": "Team shown on the NBA player profile." }, "draft": { "type": [ "string", "null" ], "description": "Draft year, round and overall pick." }, "height": { "type": [ "string", "null" ], "description": "Height in feet and inches." }, "season": { "type": [ "string", "null" ], "description": "Season associated with the season averages, such as 2025-26." }, "country": { "type": [ "string", "null" ], "description": "Country." }, "position": { "type": [ "string", "null" ], "description": "Playing position." }, "height_cm": { "type": [ "number", "null" ], "description": "Height in centimeters." }, "player_url": { "type": [ "string", "null" ], "description": "NBA player page link." }, "date_of_birth": { "type": [ "string", "null" ], "description": "Birth date in YYYY-MM-DD format." }, "jersey_number": { "type": [ "string", "null" ], "description": "Jersey number, preserving leading zeros." }, "nba_player_id": { "type": "integer", "description": "NBA player identifier.", "x-fous-developer": true }, "weight_pounds": { "type": [ "integer", "null" ], "description": "Weight in pounds." }, "career_averages": { "type": [ "object", "null" ], "properties": { "blocks": { "type": [ "number", "null" ], "description": "Blocks per game." }, "points": { "type": [ "number", "null" ], "description": "Points per game." }, "steals": { "type": [ "number", "null" ], "description": "Steals per game." }, "assists": { "type": [ "number", "null" ], "description": "Assists per game." }, "minutes": { "type": [ "number", "null" ], "description": "Minutes per game." }, "rebounds": { "type": [ "number", "null" ], "description": "Rebounds per game." }, "games_played": { "type": [ "integer", "null" ], "description": "Regular-season games played." }, "field_goal_percentage": { "type": [ "number", "null" ], "description": "Field goal percentage, from 0 to 100." }, "free_throw_percentage": { "type": [ "number", "null" ], "description": "Free throw percentage, from 0 to 100." }, "three_point_percentage": { "type": [ "number", "null" ], "description": "Three-point percentage, from 0 to 100." } }, "description": "Career regular-season per-game averages, or null if unavailable.", "additionalProperties": false }, "season_averages": { "type": [ "object", "null" ], "properties": { "blocks": { "type": [ "number", "null" ], "description": "Blocks per game." }, "points": { "type": [ "number", "null" ], "description": "Points per game." }, "steals": { "type": [ "number", "null" ], "description": "Steals per game." }, "assists": { "type": [ "number", "null" ], "description": "Assists per game." }, "minutes": { "type": [ "number", "null" ], "description": "Minutes per game." }, "rebounds": { "type": [ "number", "null" ], "description": "Rebounds per game." }, "games_played": { "type": [ "integer", "null" ], "description": "Regular-season games played." }, "field_goal_percentage": { "type": [ "number", "null" ], "description": "Field goal percentage, from 0 to 100." }, "free_throw_percentage": { "type": [ "number", "null" ], "description": "Free throw percentage, from 0 to 100." }, "three_point_percentage": { "type": [ "number", "null" ], "description": "Three-point percentage, from 0 to 100." } }, "description": "Regular-season per-game averages for the reported season, or null if unavailable.", "additionalProperties": false }, "years_in_league": { "type": [ "integer", "null" ], "description": "NBA seasons of experience." }, "headshot_image_url": { "type": [ "string", "null" ], "description": "NBA headshot image link." }, "college_or_last_club": { "type": [ "string", "null" ], "description": "College or last club." } }, "additionalProperties": false } ``` ## See more - [NBA API: Get box score](https://fous.com/methods/nba.com/get-box-score.md): Returns the NBA box score for a game between two teams on a date; without a date, their most recent matchup, including Summer League and games in progress. - [NBA API: Get scores](https://fous.com/methods/nba.com/get-scores.md): Gets NBA games for a date or up to seven days, using the NBA games calendar in US Eastern time. Each game has its score, status, start time, TV channels and venue. - [NBA API: Get standings](https://fous.com/methods/nba.com/get-standings.md): Returns NBA regular-season standings for a season, with Eastern and Western Conference teams in rank order. Defaults to the season shown on the NBA standings page. - [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. - [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. - [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. - [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. - [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. - [All NBA methods](https://fous.com/methods/nba.com.md)