Get started with Global Basketball API v2
Introduction
The Global Basketball API provides real-time scoring and statistics (when available) and an array of supplementary data. Data is collected via Sportradar’s on-venue scouts and in-house operators.
Over 200 unique competitions are available in one package. Select the Global Basketball package in our Coverage Matrix for competitions and data offered.
The API is consistent in structure, format and behavior with the other General Sport APIs. Primary feeds will return seasons, competitions, team and player data, and real-time scores.
Additional feeds provide a host of complementary stats, including:
- Standings
- Player profiles
- Team profiles
- Historical results
- Game rosters
- Seasonal statistics
- Match win probabilities
- Live event positional data
Real-time customers are also offered two delivery Push Feeds to enhance speed.
An extended Probabilities package is also offered. This add-on includes in-game probability updates and season outrights.
Authentication is required for all API calls.
API Map
To best utilize the Global Basketball API, 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 human-readable parameters to call the endpoints. Those feeds provide Sport Event Ids, Competitor Ids, or Season Ids which can be used to generate the match, team, and tournament feeds.
Endpoint Descriptions
Competition Info – Provides the name, id, and parent id for a given competition.
Competition Seasons – Provides historical season information for a given competition. Competitions will return a maximum of three seasons of data, including current or newly created seasons.
Competitions – Provides a list of all available basketball competitions.
Competitor Mappings – Provides team id mapping between the Global Basketball API and other basketball APIs.
Competitor Merge Mappings – Provides the valid Sportradar Id in cases when two competitors have been merged into one. Mapping entries will remain in the feed for 7 days.
Competitor Profile – Provides top-level information for a given team, including the full team roster, home venue, and team colors.
Competitor Summaries – Provides previous and upcoming game information for a given competitor, including statistics for past games and scheduling info for upcoming games.
Competitor vs Competitor – Provides previous and upcoming games between two teams including scoring information, player game statistics and team game statistics.
Daily Summaries – Provides game information for a given day including team scoring, player and team game statistics.
Live Summaries – Provides game information for all currently live games including team scoring, player and team match statistics. This feed updates in real time as matches are played. Matches appear a few minutes before kick-off and disappear a few minutes after the match reaches “ended” status.
Live Timelines – Provides a play-by-play event timeline for currently live games. Games appear a few minutes before tip-off and disappear a few minutes after the game reaches “ended” status.
Live Timelines Delta – Provides a 10 second live delta of game information, including scoring and a play-by-play event timeline.
Player Mappings – Provides player id mapping between the Global Basketball API and other basketball APIs.
Player Merge Mappings – Provides valid ids for players who have had their profiles merged. While Sportradar always strives to provide one unique player id, it is a possibility for two ids to be created. This feed provides the correct id once profiles have been merged.
Player Profile – Provides player biographical information, including team membership info.
Season Competitors – Provides a list of teams participating for a given season.
Season Info – Provides detailed information for a given season, including participating teams and league structure.
Season Lineups – Provides game rosters for all games in a given season.
Season Links – Provides information about linked cup rounds for a given season. Use this feed to compile full advancement brackets for relevant seasons/tournaments. Links between all matches and rounds are available when competitors (TBD vs. TBD) are not yet known.
Season Mappings – Provides season id mapping between the Global Basketball API and other basketball APIs.
Season Players – Provides names and ids for all participating players for a given season.
Season Probabilities – Provides 2-way win probabilities (home team win, away team win) for all games for a given season.
Season Standings – Provides detailed standings info for a given season.
Season Summaries – Provides schedule information for all games from a given season including scoring and statistics at the game level.
Seasonal Competitor Statistics – Provides team seasonal statistics for a given season.
Seasons – Provides a list of historical season information for all competitions. Competitions will return a maximum of three seasons of data, including current or newly created seasons.
Sport Event Lineups – Provides detailed roster information for a given game. Starting players are included if supported by coverage level.
Sport Event Mappings – Provides game id mapping between the Global Basketball API and other basketball APIs.
Sport Event Summary – Provides real-time game-level statistics for a given game. Including scores by quarter and player and team stats. Please note that data returned is determined by coverage level.
Sport Event Timeline – Provides real-time game-level statistics and a play-by-play event timeline for a given game. This includes scores by quarter and player and team stats. Please note that data returned is determined by coverage level.
Sport Events Created – Provides ids for sport e vents that have been created in the last 24 hours.
Sport Event Removed – Provides ids for sport events that have been removed or deleted.
Sport Event Updated – Provides ids for sport events that have been updated in the last 24 hours.
Push Events – Provides real-time event updates for all live matches.
Push Statistics – Provides real-time team and player game-level statistics for all live games.
Live Probabilities – Provides top-level information for live games. If probabilities are available for a game, pre-match and live probabilities will be displayed.
Season Outright Probabilities – Provides a list of outright probabilities for each team from a given season.
Sport Event Probabilities – Provides pre-match and live probabilities for a given game.
Sport Event Upcoming Probabilities – Provides a list of IDs for upcoming sport events in the next 24 hours.
Timeline Probabilities – Provides a timeline of pre-match and live probability changes for a given game.
Probabilities Endpoints
Available only with the probabilities plan within the Global Basketball v2 package. See FAQ for details.
Data Retrieval Sample
To find the probability of a home team win for a given game:
- Call the Daily Schedule for the day the sport event takes place and find the Season Id for the chosen sport event
- Make note of the Sport Event Id for the given sport event
- Call the Season Probabilities using the Season Id
- Find Sport Event Id within the results locate the home team and the outcome probability
The probability of a home team win is displayed.
Integration Links
OpenAPI Specs
Our Global Basketball API is available via OpenAPI. Click below to view and/or download the spec.
Global Basketball v2 Probabilities OpenAPI
Postman Workspace
Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Global Basketball 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 Global Basketball API XSD schema.