Get started with NBA API v5
AlertPlease note that the current, stable version of our NBA API is v8. We suggest integrating with this version.
API Map
To best utilize the NBA API v5, you will need specific parameters to create your API calls. The map below shows every feed in the API, grouped by task; the key marks the identifier each feed takes, and each entry links out to its endpoint page.
Feeds that require no ID, or only a date or season year, can be called directly. Their responses provide the game, team, player, and series IDs that the remaining feeds take.
Data Retrieval Samples
To find a team's leader in assists for a given game:
- Call the season or series schedule and find the Game Id for the chosen game
- Call the Game Boxscore using the Game Id
- Find the Team Assists Leader statistics and locate the player full_name attribute
The name of the team's leader in assists is displayed.
To find a player's average points per game:
- Call the season or series schedule and find id for the team the player is on
- Call the Team Profile using the Team ID
- Locate the Player ID for your chosen player and call the Player Profile.
- Find the average element with the points attribute
The players's average points are displayed.
Coverage Levels
We provide two different levels of detail to ensure maximum coverage. We combine coverage levels with the correct feeds to ensure you are getting the most comprehensive data offering in the most efficient manner possible.
Extended Boxscore – We provide scores, time remaining, and team leaders (assists, points, and
rebounds), in a timely manner, as the game progresses. We provide team- and player-level data for the
game within 30 minutes of the official results being posted.
Full – We provide live play-by-play coverage for the entire game. We provide updated scores and time
remaining as well as team- and player-level data in near real time. Full coverage is available for all
regular and postseason games.
| Note: Preseason coverage of NBA games may vary. Due to data-entry coverage (from venue) not being available, some games may be covered via our extended boxscore coverage. |
Integration Links
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our NBA API collection. Please note that this collection is specific to the current version (v8).
Feel free to follow and/or fork any collections to receive updates.
Schema Download
Open the zip file below to access our entire NBA API XSD schema.