Get started with NBA G League API v8
Introduction
Sportradar is the Official Data Provider of NBA G League data. We combine on-venue speed and detailed game and seasonal statistics to power your basketball experiences. Games update in real-time, with live advanced metrics.
The NBA G League API is consistent in structure, format, and behavior with our other League Specific APIs. Our primary feeds return schedules, standings, team and player data, and real-time scores.
Additional feeds provide a host of complementary statistics and information, including:
- Rankings
- League leaders
- Game splits
- Season splits
- Injuries
- Free agents
- Live advanced metrics
- In-game substitution info
- Live event positional data
Real-time customers are also offered three delivery Push Feeds to enhance speed.
Authentication is required for all API calls.
API Map
To best utilize the NBA G League 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 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.
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 teams’ leaders 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 G League team.
League Hierarchy – League, conference, division, and team identification and association information.
League Leaders – G League 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 and seasonal statistics.
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 Profile – Provides top-level team information and a full roster of active players.
Teams – Provides a complete list of active teams in the G League API database.
Push Clock – Game clock feed with high level scoring and possession information.
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.
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.
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.
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 note:
Preseason coverage of G League 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 G League 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 G League API XSD schema.
Simulations
Click here for a detailed breakdown on our available simulations.
Failover Information
Reference the below files to find data points unavailable when Sportradar's data team provides game updates due to a G League data interruption. Please note that when the game is over, all data entered by Sportradar is deleted and replaced with the official data provided by the NBA G League.