**Important notice**: This API version will be deprecated on RapidAPI in February 2026 and will no longer be accessible after this date. To continue using the API without interruption, please migrate to our official dashboard: [https://dashboard.api-football.com](https://dashboard.api-football.com) ## An NBA API for Live Basketball Stats Review the https://rapidapi.com/api-sports/api/api-nba NBA API docs and learn https://blog.rapidapi.com/nba-basketball-stats-api how to use the API. # Free Plan Free plan is only available on our [dashboard](https://dashboard.api-football.com/). # More Plans If you want a plan with more requests, visit our [dashboard](https://dashboard.api-football.com/), Plans up to 1.5M requests per day are available. ## ARCHITECTURE ![](https://www.api-football.com/public/img/news/archi-nba.jpg) ## DOCUMENTATION Seasons ======= All `{season}` can be used in other endpoints as filters ### Parameters This endpoint does not require any parameters ### Requests #### `GET` All Get all available `{season}` ``` php get("https://api-nba-v1.p.rapidapi.com/seasons/"); ``` ### Response Model ``` json { "api": { "status": 200, "message": "GET seasons/", "results": 5, "filters": [], "seasons": [ "2015", "2016", "2017", "2018", "2019" ] } } ``` Leagues ======= All `{leagues}` can be used in other endpoints as filters ### Parameters This endpoint does not require any parameters ### Requests #### `GET` All Get all available `{leagues}` ``` php get("https://api-nba-v1.p.rapidapi.com/leagues/"); ``` ### Response Model ``` json { "api": { "status": 200, "message": "GET leagues/", "results": 6, "filters": [], "leagues": [ "africa", "orlando", "sacramento", "standard", "utah", "vegas" ] } } ``` Teams ======= The team `{id}` are unique in the API ### Parameters

Parameter	Type	Required	Description
teamId	integer	true	Fails if field contains anything other than an integer
league	string	true	Fails if field contains anything other than alpha-numeric characters
city	string	true	Fails if field contains anything other than alpha-numeric characters
shortName	string	true	Fails if field contains anything other than alpha-numeric characters
nickName	string	true	Fails if field contains anything other than alpha-numeric characters
confName	string	true	Fails if field contains anything other than alpha-numeric characters
divName	string	true	Fails if field contains anything other than alpha-numeric characters

### Requests #### `GET` By teamId Get one team from one team `{teamId}` ``` php get("https://api-nba-v1.p.rapidapi.com/teams/teamId/1"); ``` #### `GET` By league Get one team from one team `{league}` ``` php get("https://api-nba-v1.p.rapidapi.com/teams/league/standard"); ``` #### `GET` By city Get all teams from one `{city}` ``` php get("https://api-nba-v1.p.rapidapi.com/teams/city/Atlanta"); ``` #### `GET` By shortName Get one team from one `{shortName}` ``` php get("https://api-nba-v1.p.rapidapi.com/teams/shortName/ATL"); ``` #### `GET` By nickName Get one team from one `{nickName}` ``` php get("https://api-nba-v1.p.rapidapi.com/teams/nickName/Hawks"); ``` #### `GET` By confName Get all teams from one `{confName}` ``` php get("https://api-nba-v1.p.rapidapi.com/teams/confName/East"); ``` #### `GET` By divName Get all teams from one `{divName}` ``` php get("https://api-nba-v1.p.rapidapi.com/teams/divName/Southeast"); ``` ### Response Model ``` json { "api": { "status": 200, "message": "GET teams/teamId/1", "results": 1, "filters": [ "teamId", "league", "city", "shortName", "nickName", "confName", "divName" ], "teams": [ { "city": "Atlanta", "fullName": "Atlanta Hawks", "teamId": 1, "nickname": "Hawks", "logo": "https://upload.wikimedia.org/wikipedia/fr/e/ee/Hawks_2016.png", "shortName": "ATL", "allStar": 0, "nbaFranchise": 1, "leagues": { "standard": { "confName": "East", "divName": "Southeast" }, "vegas": { "confName": "summer", "divName": null }, "utah": { "confName": "Utah", "divName": null } } } ] } } ``` Standings ======= ### Parameters

Parameter	Type	Required	Description
league	integer	true	Fails if field contains anything other than an integer
season	integer	true	Fails if field contains anything other than an integer [YYYY]
teamId	integer	false	Fails if field contains anything other than an integer
conference	string	false	Fails if field contains anything other than alpha-numeric characters
division	string	false	Fails if field contains anything other than alpha-numeric characters

### Requests #### `GET` By league Get all Standings from one `{league}` & `{season}` ``` php get("https://api-nba-v1.p.rapidapi.com/standings/standard/2019"); ``` #### `GET` By league & teamId Get all Standings from one `{league}` & `{season}` & `{teamId}` ``` php get("https://api-nba-v1.p.rapidapi.com/standings/standard/2019/teamId/1"); ``` #### `GET` By league & conference Get all Standings from one `{league}` & `{season}` & `{conference}` ``` php get("https://api-nba-v1.p.rapidapi.com/standings/standard/2019/conference/east"); ``` #### `GET` By league & division Get all Standings from one `{league}` & `{season}` & `{division}` ``` php get("https://api-nba-v1.p.rapidapi.com/standings/standard/2019/division/southeast"); ``` ### Response Model ``` json { "api": { "status": 200, "message": "GET standings/standard/2019", "results": 30, "filters": [ "conference", "division", "teamId" ], "standings": [ { "league": "standard", "teamId": 26, "win": 7, "loss": 10, "gamesBehind": "7.5", "lastTenWin": 5, "lastTenLoss": 5, "streak": 1, "seasonYear": 2019, "conference": { "name": "east", "rank": 8, "win": 5, "loss": 7 }, "division": { "name": "southeast", "rank": 2, "win": 1, "loss": 1, "GamesBehind": "5.0" }, "winPercentage": ".412", "lossPercentage": ".588", "home": { "win": 6, "loss": 3 }, "away": { "win": 1, "loss": 7 }, "winStreak": 1, "tieBreakerPoints": null } ] } } ``` Games ======= games ------- ### Parameters

Parameter	Type	Required	Description
gameId	integer	true	Fails if field contains anything other than an integer
date	string	true	Fails if field contains anything other than a valid date [YYYY-MM-DD]
live	none	false
teamId	integer	true	Fails if field contains anything other than an integer
season	integer	true	Fails if field contains anything other than an integer [YYYY]
league	string	true	Fails if field contains anything other than alpha-numeric characters
league	string	true	Fails if field contains anything other than alpha-numeric characters

### Requests #### `GET` By gameId Get games from one game `{gameId}` ``` php get("https://api-nba-v1.p.rapidapi.com/games/gameId/6642"); ``` #### `GET` By live Get all available games in play ``` php get("https://api-nba-v1.p.rapidapi.com/games/live/"); ``` #### `GET` By league Get all available games from one `{league}` & `{season}` ``` php get("https://api-nba-v1.p.rapidapi.com/games/league/standard/2019"); ``` #### `GET` By teamId Get all available games from one `{teamId}` ``` php get("https://api-nba-v1.p.rapidapi.com/games/teamId/1"); ``` #### `GET` By date Get all available games from one `{date}` ``` php get("https://api-nba-v1.p.rapidapi.com/games/date/2019-11-28"); ``` ### Response Model ```json { "api": { "status": 200, "message": "GET games/gameId/6642", "results": 1, "filters": [ "seasonYear", "league", "gameId", "teamId", "date", "live" ], "games": [ { "seasonYear": "2019", "league": "standard", "gameId": "6642", "startTimeUTC": "2019-11-28T00:00:00.000Z", "endTimeUTC": "2019-11-28T02:43:00.000Z", "arena": "TD Garden", "city": "Boston", "country": "USA", "clock": "", "gameDuration": "2:15", "currentPeriod": "4/4", "halftime": "0", "EndOfPeriod": "0", "seasonStage": "2", "statusShortGame": "3", "statusGame": "Finished", "vTeam": { "teamId": "4", "shortName": "BKN", "fullName": "Brooklyn Nets", "nickName": "Nets", "logo": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/44/Brooklyn_Nets_newlogo.svg/130pxBrooklyn_Nets_newlogo.svg.png", "score": { "points": "110" } }, "hTeam": { "teamId": "2", "shortName": "BOS", "fullName": "Boston Celtics", "nickName": "Celtics", "logo": "https://upload.wikimedia.org/wikipedia/fr/thumb/6/65/Celtics_de_Boston_logo.svg/1024px-Celtics_de_Boston_logo.svg.png", "score": { "points": "121" } } } ] } } ``` games details ------- ### Parameters

Parameter	Type	Required	Description
gameId	integer	false	Fails if field contains anything other than an integer

### Requests #### `GET` By gameId Get details from one game `{gameId}` ``` php get("https://api-nba-v1.p.rapidapi.com/gameDetails/6642"); ``` ### Response Model ```json { "api": { "status": 200, "message": "GET gameDetails/6642", "results": 1, "filters": [ "" ], "game": [ { "seasonYear": "2019", "league": "standard", "gameId": "6642", "startTimeUTC": "2019-11-28T00:00:00.000Z", "endTimeUTC": "2019-11-28T02:43:00.000Z", "arena": "TD Garden", "city": "Boston", "country": "USA", "clock": "", "gameDuration": "2:15", "timesTied": "", "leadChanges": "", "currentPeriod": "4/4", "halftime": "0", "EndOfPeriod": "0", "seasonStage": "2", "statusShortGame": "3", "statusGame": "Finished", "vTeam": { "fullName": "Brooklyn Nets", "teamId": "4", "nickname": "Nets", "logo": "https://upload.wikimedia.org/wikipedia/commons/thumb/4/44/Brooklyn_Nets_newlogo.svg/130pxBrooklyn_Nets_newlogo.svg.png", "shortName": "BKN", "allStar": "0", "nbaFranchise": "1", "score": { "win": "9", "loss": "9", "seriesWin": "0", "seriesLoss": "1", "linescore": [ "23", "40", "23", "24" ], "points": "110" }, "leaders": [ { "points": "7", "playerId": "727", "name": "Jarrett Allen" }, { "rebounds": "14", "playerId": "727", "name": "Jarrett Allen" }, { "assists": "11", "playerId": "142", "name": "Spencer Dinwiddie" }, { "points": "22", "playerId": "507", "name": "Garrett Temple" }, { "assists": "4", "playerId": "1013", "name": "Theo Pinson" } ] }, "hTeam": { "fullName": "Boston Celtics", "teamId": "2", "nickname": "Celtics", "logo": "https://upload.wikimedia.org/wikipedia/fr/thumb/6/65/Celtics_de_Boston_logo.svg/1024px-Celtics_de_Boston_logo.svg.png", "shortName": "BOS", "allStar": "0", "nbaFranchise": "1", "score": { "win": "13", "loss": "4", "seriesWin": "1", "seriesLoss": "0", "linescore": [ "30", "27", "34", "30" ], "points": "121" }, "leaders": [ { "points": "8", "playerId": "886", "name": "Daniel Theis" }, { "rebounds": "3", "playerId": "886", "name": "Daniel Theis" }, { "assists": "4", "playerId": "538", "name": "Kemba Walker" }, { "rebounds": "10", "playerId": "75", "name": "Jaylen Brown" }, { "assists": "2", "playerId": "291", "name": "Enes Kanter" }, { "points": "39", "playerId": "538", "name": "Kemba Walker" }, { "rebounds": "9", "playerId": "882", "name": "Jayson Tatum" }, { "assists": "5", "playerId": "486", "name": "Marcus Smart" } ] }, "officials": [ { "name": "James Capers" }, { "name": "Scott Wall" }, { "name": "Jonathan Sterling" } ] } ] } } ``` statistics ------- ### Parameters

Parameter	Type	Required	Description
gameId	integer	true	Fails if field contains anything other than an integer

### Requests #### `GET` By gameId Get team statistics from one `{gameId}` ``` php get("https://api-nba-v1.p.rapidapi.com/statistics/games/gameId/6642"); ``` ### Response Model ``` json { "api": { "status": 200, "message": "GET statistics/games/gameId/6642", "results": 2, "filters": [ "gameId" ], "statistics": [ { "gameId": "6642", "teamId": "4", "fastBreakPoints": "13", "pointsInPaint": "38", "biggestLead": "9", "secondChancePoints": "10", "pointsOffTurnovers": "14", "longestRun": "10", "points": "110", "fgm": "40", "fga": "90", "fgp": "44.4", "ftm": "9", "fta": "19", "ftp": "47.4", "tpm": "21", "tpa": "56", "tpp": "37.5", "offReb": "11", "defReb": "27", "totReb": "38", "assists": "32", "pFouls": "22", "steals": "5", "turnovers": "15", "blocks": "6", "plusMinus": "-11", "min": "240:00" }, { "gameId": "6642", "teamId": "2", "fastBreakPoints": "21", "pointsInPaint": "46", "biggestLead": "13", "secondChancePoints": "25", "pointsOffTurnovers": "23", "longestRun": "9", "points": "121", "fgm": "43", "fga": "97", "fgp": "44.3", "ftm": "22", "fta": "24", "ftp": "91.7", "tpm": "13", "tpa": "34", "tpp": "38.2", "offReb": "19", "defReb": "36", "totReb": "55", "assists": "23", "pFouls": "17", "steals": "10", "turnovers": "14", "blocks": "5", "plusMinus": "11", "min": "240:00" } ] } } ``` Players ======= informations ----- ### Parameters

Parameter	Type	Required	Description
playerId	integer	true	Fails if field contains anything other than an integer
teamId	integer	true	Fails if field contains anything other than an integer
league	string	true	Fails if field contains anything other than alpha-numeric characters
country	string	true	Fails if field contains anything other than alpha-numeric characters
lastName	string	true	Fails if field contains anything other than alpha-numeric characters
firstname	string	true	Fails if field contains anything other than alpha-numeric characters

### Requests #### `GET` By playerId Get one player from `{playerId}` ``` php get("https://api-nba-v1.p.rapidapi.com/players/playerId/17"); ``` #### `GET` By teamId Get all players from one `{teamId}` ``` php get("https://api-nba-v1.p.rapidapi.com/players/teamId/6"); ``` #### `GET` By league Get all players from one `{league}` ``` php get("https://api-nba-v1.p.rapidapi.com/players/league/standard"); ``` #### `GET` By country Get all players from one `{country}` ``` php get("https://api-nba-v1.p.rapidapi.com/players/country/spain"); ``` #### `GET` By lastName Get all players from one `{lastName}` ``` php get("https://api-nba-v1.p.rapidapi.com/players/lastName/Abrines"); ``` #### `GET` By firstName Get all players from one `{firstName}` ``` php get("https://api-nba-v1.p.rapidapi.com/players/firstName/Alex"); ``` ### Response Model ```json { "api": { "status": 200, "message": "GET players/playerId/44", "results": 1, "filters": [ "playerId", "teamId", "league", "country", "lastName", "firstName" ], "players": [ { "firstName": "Kent", "lastName": "Bazemore", "teamId": "29", "yearsPro": "7", "collegeName": "Old Dominion", "country": "USA", "playerId": "44", "dateOfBirth": "1989-07-01", "affiliation": "Old Dominion/USA", "startNba": "2012", "heightInMeters": "1.93", "weightInKilograms": "88.5", "leagues": { "standard": { "jersey": "24", "active": "1", "pos": "G-F" } } } ] } } ``` statistics per games ----- ### Parameters

Parameter	Type	Required	Description
gameId	integer	true	Fails if field contains anything other than an integer

### Requests #### `GET` By gameId Get all players statistics from one `{gameId}` ``` php get("https://api-nba-v1.p.rapidapi.com/statistics/players/gameId/6642"); ``` ### Response Model ```json { "api": { "status": 200, "message": "GET statistics/players/gameId/6642", "results": 26, "filters": [ "gameId", "playerId" ], "statistics": [ { "gameId": "6642", "teamId": "4", "points": "21", "pos": "SF", "min": "26:40", "fgm": "8", "fga": "13", "fgp": "61.5", "ftm": "0", "fta": "0", "ftp": "0.0", "tpm": "5", "tpa": "9", "tpp": "55.6", "offReb": "1", "defReb": "4", "totReb": "5", "assists": "2", "pFouls": "4", "steals": "0", "turnovers": "0", "blocks": "2", "plusMinus": "-7", "playerId": "221" }, { "gameId": "6642", "teamId": "4", "points": "12", "pos": "PF", "min": "28:31", "fgm": "4", "fga": "10", "fgp": "40.0", "ftm": "0", "fta": "0", "ftp": "0.0", "tpm": "4", "tpa": "10", "tpp": "40.0", "offReb": "0", "defReb": "1", "totReb": "1", "assists": "1", "pFouls": "3", "steals": "0", "turnovers": "3", "blocks": "0", "plusMinus": "-14", "playerId": "437" } ] } } ``` statistics per player ----- ### Parameters

Parameter	Type	Required	Description
playerId	integer	true	Fails if field contains anything other than an integer

### Requests #### `GET` By playerId Get all players statistics from one `{playerId}` ``` php get("https://api-nba-v1.p.rapidapi.com/statistics/players/playerId/175"); ``` ### Response Model ```json { "api": { "status": 200, "message": "GET statistics/players/playerId/175", "results": 235, "filters": [ "gameId", "playerId" ], "statistics": [ { "gameId": "1429", "teamId": "8", "points": "3", "pos": "", "min": "20:30", "fgm": "1", "fga": "3", "fgp": "33.3", "ftm": "0", "fta": "2", "ftp": "0.0", "tpm": "1", "tpa": "2", "tpp": "50.0", "offReb": "1", "defReb": "3", "totReb": "4", "assists": "1", "pFouls": "0", "steals": "0", "turnovers": "0", "blocks": "1", "plusMinus": "-4", "playerId": "175" }, { "gameId": "1434", "teamId": "8", "points": "0", "pos": "", "min": "16:08", "fgm": "0", "fga": "3", "fgp": "0.0", "ftm": "0", "fta": "0", "ftp": "0.0", "tpm": "0", "tpa": "1", "tpp": "0.0", "offReb": "2", "defReb": "1", "totReb": "3", "assists": "0", "pFouls": "1", "steals": "0", "turnovers": "0", "blocks": "1", "plusMinus": "8", "playerId": "175" }, ] } } ```