API-NBA
Verified
✓
By
API-SPORTS |
Updated 2 years ago |
Sports
Popularity
9.9 / 10
Latency
392ms
Service Level
100%
Spotlights
Followers: 326
Resources:
Product Website Terms of use API Creator:
API-SPORTS
api-sports
Log In to Rate API
Rating: 3 - Votes: 8
README
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.
ARCHITECTURE
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}
get("https://api-nba-v1.p.rapidapi.com/seasons/");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/leagues/");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/teams/teamId/1");
GET By league
Get one team from one team {league}
get("https://api-nba-v1.p.rapidapi.com/teams/league/standard");
GET By city
Get all teams from one {city}
get("https://api-nba-v1.p.rapidapi.com/teams/city/Atlanta");
GET By shortName
Get one team from one {shortName}
get("https://api-nba-v1.p.rapidapi.com/teams/shortName/ATL");
GET By nickName
Get one team from one {nickName}
get("https://api-nba-v1.p.rapidapi.com/teams/nickName/Hawks");
GET By confName
Get all teams from one {confName}
get("https://api-nba-v1.p.rapidapi.com/teams/confName/East");
GET By divName
Get all teams from one {divName}
get("https://api-nba-v1.p.rapidapi.com/teams/divName/Southeast");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/standings/standard/2019");
GET By league & teamId
Get all Standings from one {league} & {season} & {teamId}
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}
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}
get("https://api-nba-v1.p.rapidapi.com/standings/standard/2019/division/southeast");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/games/gameId/6642");
GET By live
Get all available games in play
get("https://api-nba-v1.p.rapidapi.com/games/live/");
GET By league
Get all available games from one {league} & {season}
get("https://api-nba-v1.p.rapidapi.com/games/league/standard/2019");
GET By teamId
Get all available games from one {teamId}
get("https://api-nba-v1.p.rapidapi.com/games/teamId/1");
GET By date
Get all available games from one {date}
get("https://api-nba-v1.p.rapidapi.com/games/date/2019-11-28");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/gameDetails/6642");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/statistics/games/gameId/6642");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/players/playerId/17");
GET By teamId
Get all players from one {teamId}
get("https://api-nba-v1.p.rapidapi.com/players/teamId/6");
GET By league
Get all players from one {league}
get("https://api-nba-v1.p.rapidapi.com/players/league/standard");
GET By country
Get all players from one {country}
get("https://api-nba-v1.p.rapidapi.com/players/country/spain");
GET By lastName
Get all players from one {lastName}
get("https://api-nba-v1.p.rapidapi.com/players/lastName/Abrines");
GET By firstName
Get all players from one {firstName}
get("https://api-nba-v1.p.rapidapi.com/players/firstName/Alex");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/statistics/players/gameId/6642");
Response Model
{
"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}
get("https://api-nba-v1.p.rapidapi.com/statistics/players/playerId/175");
Response Model
{
"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"
},
]
}
}