NBA Overview

Introduction

Sportradar is the Official Data Provider of NBA statistics. We combine on-venue speed, detailed game and seasonal statistics, and advanced metrics for a full basketball experience. Every NBA game – including preseason – updates in real-time, with live event positional data.

The NBA API is consistent in structure, format, and behavior with our other League Specific APIs. Our primary feeds return schedules, standings, team/player data, and real-time scores.

Our other NBA feeds provide a host of complementary statistics and information, including:

• Rankings
• League leaders
• Game splits
• Season splits
• Injuries
• Free agents
• Draft information
• Live advanced metrics
• In-game substitution info
• Live event positional data

Real-time customers are also offered five delivery Push Feeds to enhance speed.

🗝️

Authentication is required for all API calls.

🏀

NBA Integration Guide

Explore our NBA API Integration Guide for detailed, step-by-step guidance on how to build applications using our NBA API.

API Map

To best utilize the NBA API v8, 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.

Endpoint Descriptions

Daily Change Log – Provides IDs and timestamps for teams, players, game statistics, schedules, and standings that have been modified on a given date. To receive the data updates, use these unique IDs to pull relevant API feeds.

Daily Injuries – Provides details for all injuries updated on a given date.

Daily Schedule – Date, time, location, and other event details for every game taking place in the league-defined day.

Daily Transfers – Information for all transfers added or edited during the league-defined day.

Draft Summary – Provides pre-draft pick order with live pick selections during the draft. Displays information on draft rounds, picks, teams, and prospects for a given draft year.

Free Agents – Detailed player information for all current free agents in the league.

Game Boxscore – Top-level team scores by quarter, along with full statistics for each team’s leader in points, rebounds, and assists.

Game Play-By-Play – Detailed, real-time information on every team possession and game event.

Game Summary – Top-level boxscore information, along with detailed game stats at the team and player levels.

Injuries – Information concerning all active player injuries for each NBA team.

League Hierarchy – League, conference, division, and team identification and association information.

League Leaders – NBA leader information for various offensive and defensive categories including full player seasonal statistics for each player in each category.

Player Profile – Provides player biographical information, draft information, and seasonal statistics.

Prospects – Provides a list of upcoming or historical draft prospects for a given year.

Rankings – Conference and division rank for each team, including playoff clinching status.

Schedule – Date, time, location, and other event details for every match-up taking place in the full league season.

Seasonal Statistics – Provides complete team and player seasonal statistics for a given season and season type.

Seasons – Provides a list of all available seasons, including preseasons and postseasons.

Series Schedule – Playoff participant information as well as the date, time, location, and other event details for every match-up taking place for the entire playoffs.

Series Statistics – Detailed team and player statistics for a given playoff series.

Splits – Detailed splits divided into game, hierarchy, in-game, and schedule splits.

Standings – Detailed team records across various views including, overall, conference, and division information.

Team Depth Chart – Provides a current depth chart for all positions on a given team.

Team Draft Summary – Provides pre-draft pick order with live pick selections during the draft for a given team.

Team Profile – Provides top-level team information and a full roster of active players.

Teams – Provides a complete list of active teams in the NBA API database.

Top Prospects – Provides a list of the top prospects for a given year.

Trades – Provides summary details of all in-draft trades.

Push Clock – Game clock with high level scoring and possession information.

Push Draft Picks – Provides pre-draft pick order with real-time pick selections during the draft.

Push Draft Trades – Provides summary details of all in-draft trades in real-time.

Push Events – Detailed, real-time information on every game event.

Push Statistics – Detailed, real-time game stats at the team and player level for all live games.

Court Vision Post-Game Post - Provides in-game player pose and ball location for a full game after the game is over.

Data Retrieval Samples

To find a team's leader in assists for a given game:

1. Call the schedule or series schedule feed and find the Game Id for the game of your choice
2. Call the Game Boxscore using the Game Id
3. Find the Team of your choice, locate the Leaders statistics, then 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:

1. Call the schedule or series schedule and find id for the team the player is on
2. Call the Team Profile using the Team ID
3. Locate the Player ID for your chosen player and call the Player Profile.
4. 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. 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.

🏀

Preseason Coverage Note:

Preseason coverage of NBA games may vary. Some games may be extended boxscore coverage due to on-venue data-entry being unavailable.

API data latency will vary compared to regular season games, due to collection and processing differences. Preseason games serve as a testing ground, often resulting in changes and adjustments to data collection methods. As a result, data updates may not be as timely or consistent as the regular season.

Integration Links

Integration Guide

Set up an account, learn the NBA API basics, study our game workflows, tackle in-depth integration scenarios, and more by visiting our NBA v8 Integration Guide!

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our NBA API collection.

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 v8 Schema

Simulations

Check out our Simulationsto replay actual games at any time, on your own schedule.

Failover Information

For information on live game data available during a failover event, click here.

In-Season Tournament

The In-Season Tournament is a mid-season competition where teams compete in a series of group-stage and knockout games.

Play-In Tournament

The Play-In Tournament is a postseason competition where teams ranked 7th to 10th in each conference compete for the final two playoff spots.

All-Star Game FAQ

How do I locate the All-Star game?

The game can be found in the Daily Schedule feed on the date of the event. For example: nba/trial/v8/en/games/2024/02/18/schedule

Every game-centric feed (e.g. Game Play-by-Play, Game Summary, Push Events, etc) can be accessed during the game.

Click here for for a Game Summary or Play-by-Play sample of the 2022 game.

What are the differences from a typical NBA game?

All-Star teams represent the Eastern and Western Conferences, with their own unique Ids. Conference team Ids will be consistent for each year beginning in 2024.

Please note that these teams will not be included in the League Hierarchy endpoint.

2024 Teams:

<home name="East NBA All Stars" alias="EST" id="592d3144-895b-43e9-ab15-e84666a845d5" reference="1610616833">

<away name="West NBA All Stars" alias="WST" id="787ff06f-f0cc-484e-8114-04e0cdc444fa" reference="1610616834">

Is the All-Star game covered in realtime?

Yes. The game is covered in realtime, including the same level of team and player statistics as a regular season game.

When are the All-Star rosters set?

All-Star game rosters will be available shortly prior to tipoff.

Please note that we only provide game rosters (not team rosters) for each game. Request the Game Summary endpoint prior to the game to receive rosters.

If you require rosters earlier, we suggest using the Team Profile endpoints of each NBA team to pull in players manually.

Do you cover any of the other All-Star game events?

Yes. We also cover the Rising Stars Challenge in the NBA API. Locate these games in the Schedule or Daily Schedule endpoints.

We do not cover any of the isolated events, such as the Slam Dunk Content or Three-Point Contest.

Data Entry Workflow

See below for a daily breakdown of data updates for the NBA API.