API-NBA

FREEMIUM
Verified
By API-SPORTS | Updated 12 days ago | Sports
Popularity

9.9 / 10

Latency

128ms

Service Level

100%

Followers: 221
Resources:
Product Website Terms of use
API Creator:
avatar
API-SPORTS
api-sports
Rate API:
Log In to Rate API

README

All NBA Stats DATA, Games, Livescore, Standings, Statistics, Teams, Players, Seasons, Leagues.

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

<table>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>teamId</td>
<td>integer</td>
<td>true</td>
<td>Fails if field contains anything other than an integer</td>
</tr>
<tr>
<td>league</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>city</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>shortName</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>nickName</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>confName</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>divName</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
</table>

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

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

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

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

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

<table>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>gameId</td>
<td>integer</td>
<td>false</td>
<td>Fails if field contains anything other than an integer</td>
</tr>
</table>

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

<table>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>gameId</td>
<td>integer</td>
<td>true</td>
<td>Fails if field contains anything other than an integer</td>
</tr>
</table>

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

<table>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>playerId</td>
<td>integer</td>
<td>true</td>
<td>Fails if field contains anything other than an integer</td>
</tr>
<tr>
<td>teamId</td>
<td>integer</td>
<td>true</td>
<td>Fails if field contains anything other than an integer</td>
</tr>
<tr>
<td>league</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>country</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>lastName</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
<tr>
<td>firstname</td>
<td>string</td>
<td>true</td>
<td>Fails if field contains anything other than alpha-numeric characters</td>
</tr>
</table>

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

<table>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>gameId</td>
<td>integer</td>
<td>true</td>
<td>Fails if field contains anything other than an integer</td>
</tr>
</table>

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

<table>
<tr>
<th>Parameter</th>
<th>Type</th>
<th>Required</th>
<th>Description</th>
</tr>
<tr>
<td>playerId</td>
<td>integer</td>
<td>true</td>
<td>Fails if field contains anything other than an integer</td>
</tr>
</table>

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"
            },
        ]
    }
}
Rating: 5 - Votes: 8