NBA API Documentation
v2.2.5 9 endpoints
https://v2.nba.sportsdataapi.com Seasons
1 endpoint GET /seasons seasons
All
This endpoint does not require any parameters.
seasons can be used in other endpoints as filters. Seasons are only 4-digit keys like YYYY.This endpoint does not require any parameters.
GET https://v2.nba.sportsdataapi.com/seasons This endpoint does not require any query parameters.
Leagues
1 endpoint GET /leagues leagues
Get the list of available leagues.
All
Available leagues * Africa * Orlando * Sacramento * Standard * Utah * Vegas
This endpoint does not require any parameters.
All
leagues can be used in other endpoints as filters.Available leagues * Africa * Orlando * Sacramento * Standard * Utah * Vegas
This endpoint does not require any parameters.
GET https://v2.nba.sportsdataapi.com/leagues This endpoint does not require any query parameters.
Games
2 endpoints GET /games games
Get the list of games according to the parameters.
Available status * 1 : Not Started * 2 : live * 3 : Finished * 4 : Postponed * 5 : Delayed * 6 : Canceled
This endpoint requires at least one parameter.
Available status * 1 : Not Started * 2 : live * 3 : Finished * 4 : Postponed * 5 : Delayed * 6 : Canceled
This endpoint requires at least one parameter.
GET https://v2.nba.sportsdataapi.com/games Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game | |
| date | string | A valid date | |
| live | string | all | |
| league | string | The name of the league AfricaOrlandoSacramentoStandardUtahVegas | |
| season | integer | The season | |
| team | integer | The id of the team | |
| h2h | string | Two teams ids |
GET /games/statistics statistics
Get the statistics of the teams that played a game.
GET https://v2.nba.sportsdataapi.com/games/statistics Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the game |
Teams
2 endpoints GET /teams teams
Get data about teams.
The team
Available conferences * East * West
Available divisions * Atlantic * Central * Northwest * Pacific * Southeast * Southwest
The team
id are unique in the API and teams keep it among all seasons.Available conferences * East * West
Available divisions * Atlantic * Central * Northwest * Pacific * Southeast * Southwest
GET https://v2.nba.sportsdataapi.com/teams Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the team | |
| name | string | The name of the team | |
| code | string | The shortcode of the team | |
| league | string | The league of the team AfricaOrlandoSacramentoStandardUtahVegas | |
| conference | string | The conference of the team EastWest | |
| division | string | The division of the team AtlanticCentralNorthwestPacificSoutheastSouthwest | |
| search | string | The name of the team |
GET /teams/statistics statistics
Get the overall statistics of a team for a given
season.GET https://v2.nba.sportsdataapi.com/teams/statistics Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the team | |
| season | integer | The season | |
| stage | integer | The stage of the games |
Players
2 endpoints GET /players players
Get data about players.
The player
This endpoint requires at least one parameter.
The player
id are unique in the API and players keep it among all seasons.This endpoint requires at least one parameter.
GET https://v2.nba.sportsdataapi.com/players Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the player | |
| name | string | The name of the player | |
| team | integer | The team id | |
| season | integer | The season | |
| country | string | The country | |
| search | string |
GET /players/statistics statistics
Get statistics from one or more players.
This endpoint requires at least one parameter.
This endpoint requires at least one parameter.
GET https://v2.nba.sportsdataapi.com/players/statistics Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | integer | The id of the player | |
| game | integer | The id of the game | |
| team | integer | The id of the team | |
| season | integer | The season |
Standings
1 endpoint GET /standings standings
Get the standings for a league & season.
Available conferences * East * West
Available divisions * Atlantic * Central * Northwest * Pacific * Southeast * Southwest
Parameters
Available conferences * East * West
Available divisions * Atlantic * Central * Northwest * Pacific * Southeast * Southwest
Parameters
league & season are required.GET https://v2.nba.sportsdataapi.com/standings Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| league | string | The name of the league AfricaOrlandoSacramentoStandardUtahVegas | |
| season | integer | The season | |
| team | integer | The id of the team | |
| conference | string | The conference name EastWest | |
| division | string | The division name AtlanticCentralNorthwestPacificSoutheastSouthwest |
Quick Reference
Base URL
https://v2.nba.sportsdataapi.com Authentication
x-apisports-key: YOUR_API_KEY cURL
curl -X GET "https://v2.nba.sportsdataapi.com/seasons" \
-H "x-apisports-key: YOUR_API_KEY"Start free. Scale when ready.
Get 100 free nba API requests per day. No credit card required.
Upgrade to PRO for full real-time data, live odds, and unlimited historical access.