Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Get started with NBA API v4

❗️

Alert

Please 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 v4, you will need several parameters to create your API calls. The map below illustrates how you can obtain the parameters you need.

The primary feeds require only a date or season to call the endpoints. Those feeds provide Game, Team, or Player Ids which can be used to generate the game, team, and player feeds. All of the other feeds require no variables.


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. Full coverage is available for all regular and postseason games. Most preseason games will also have full coverage, though in some rare cases extended boxscore may be used.

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.

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.

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.

NBA v7 Schema

Data Entry Workflow

Sunday

Final Game Times Set for Day’s Games (10am CT)*

Injuries (All Day)

Transactions (All Day)

Validated Games (60 Minutes after game goes final)

Update NBA Rankings (60 Minutes after the last game goes final)

Monday

Injuries (All Day)

Final Game Times Set for Day’s Games (10am CT) 

Validated Games (60 Minutes after game goes final)

Update NBA Rankings (60 Minutes after the last game goes final)

Seasonal Stats Validation (All Day)

Transactions (All Day)

Tuesday

Final Game Times Set for Day’s Games (10am CT)

Injuries (All Day)

Validated Games (60 Minutes after game goes final)

Update NBA Rankings (60 Minutes after the last game goes final)

Seasonal Stats Validation (All Day)

Transactions (All Day)

Wednesday

Final Game Times Set for Day’s Games (10am CT)

Injuries (All Day)

Validated Games (60 Minutes after game goes final)

Update NBA Rankings (60 Minutes after the last game goes final)

Seasonal Stats Validation (All Day)

Transactions (All Day)

Thursday

Final Game Times Set for Day’s Games (10am CT)

Injuries (All Day)

Validated Games (60 Minutes after game goes final)

Update NBA Rankings (60 Minutes after the last game goes final)

Seasonal Stats Validation (All Day)

Transactions (All Day)

Friday

Final Game Times Set for Day’s Games (10am CT)

Injuries (All Day)

Validated Games (60 Minutes after game goes final)

Update NBA Rankings (60 Minutes after the last game goes final)

Seasonal Stats Validation (All Day)

Transactions (All Day)

Saturday

Final Game Times Set for Day’s Games (10am CT)

Injuries (All Day)

Validated Games (60 Minutes after game goes final)

Update NBA Rankings (60 Minutes after the last game goes final)

Transactions (All Day)

 

Important Dates

The NBA schedule becomes available for our customers in mid-August

All NBA game times and dates are initially validated two weeks prior to the game and later confirmed the day of the game