NBA v4
API & Version | Data Entry Workflow | Failover | XSD Schema |
Official NBA v4 | Data Entry Workflow | Failover Details Failover Summary |
Download |
Note: Authentication is required for all API calls. |
Examples:
>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
- 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
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. |
Quick Access | |
Start Time (UTC) | Game | Game ID |
1:00pm | Chicago Bulls at New York Knicks | 26e0906a-a222-4013-a9c8-dea6a8fe1f4f |
1:00pm | Brooklyn Nets at Portland Trailblazers | 0d996d35-85e5-4913-bd45-ac9cfedbf272 |
5:00pm | Utah Jazz at Los Angeles Clippers | a2a43125-5538-43f7-84a9-e8e02a8a772f |
5:00pm | Philadelphia 76ers at Detroit Pistons | 9c322810-33cc-4aa8-b1c7-43bc6ed9af73 |
5:00pm | Washington Wizards at Golden State Warriors | f8367461-6e6f-4cbb-b758-4b866f554f80 |
7:00pm | San Antonio Spurs at Los Angeles Lakers | 12b2e554-c80f-404f-b140-c25400996ac7 |
Feeds Available: Schedule, Standings, League Hierarchy, Game Boxscore, Game Summary, Play-By-Play, Team Profile, Seasonal Statistics, Injuries, Rankings, Push Events, and Push Statistics
For syntax structure on each feed, please reference the below documentation. ## Play-In Tournament Each NBA season will feature a play-in tournament to determine the 7th and 8th seeds for each conference’s playoff bracket. The 2023 Play-In Tournament will begin Tuesday, April 11 and conclude Friday, April 14. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.com/nba/trial/v7/en/games/2021/PIT/schedule.xml?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nba/trial/v7/en/games/2021/PIT/schedule.xml?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.com/nba/trial/v7/en/games/2021/PIT/schedule.xml?api_key={your_api_key}" ``` > Click below for XML and JSON samples of the Play-In Tournament Schedule feedXML - JSON In the NBA API, these games will be found in the Play-in Tournament (PIT) season schedule: https://api.sportradar.com/nba/production/v7/en/games/2022/PIT/schedule.xml?api= The season parameter of
PIT
must also be used to retrieve seasonal statistics for these games.
At the conclusion of the regular season but prior to the first round of the playoffs, the team with the 7th-highest winning percentage in each conference will host the team with the 8th-highest winning percentage in a Play-In Game (the “Seven-Eight Game”). The winner of the Seven-Eight Game in each conference will earn the No. 7 seed.
-
In the below example, the Miami Heat would host the Charlotte Hornets in the Seven-Eight Game. The winner of that game would be the 7th seed in the Eastern Conference playoffs and would play the 2nd seed in the first round.
-
Additionally, the team with the 9th-highest winning percentage in each conference will host the team with the 10th-highest winning percentage in the “Nine-Ten Game”.
-
In this example, the Indiana Pacers would host the Washington Wizards in the “Nine-Ten Game.” The loser of that game would be eliminated from playoff contention. The winner would play the loser of the Heat/Hornets game (Seven-Eight Game). The winner of that game would earn the 8th seed and play the 1st seed in the first round of the playoffs.
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Info Data Points: | Game Id | Last Updated | |
League Info Data Points: | League Alias League Id |
League Name | Season Id |
Player Data Points: | Full Name | Last Modified | Player Id |
Team Data Points: | Id Last Modified |
Market Name |
Reference |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Info Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Reference Away Team Seed Number Broadcast Cable Broadcast Internet |
Broadcast Network Broadcast Radio Broadcast Satellite Game Coverage Game Id Game Reference Game Status Game Title Home Team Alias |
Home Team Id Home Team Name Home Team Points Home Team Reference Home Team Seed Number Neutral Site Scheduled Date Scheduled Date and Time Track on Court |
League Info Data Points: | League Alias | League Id | League Name |
Venue Info Data Points: | Address Capacity City |
Country Description Name |
State Id Zip |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | League Alias | League Id | League Name |
Player Info Data Points: | First Name Full Name Jersey Number Last Name Player Id Position Primary Position Reference |
Transfers Description Transfers Effective Date Transfers End Date Transfers Id Transfers New Team Id Transfers New Team Market Transfers New Team Name Transfers New Team Reference |
Transfers Notes Transfers Old Team Id Transfers Old Team Market Transfers Old Team Name Transfers Old Team Reference Transfers Start Date Transfers Update Date |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | League Alias | League Id | League Name |
Player Info Data Points: | Abbreviated Name Birth Date Birth Place College Experience First Name |
Full Name Height (in) Last Name Player Id Position |
Primary Position Reference Status Updated Weight (lbs) |
Update Frequency: | Real-time | ||
Content Type: | XML or JSON | ||
Game Info Data Points: | Away Team Id Game Clock Game Coverage Game Duration |
Game Id Game Quarter Game Status Game Title |
Home Team Id Neutral Site Scheduled Date And Time Track on Court |
Boxscore Data Points: | Attendance Lead Changes Scoreboard - Away Team Game Score Scoreboard - Away Team Id Scoreboard - Away Team Market Scoreboard - Away Team Name Scoreboard - Away Team Quarter Score Scoreboard - Away Team Reference Scoreboard - Home Team Flag |
Scoreboard - Home Team Game Score Scoreboard - Home Team Id Scoreboard - Home Team Market Scoreboard - Home Team Name Scoreboard - Home Team Quarter Score Scoreboard - Home Team Reference Scoreboard - Quarter Number Scoreboard - Quarter Sequence Team Assists Leader - Player Full Name |
Team Assists Leader - Player Id Team Assists Leader - Player Reference Team Points Leader - Player Full Name Team Points Leader - Player Id Team Points Leader - Player Reference Team Rebounds Leader - Player Full Name Team Rebounds Leader - Player Id Team Rebounds Leader - Player Reference Times Tied |
Team Info Data Points: | Id Market |
Name | Reference |
Player Info Data Points: | Full Name Jersey Number |
Player Id Position |
Primary Position Reference |
Player Game Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Defensive Rebounds Double Double Effective Field Goal Percentage Efficiency Efficiency Game Score Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Fouls Drawn |
Free Throw Attempts Free Throw Percentage Free Throws Made Minutes Played Offensive Fouls Offensive Rebounds Personal Fouls Plus/Minus Points Points in the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage |
Points Off Turnovers Rebounds Second Chance Points Steals Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Triple Double Turnovers Two Point Attempts Two Point Percentage Two Points Made |
Update Frequency: | Real-time | ||
Content Type: | XML or JSON | ||
Game Info Data Points: | Away Team Id Game Clock Game Coverage Game Duration |
Game Id Game Quarter Game Status Game Title |
Home Team Id Neutral Site Scheduled Date And Time Track on Court |
Boxscore Info Data Points: | Attendance Game Officials - Assignment Game Officials - Experience Game Officials - First Name Game Officials - Full Name Game Officials - Id Game Officials - Last Name Game Officials - Number Lead Changes Lineups - Active For Game |
Lineups - Ejected Lineups - Fouled Out Lineups - Played Lineups - Started Scoreboard - Away Team Game Score Scoreboard - Away Team Id Scoreboard - Away Team Market Scoreboard - Away Team Name Scoreboard - Away Team Quarter Score Scoreboard - Away Team Reference |
Scoreboard - Home Team Flag Scoreboard - Home Team Game Score Scoreboard - Home Team Id Scoreboard - Home Team Market Scoreboard - Home Team Name Scoreboard - Home Team Quarter Score Scoreboard - Home Team Reference Scoreboard - Quarter Number Scoreboard - Quarter Sequence Times Tied |
Team Info Data Points: | Coach - First Name Coach - Full Name Coach - Id |
Coach - Last Name Coach - Position Id |
Market Name Reference |
Player Info Data Points: | First Name Full Name Jersey Number |
Last Name Player Id Position |
Primary Position Reference |
Player Period Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Coach Ejections Coach Tech Fouls Defensive Rating Defensive Rebounds Defensive Rebounds Percentage Effective Field Goal Percentage Efficiency Efficiency Game Score Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Fouls Drawn Free Throw Attempts |
Free Throw Percentage Free Throws Made Minus Minutes Played Offensive Fouls Offensive Rating Offensive Rebounds Offensive Rebounds Percentage Personal Fouls Period Id Period Number Period Type Period Sequence Plus Plus/Minus Points Points in the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage |
Points Off Turnovers Rebounds Rebounds Percentage Second Chance Attempts Second Chance Made Second Chance Percentage Second Chance Points Steals Steals Percentage Technical Fouls Three Point Attempts Three Point Percentage Three Points Made True Shooting Attempts True Shooting Percentage Turnovers Turnovers Percentage Two Point Attempts Two Point Percentage Two Points Made |
Team Period Statistics Data Points: | Assists Assists To Turnover Ratio Bench Points Biggest Lead Blocked Attempts Blocked Shots Coach Ejections Coach Technical Fouls Defensive Points per Possession Defensive Rating Defensive Rebounds Effective Field Goal Percentage Efficiency Efficiency Game Score Ejections Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Fouls Drawn Free Throw Attempts |
Free Throw Percentage Free Throws Made Minutes Played Offensive Fouls Offensive Points per Possession Offensive Rating Offensive Rebounds Opponent Possessions Pace Period Id Period Number Period Sequence Period Type Personal Fouls Player Technical Fouls Plus/Minus Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Percentage Points in the Paint Made Points off Turnovers Possessions Rebounds Second Chance Attempts Second Chance Made |
Second Chance Percentage Second Chance Points Steals Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Rebounds Team Technical Fouls Team Turnovers Technical Other Three Point Attempts Three Point Percentage Three Points Made Time Leading Total Fouls Total Rebounds True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Made |
Player Game Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Coach Ejections Coach Tech Fouls Defensive Rating Defensive Rebounds Defensive Rebounds Percentage Double Double Effective Field Goal Percentage Efficiency Efficiency Game Score Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Fouled Out |
Fouls Drawn Free Throw Attempts Free Throw Percentage Free Throws Made Games Played Games Started Minus Minutes Played Offensive Fouls Offensive Rating Offensive Rebounds Offensive Rebounds Percentage Personal Fouls Plus Plus/Minus Points Points in the Paint Points in the Paint Attempts Points in the Paint Made Points in the Paint Percentage |
Points Off Turnovers Rebounds Rebounds Percentage Second Chance Attempts Second Chance Made Second Chance Percentage Second Chance Points Steals Steals Percentage Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Triple Double True Shooting Attempts True Shooting Percentage Turnovers Turnovers Percentage Two Point Attempts Two Point Percentage Two Points Made |
Team Game Statistics Data Points: | Assists Assists To Turnover Ratio Bench Points Biggest Lead Blocked Attempts Blocked Shots Coach Ejections Coach Technical Fouls Defensive Points per Possession Defensive Rating Defensive Rebounds Effective Field Goal Percentage Efficiency Efficiency Game Score Ejections Fast Break Attempts Fast Break Made Fast Break Percentage Fast Break Points Field Goal Attempts Field Goal Percentage Field Goals Made Flagrant Fouls Foul Outs Fouls Drawn |
Free Throw Attempts Free Throw Percentage Free Throws Made Minutes Played Most Unanswered - Opponent Score Most Unanswered - Own Score Most Unanswered - Points Offensive Fouls Offensive Points per Possession Offensive Rating Offensive Rebounds Opponent Possessions Pace Personal Fouls Player Technical Fouls Plus/Minus Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Percentage Points in the Paint Made Points off Turnovers Possessions Rebounds Second Chance Attempts |
Second Chance Made Second Chance Percentage Second Chance Points Steals Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Rebounds Team Technical Fouls Team Turnovers Technical Other Three Point Attempts Three Point Percentage Three Points Made Time Leading Total Fouls Total Rebounds True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Mad |
Venue Data Points: | Address Capacity City |
Country Description Name |
State Venue Id Zip |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Data Points: | League Alias | League Id | League Name |
Player Info Data Points: | First Name Full Name Injuries - Injury Comment Injuries - Injury Description Injuries - Injury Id |
Injuries - Injury Start Date Injuries - Injury Status Injuries - Update Date Jersey Number Last Name |
Player Id Position Primary Position Reference |
Team Info Data Points: | Id Market |
Name | Reference |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | Conference Alias Conference Id Conference Name |
Division Alias Division Id Division Name |
League Alias League Id League Name |
Team Info Data Points: | Alias Id |
Market Name |
Reference |
Venue Info Data Points: | Address Capacity City |
Country Description Name |
State Venue Id Zip |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | Season Id | Season Type | Season Year |
League Leaders Data Points: | Assists Assists Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Category Name Category Type Defensive Rebounds Defensive Rebounds Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Foulouts Free Throw Attempts Free Throw Attempts Per Game |
Free Throw Percentage Free Throws Made Free Throws Made Per Game Leaders Alias Leaders Id Leaders Name Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Player Rank Points Points Per Game Rebounds Rebounds Per Game |
Stat Category Steals Steals Per Game Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Tied Flag Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Player Info Data Points: | First Name Full Name Jersey Number |
Last Name Player Id Position |
Primary Position Reference |
Player Season Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Tech Fouls Defensive Rebounds Defensive Rebounds Per Game Double Doubles Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Fouled Out Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers |
Points Off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Triple Doubles True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Team Data Points: | Id | Market | Name |
Update Frequency: | Real-time | ||
Content Type: | XML or JSON | ||
Game Info Data Points: | Away Team Id Game Clock Game Coverage Game Id |
Game Quarter Game Status Game Title |
Home Team Id Neutral Site Scheduled Date And Time Track on Court |
Boxscore Info Data Points: | Attendance | Lead Changes | Times Tied |
Play-By-Play Data Points: | Attribution - Team Id Attribution - Team Market Attribution - Team Name Attribution - Team Reference Away Team Game Score Away Team Id Away Team Market Away Team Name Away Team Quarter Score Away Team Reference Basket Team is Attacking Event Attempt Event Clock Event Description Event Free Throw Type Event Id Event Location - X Coordinate Event Location - Y Coordinate Event Number Event Participants - Player Full Name Event Participants - Player Id Event Participants - Player Jersey Number |
Event Participants - Player Reference Event Participants - Team Id Event Participants - Team Market Event Participants - Team Name Event Participants - Team Reference Event Shot Type Event Shot Type Description Event Turnover Type Event Type Event Updated Fieldgoal - Made Flag Fieldgoal - Points Fieldgoal - Shot Type Fieldgoal - Shot Type Description Fieldgoal - Three Point Shot Freethrow - Made Flag Freethrow - Free Throw Type Home Team Game Score Home Team Id Home Team Market Home Team Name Home Team Quarter Score Home Team Reference |
On Court Participants - Player Full Name On Court Participants - Player Id On Court Participants - Player Jersey Number On Court Participants - Player Reference On Court Participants - Team Id On Court Participants - Team Market On Court Participants - Team Name On Court Participants - Team Reference Overtime Id Overtime Number Overtime Sequence Possession - Team Id Possession - Team Market Possession - Team Name Possession - Team Reference Quarter Id Quarter Number Quarter Sequence Rebound - Rebound Type Scoring Times Tied Scoring Lead Changes |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | League Alias League Id |
League Name Season Id |
Season Type Season Year |
Player Info Data Points: | Abbreviated Name Birth Date Birth Place College Draft Pick Draft Round Draft Team |
Draft Year Experience First Name Full Name Height (in) Jersey Number Last Name |
Player Id Position Primary Position Reference Status Update Date Weight (lbs) |
Player Seasonal Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Tech Fouls Defensive Rebounds Defensive Rebounds Per Game Double Doubles Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Fouled Out Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers |
Points Off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Triple Doubles True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Team Info Data Points: | Alias Id |
Market Name |
Reference |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | Conference Alias Conference Id Conference Name Division Alias |
Division Id Division Name League Alias League Id |
League Name Season Id Season Type Season Year |
Standings Info Data Points: | Conference Rank | Division Rank | Playoff Status |
Team Data Points: | Id Market |
Name | Reference |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Info Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Reference Broadcast Cable Broadcast Internet |
Broadcast Network Broadcast Radio Broadcast Satellite Home Team Alias Home Team Id Home Team Name Home Team Points Home Team Reference |
Game Coverage Game Id Game Reference Game Status Game Title Neutral Site Scheduled Date and Time Track on Court |
League Info Data Points: | League Alias League Id |
League Name Season Id |
Season Type Season Year |
Venue Info Data Points: | Address Capacity City |
Country Description Name |
State Venue Id Zip |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | Season Id | Season Type | Season Year |
Player Data Points: | First Name Full Name Jersey Number |
Last Name Player Id Position |
Primary Position Reference |
Opponent Seasonal Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game Foul Outs |
Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts |
Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Technical Other Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Fouls Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Player Seasonal Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Tech Fouls Defensive Rebounds Defensive Rebounds Per Game Double Doubles Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Fouled Out Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers Points Off Turnovers Per Game |
Points Per Game Rebounds Rebounds Per Game Second Chance Attempts Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Triple Doubles True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Team Seasonal Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game Foul Outs |
Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts Second Chance Attempts Per Game |
Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Technical Other Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Fouls Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Team Info Data Points: | Id | Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Info Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Reference Away Team Seed Number Broadcast - Cable Broadcast - Internet |
Broadcast - Network Broadcast - Radio Broadcast - Satellite Game Coverage Game Id Game Reference Game Status Game Title Home Team Alias |
Home Team Id Home Team Name Home Team Points Home Team Reference Home Team Seed Number Neutral Site Scheduled Date and Time Track on Court |
League Info Data Points: | League Alias League Id |
League Name Season Id |
Season Type Season Year |
Series Info Data Points: | Participant - Name Participant - Record Participant - Seed |
Round Series Id Series Title |
Start Date Status |
Team Info Data Points: | Alias Id |
Market | Name |
Venue Info Data Points: | Address Capacity City |
Country Description Name |
State Venue Id Zip |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Series Info Data Points: | Series Id | Series Title | Series Status |
Player Info Data Points: | First Name Full Name Jersey Number |
Last Name Player Id Position |
Primary Position Reference |
Opponent Seasonal Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game Foul Outs |
Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts |
Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Technical Other Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Fouls Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Player Seasonal Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Tech Fouls Defensive Rebounds Defensive Rebounds Per Game Double Doubles Effective Field Goal Percentage Efficiency Efficiency Per Game Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game |
Fouled Out Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minus Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Plus Points Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points Off Turnovers Points Off Turnovers Per Game |
Points Per Game Rebounds Rebounds Per Game Second Chance Attempts Second Chance Attempts Per Game Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Triple Doubles True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Team Seasonal Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Bench Points Bench Points Per Game Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Coach Ejections Coach Technical Fouls Defensive Rebounds Defensive Rebounds Per Game Effective Field Goal Percentage Efficiency Ejections Fast Break Attempts Fast Break Attempts Per Game Fast Break Made Fast Break Made Per Game Fast Break Percentage Fast Break Points Fast Break Points Per Game Field Goal Attempts Field Goal Attempts Per Game Field Goal Percentage Field Goals Made Field Goals Made Per Game Flagrant Fouls Flagrant Fouls Per Game Foul Outs |
Fouls Drawn Fouls Drawn Per Game Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Minutes Played Minutes Played Per Game Offensive Fouls Offensive Fouls Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Against Points in the Paint Points in the Paint Attempts Points in the Paint Attempts Per Game Points in the Paint Made Points in the Paint Made Per Game Points in the Paint Per Game Points in the Paint Percentage Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds Rebounds Per Game Second Chance Attempts Second Chance Attempts Per Game |
Second Chance Made Second Chance Made Per Game Second Chance Percentage Second Chance Points Second Chance Points Per Game Steals Steals Per Game Technical Fouls Technical Other Team Defensive Rebounds Team Fouls Team Offensive Rebounds Team Technical Fouls Three Point Attempts Three Point Attempts Per Game Three Point Percentage Three Points Made Three Points Made Per Game Total Fouls Total Rebounds True Shooting Attempts True Shooting Attempts Per Game True Shooting Percentage Turnovers Turnovers Per Game Two Point Attempts Two Point Attempts Per Game Two Point Percentage Two Points Made Two Points Made Per Game |
Team Data Points: | Id | Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | Conference Alias Conference Id Conference Name Division Alias |
Division Id Division Name League Alias League Id |
League Name Season Id Season Type Season Year |
Standings Data Points: | Conference Losses Conference Winning Pct. Conference Wins Division Losses Division Winning Pct. Division Wins Games Behind - Conference Games Behind - Division Games Behind - League Games Decided by 10 pts or More - Losses Games Decided by 10 pts or More - Winning Pct. Games Decided by 10 pts or More - Wins Games Decided by 3 pts or Less - Losses Games Decided by 3 pts or Less - Winning Pct. Games Decided by 3 pts or Less - Wins Home Losses Home Winning Pct. Home Wins Last 10 Games - Losses Last 10 Games - Winning Pct. Last 10 Games - Wins Last 10 Home Games - Losses |
Last 10 Home Games - Winning Pct. Last 10 Home Games - Wins Last 10 Road Games - Losses Last 10 Road Games - Winning Pct. Last 10 Road Games - Wins Overall - Losses Overall - Point Differential Overall - Points Against Overall - Points For Overall - Winning Percentage Overall - Wins Overtime Losses Overtime Winning Percentage Overtime Wins Road Losses Road Winning Percentage Road Wins Streak VS. Atlantic Div. - Losses VS. Atlantic Div. - Winning Pct. VS. Atlantic Div. - Wins VS. Central Div. - Losses |
VS. Central Div. - Winning Pct. VS. Central Div. - Wins VS. Northwest Div. - Losses VS. Northwest Div. - Winning Pct. VS. Northwest Div. - Wins VS. Pacific Div. - Losses VS. Pacific Div. - Winning Pct. VS. Pacific Div. - Wins VS. Southeast Div. - Losses VS. Southeast Div. - Winning Pct. VS. Southeast Div. - Wins VS. Southwest Div. - Losses VS. Southwest Div. - Winning Pct. VS. Southwest Div. - Wins VS. Teams Above 500 - Losses VS. Teams Above 500 - Winning Pct. VS. Teams Above 500 - Wins VS. Teams Below 500 - Losses VS. Teams Below 500 - Winning Pct. VS. Teams Below 500 - Wins |
Team Data Points: | Id Market |
Name | Reference |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Info Data Points: | Conference Alias Conference Id Conference Name |
Division Alias Division Id Division Name |
League Alias League Id League Name |
Player Info Data Points: | Abbreviated Name Birth Date Birth Place College Draft Pick Draft Round Draft Team Draft Year Experience |
First Name Full Name Height (in) Injuries - Injury Comment Injuries - Injury Description Injuries - Injury Id Injuries - Injury Start Date Injuries - Injury Status Injuries - Update Date |
Jersey Number Last Name Player Id Position Primary Position Reference Status Updated Weight (lbs) |
Team Info Data Points: | Alias Coach - Experience (Years) Coach - First Name Coach - Full Name |
Coach - Id Coach - Last Name Coach - Position Id |
Market Name Reference Year Founded |
Venue Info Data Points: | Address Capacity City |
Country Description Name |
State Venue Id Zip |
For Java, we have also provided a Stream Client to assist your integration.
Note: In the provided Java sample, replace "URL GOES HERE" with the desired Push feed URL. ```ruby require 'httpclient' module Sportradar module HTTP module Stream class Client attr_reader :url, :logger def initialize(url, publisher, logger) @url = url @logger = logger @publisher = publisher @client = ::HTTPClient.new(:agent_name => 'SportsData/1.0') end def start @thread ||= Thread.new do logger.debug "Starting loop" @client.get_content(url, :follow_redirect => true) do |chunk| @publisher.publish(::JSON.parse(chunk)) if @publisher end logger.debug "finished loop" end end def stop @thread.terminate if @thread end end end end end ``` ```java package com.sportradar.http.stream.client; import org.junit.After; import org.junit.Before; import org.junit.Test; public class StreamClientTest { private StreamClient client; private static String SERVICE_URL = "
Note: Optional query string parameters must be added after your API key with an ampersand (&). If you are filtering for more than one result, separate the results with a comma (,) and no spaces. |
Example: locale:en | | `match` | Match id expressed as: sd:match:{match_id}.
Example: sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56 | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | Return to API map ## Push Events ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba/trial/stream/en/events/subscribe?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import requests import json r = requests.get("https://api.sportradar.com/nba/trial/stream/en/events/subscribe", params = {'api_key': 'your_api_key'}, allow_redirects=False) redirect_url = r.headers['Location'] r = requests.get(redirect_url, stream=True) for line in r.iter_lines(): # filter out keep-alive new lines if line: decoded_line = line.decode('utf-8') print(json.loads(decoded_line)) ``` ```shell curl -L GET 'api.sportradar.us/nba/trial/stream/en/events/subscribe?api_key={your_api_key}' ``` >The above command returns json like this. This endpoint retrieves detailed, real-time information on every game event. https://api.sportradar.us/nba/`{access_level}`/stream/`{language_code}`/events/subscribe?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production), Trial (trial) or Simulation (simulation). | | `language_code` | Optional code for supported languages: en (English) or translations (Any other language translations. See optional query string parameters for locale.) | | `your_api_key` | Your API key. | ### Optional Query String Parameters >Example including optional query string parameters: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba/trial/stream/en/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import requests import json r = requests.get("https://api.sportradar.com/nba/trial/stream/en/events/subscribe", params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56'}, allow_redirects=False) redirect_url = r.headers['Location'] r = requests.get(redirect_url, stream=True) for line in r.iter_lines(): # filter out keep-alive new lines if line: decoded_line = line.decode('utf-8') print(json.loads(decoded_line)) ``` ```shell curl -L GET 'api.sportradar.us/nba/trial/stream/en/events/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56' ``` >Example including query string parameters for translations: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba/trial/stream/translations/events/subscribe?api_key={your_api_key}&locale=zh") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import requests import json r = requests.get("https://api.sportradar.com/nba/trial/stream/translations/events/subscribe", params = {'api_key': 'your_api_key', 'locale': 'zh'}, allow_redirects=False) redirect_url = r.headers['Location'] r = requests.get(redirect_url, stream=True) for line in r.iter_lines(): # filter out keep-alive new lines if line: decoded_line = line.decode('utf-8') print(json.loads(decoded_line)) ``` ```shell curl -L GET 'api.sportradar.us/nba/trial/stream/translations/events/subscribe?api_key={your_api_key}&locale=zh' ``` In addition to the URL parameters listed above, you can filter the Events information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&). If you are filtering for more than one result, separate the results with a comma (,) and no spaces. |
Example: event_category=shot | | `event_type` | Event type expressed as: {event_type}.
Example: event_type=stoppage | | `locale` | Locale expressed as 2 letter code: locale={language_code}
Example: locale:en | | `match` | Match id expressed as: sd:match:{match_id}.
Example: sd:match:76b2e680-7da7-461f-95ad-e7c34dbc4c56 | | `players` | Player id expressed as: sd:player:{player_id}.
Example: sd:player:c1ff3e58-266f-4183-9fa1-d7c914cf4886 | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:583eca2f-fb46-11e1-82cb-f4ce4684ea4c | Return to API map ## Push Statistics ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba/trial/stream/en/statistics/subscribe?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import requests import json r = requests.get("https://api.sportradar.com/nba/trial/stream/en/statistics/subscribe", params = {'api_key': 'your_api_key'}, allow_redirects=False) redirect_url = r.headers['Location'] r = requests.get(redirect_url, stream=True) for line in r.iter_lines(): # filter out keep-alive new lines if line: decoded_line = line.decode('utf-8') print(json.loads(decoded_line)) ``` ```shell curl -L GET 'api.sportradar.us/nba/trial/stream/en/statistics/subscribe?api_key={your_api_key}' ``` > The above command returns json like this. This endpoint retrieves detailed, real-time game stats at the team and player level for all live games. https://api.sportradar.us/nba/`{access_level}`/stream/`{language_code}`/statistics/subscribe?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `access_level` | Defines the access level of your API key as Production (production), Trial (trial) or Simulation (simulation). | | `language_code` | Optional code for supported languages: en (English) or translations (Any other language translations. See optional query string parameters for locale.) | | `your_api_key` | Your API key. | ### Optional Query String Parameters >Example including optional query string parameters: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba/trial/stream/en/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0f4a0ce6-9abb-44ac-867f-75cc2154bb40") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import requests import json r = requests.get("https://api.sportradar.com/nba/trial/stream/en/statistics/subscribe", params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:0f4a0ce6-9abb-44ac-867f-75cc2154bb40'}, allow_redirects=False) redirect_url = r.headers['Location'] r = requests.get(redirect_url, stream=True) for line in r.iter_lines(): # filter out keep-alive new lines if line: decoded_line = line.decode('utf-8') print(json.loads(decoded_line)) ``` ```shell curl -L GET 'api.sportradar.us/nba/trial/stream/en/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:0f4a0ce6-9abb-44ac-867f-75cc2154bb40' ``` >Example including query string parameters for translations: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nba/trial/stream/translations/statistics/subscribe?api_key={your_api_key}&locale=zh") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import requests import json r = requests.get("https://api.sportradar.com/nba/trial/stream/translations/statistics/subscribe", params = {'api_key': 'your_api_key', 'locale': 'zh'}, allow_redirects=False) redirect_url = r.headers['Location'] r = requests.get(redirect_url, stream=True) for line in r.iter_lines(): # filter out keep-alive new lines if line: decoded_line = line.decode('utf-8') print(json.loads(decoded_line)) ``` ```shell curl -L GET 'api.sportradar.us/nba/trial/stream/translations/statistics/subscribe?api_key={your_api_key}&locale=zh' ``` In addition to the URL parameters listed above, you can filter the Statistics information with one or more of the following optional query string parameters.
Note: Optional query string parameters must be added after your API key with an ampersand (&). If you are filtering for more than one result, separate the results with a comma (,) and no spaces. |
Example: locale:en | | `match` | Match id expressed as: sd:match:{match_id}.
Example: sd:match:0f4a0ce6-9abb-44ac-867f-75cc2154bb40 | | `player` | Player id expressed as: sd:player:{player_id}.
Example: sd:player:92ec1ed2-95f7-45da-a923-71fd541d6cdb | | `stats_type` | Stat type expressed as {stats_type}. Example: stats_type=player | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:583eca2f-fb46-11e1-82cb-f4ce4684ea4c | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | Return to API map ## Frequently Asked Questions
Q: What format are date fields presented in?
A: When we present date only values we present these in the ISO 8601 standard format.
ex: 2013-04-03
We use these for attributes that have date and no time (such as birthdate). For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What format are the date/time fields presented in?
A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601
Q: What game statuses can I expect to see in the feeds and what are their definitions?
A: Here is a list of the valid game statuses you can expect to see, and their definitions.
- scheduled - The game is scheduled to occur.
- created – The game has been created and we have begun logging information.
- inprogress – The game is in progress.
- halftime - The game is currently at halftime.
- complete – The game is over, but stat validation is not complete.
- closed – The game is over and the stats have been validated.
- cancelled – The game has been cancelled. No makeup game will be played as a result.
- delayed – The start of the game is currently delayed or the game has gone from in progress to delayed for some reason.
- postponed – The game has been postponed, to be made up at another day and time. Once the makeup game is announced, a new game and ID will be created and scheduled on the announced makeup date.
- time-tbd – The game has been scheduled, but a time has yet to be announced.
- if-necessary – The game will be scheduled if it is required.
- unnecessary – The series game was scheduled to occur, but will not take place due to one team clinching the series early.
Q: What series statuses can I expect to see in the feeds and what are their definitions?
A: Here is a list of the valid series statuses you can expect to see, and their definitions.
- scheduled – The series is scheduled to occur.
- inprogress – The series is in progress.
- closed – The series is over.
Q: What player positions can I expect to see in the feeds?
A: Here is a list of the valid player positions you can expect to see.
- NA
- C
- C-F
- F
- F-C
- F-G
- G
- G-F
Q: What player primary positions can I expect to see in the feeds?
A: Here is a list of the valid player primary positions you can expect to see.
- NA
- C
- PF
- PG
- SF
- SG
Q: What player statuses can I expect to see in the feeds?
A: Here is a list of the valid player statuses you can expect to see.
- ACT – The player is on the team’s active roster
- SUS – The player is suspended
- IR – The player is on injured reserve
- TWO-WAY - The player is on a two-way contract
- NWT – The player is no longer with the team
- FA – Free Agent
- RET – Retired
Q: What player injury statuses can I expect to see in the feeds?
A: Here is a list of the valid player injury statuses you can expect to see.
- Unknown
- Day to Day
- Out
- Out for Season
- Out Indefinitely
Q: What shot type descriptions can I expect to see in the feeds?
A: Here is a list of the valid shot types with the descriptions you can expect to see for each shot type.
Jump Shot (This is the only shot type for 3-point attempts)
- bank
- driving
- driving bank
- driving floating
- driving floating bank
- turnaround
- turnaround bank
- turnaround fadeaway
- turnaround fadeaway bank
- floating
- fadeaway
- fadeaway bank
- stepback
- stepback bank
- pullup
- pullup bank
- running
- running pullup
Layup
- alley-oop
- cutting
- cutting finger roll
- driving
- driving reverse
- driving finger roll
- finger roll
- putback
- reverse
- running
- running reverse
- running finger roll
- running alley-oop
- tip
Dunk
- alley-oop
- tip
- driving
- driving reverse
- putback
- running
- reverse
- running reverse
- running alley-oop
- cutting
Tip Shot
Hook
- bank
- driving
- driving bank
- turnaround
- turnaround bank
Q: What are the valid turnover type descriptions I can expect to see in the feeds?
A: Here is a list of the valid turnover types you can expect to see.
- Traveling
- Bad Pass
- Lost Ball
- Carrying
- Palming
- Out of Bounds
- Lost Ball
- Step
- Bad Pass
- Double Dribble
- Offensive Goaltending
- 3-second violation
- 5-second violation
- 8-second violation
- 10-second violation
- Back Court Violation
- Shot Clock Violation
- Lane Violation
- Illegal Assist
- Illegal Screen
- Turnover
- Too Many Players
- Excess Timeout
- Basket from Below
- Swinging Elbows
- Offensive Foul
- Punched Ball
- Opposite Basket
- Jump Ball Violation
- Inbound
- Discontinue Dribble
- 5-second Violation Inbound
- Kicked ball Violation
- 5-second Violation Back to the Basket
Q: What are the valid stoppage reasons I can expect to see in the feeds?
A: Here is a list of the valid stoppage reasons you can expect to see.
- Out of Bounds
- Equipment Malfunction
- Blood Rule
- Court Cleanup
- Injury
- Other
Q: What are the valid jump ball reasons I can expect to see in the feeds?
A: Here is a list of the valid jump ball reasons you can expect to see.
- Lodged Ball
- Held Ball
- Double Violation
- Unclear Pass
- Double Foul
Q: What are the valid foul type descriptions I can expect to see in the feeds?
A: Here is a list of the valid foul type descriptions you can expect to see.
- Charge
- Off the Ball
- Block
- Take
- Double
- Shooting
- Clear Path
- Loose Ball
- Blocking
- Player Control
- Shooting block
- Elbowing
- Punching
- Flagrant One
- Flagrant Two
- Away from Play
- Unsportsmanlike Conduct
- Rim Hanging
- Delay of Game
- Taunting
- Indirect
- Excess Timeout
- Too Many Players
- Inbound
- Defensive Three Second
- Flopping
Q: What are the valid free throw types I can expect to see in the feeds?
A: Here is a list of the valid free throw types you can expect to see.
- Regular
- Technical
- Flagrant
- Clear Path
Q: What ejection types can I expect to see in the feeds?
A: Here is a list of the valid ejection types you can expect to see.
- Technical
- Second Technical
- Second Flagrant Type 1
- Flagrant Type 2
- Other
Q: What game statistics are tracked real-time versus entered post game?
A: Here is a list of the game statistics that is tracked real-time. Please note, all stats are unofficial until the game is moved to the status of “Closed”.
- Assists
- Assist to Turnover Ratio
- Blocked Attempts
- Blocked Shots
- Defensive Rebounds
- Field Goal Attempts
- Field Goal Percentage
- Field Goals Made
- Flagrant Fouls
- Free Throw Attempts
- Free Throw Percentage
- Free Throws Made
- Minutes Played
- Offensive Rebounds
- Personal Fouls
- Points
- Rebounds
- Steals
- Technical Fouls
- Three Point Attempts
- Three Point Percentage
- Three Points Made
- Turnovers
- Two Point Attempts
- Two Point Percentage
- Two Points Made
Here is a list of the game statistics that entered post game.
- Fast Break Points
- Plus/Minus
- Points in the Paint
- Points Off Turnovers
- Second Chance Points
Q: Are there cases when not all game data is available?
A: Yes, in cases when Sportradar is unable to receive data from the venue, Sportradar's in-house operators will take over coverage of the game. In these cases, the following data points will not be available or will not update during the game.
- Defensive Points per Possession
- Defensive Rating
- Defensive Rebounds Percentage
- Fast Break Attempts
- Fast Break Made
- Fast Break Percentage
- Minus
- Offensive Points per Possession
- Offensive Rating
- Offensive Rebounds Percentage
- Opponent Possessions
- Plus
- Rebounds Percentage
- Second Chance Attempts
- Second Chance Made
- Second Chance Percentage
- Team Defensive Rebounds
- Team Offensive Rebounds
- Time Spent Leading
- Turnovers Percentage
After the game, when on-venue data can be received again, these fields will be updated.
Q: What is the scale of the X Y coordinates?
A: The court we use is 1128 by 600. The scale is in inches. Here is a layout of the court:
0 | X | 1128 | ||
---|---|---|---|---|
Y | ||||
600 |
Q: What x/y vertices define action areas in the x/y coordinate graph?
A: A list of areas is included below. Note that these vertices are for the left side of the court. For the right side, we use the following calculation, where length=1128 and width=600:
- right-court-point = (length - x, width - y)
- left_basket=[63, 300]
- right_basket=[1065, 300]
Areas:
- underbasket: [ 48, 252 ], [ 77, 258 ], [ 111, 300 ], [ 77, 342 ], [ 48, 348 ]
- inthepaint: [ 0, 204 ], [ 228, 204 ], [ 228, 396 ], [ 0, 396 ]
- insiderightwing: [ 0, 36 ], [ 115, 36 ], [ 77, 204 ], [ 0, 204 ]
- insideright: [ 115, 36 ], [ 225, 87 ], [ 294, 161 ], [ 225, 204 ], [ 77, 204 ]
- insidecenter: [ 225, 204 ], [ 294, 161 ], [ 324, 218 ], [ 337, 300 ], [ 324, 382 ], [ 294, 439 ], [ 225, 396 ]
- insideleft: [ 115, 564 ], [ 225, 513 ], [ 294, 439 ], [ 225, 396 ], [ 77, 396 ]
- insideleftwing: [ 0, 564 ], [ 115, 564 ], [ 77, 396 ], [ 0, 396 ]
- outsiderightwing: [ 0, 0 ], [ 122, 0 ], [ 115, 36 ], [ 0, 36 ]
- outsideright: [ 122, 0 ], [ 492, 0 ], [ 492, 69 ], [ 324, 218 ], [ 294, 161 ], [ 225, 87 ], [ 115, 36 ]
- outsidecenter: [ 324, 216 ], [ 492, 69 ], [ 492, 531 ], [ 324, 382 ], [ 337, 300 ]
- outsideleft: [ 122, 600 ], [ 492, 600 ], [ 492, 531 ], [ 324, 382 ], [ 294, 439 ], [ 225, 513 ], [ 115, 564 ]
- outsideleftwing: [ 0, 600 ], [ 122, 600 ], [ 115, 564 ], [ 0, 564 ]
- backcourt: [ 492, 0 ], [ 564, 0 ], [ 564, 600 ], [ 492, 600 ]
Q: Why does the team_basket attribution in the play-by-play feed not match the basket orientation (left vs. right) in the broadcast or game tracking that I'm viewing?
A: Our team_basket attribution is set to match the orientation of the local television broadcast, which is on the opposite side of the scorer's table. The team_basket attribution may not match the orientation used by the particular broadcast or game tracker that you are viewing.
If you want to provide a perspective from the scorer's table, you will have to map the coordinates so that the coordinates attributed to left side of the court are attributed to the right side of the court on your end (and vice versa).
Q: What are the valid events types tracked in the play by play feed?
A: Here is a list of the valid event types you can expect to see.
- clearpathfoul - <charged_to> clear path foul (<drawn_by> draws the foul)
- deadball - <given_to> rebound (deadball)
- defaultviolation - <charged_to> violation
- defensivegoaltending - <charged_to> defensive goaltending violation
- delay - <charged_to> delay of game violation
- doublelane - <charged_to> double lane violation
- ejection - <given_to> ejected from the game (<ejection_type>)
- endperiod - End of <nth period/half>
- flagrantone - <charged_to> flagrant 1 (<drawn_by> draws the foul)
- flagranttwo - <charged_to> flagrant 2 (<drawn_by> draws the foul)
- freethrowmade - <taken_by> makes <free_throw_type> free throw <attempt>
- freethrowmiss - <taken_by> misses <free_throw_type> free throw <attempt> (<charged_to> lane_violation)
- jumpball - Jump ball <reason>. <possessor> vs <challenger> (<possession> gains possession)
- jumpballviolation - <charged_to> jump ball violation
- kickball - <charged_to> kicked ball violation
- lane - <charged_to> lane violation
- lineupchange - <team_name> lineup change (<players>)
- offensivefoul - <charged_to> offensive foul (<foul_type_desc>) (<drawn_by> draws the foul)
- officialtimeout - Official timeout
- openinbound - Open inbound <team_name>
- opentip - Jump ball. <home> vs <away> (<possession> gains possession)
- personalfoul - <charged_to> personal foul (<foul_type_desc>) (<drawn_by> draws the foul)
- possession - <possession> gain possession
- rebound - <given_to> <offensive/defensive> rebound
- review - Play review (<reason>, <outcome>)
- shootingfoul - <charged_to> shooting foul (<drawn_by> draws the foul)
- stoppage - Stoppage (<reason>)
- teamtimeout - <team_name> <duration> second timeout
- technicalfoul - <charged_to> technical foul (<foul_type_desc>)
- threepointmade - <taken_by> makes three point <shot_type_desc> <shot_type> (<assisted_by> assists)
- threepointmiss - <taken_by> misses three point <shot_type_desc> <shot_type>
- turnover - <charged_to> turnover (turnover_type_desc>)
- tvtimeout - TV Timeout
- twopointmade - <taken_by> makes two point <shot_type_desc> <shot_type> (<assisted_by> assists)
- twopointmiss - <taken_by> misses two point <shot_type_desc> <shot_type>
Q: What are the valid playoff statuses and their definitions?
A: Here is a list of the valid playoff statuses and their definitions:
- conference – The team has clinched the best record home court advantage for the playoffs.
- division – The team has clinched the division.
- eliminated – The team has been eliminated from playoff contention.
- playoff_berth – The team has clinched a playoff berth.
Q: When are scores added to the schedule feeds?
A: Final scores are added to the schedule feeds when the game status changes to completed.
Q: Do you provide your feeds in any languages other than English?
A: Currently, we provide our feeds in 4 languages: English, Russian, Simplified Chinese, and Japanese. The codes are as follows:
- English: eu
- Russian: ru
- Simplified Chinese: zh
- Japanese: ja
Please note, our translated feeds include translated teams, players, and play-by-play descriptions. The feeds themselves are in English, but the content of the attributes has been translated.
Q: What are the possible values for event category used in the Push Events feed?
A: Here is a list of the valid event categories you can expect to see.
- freethrow
- freethrow,score
- foul
- foul,flagrant
- foul,warning
- lineupchange
- period,stoppage
- period,stoppage,possession
- possession
- shot
- shot,score
- stoppage
- timeout,stoppage
- turnover
- violation
Q: What are the possible values for statistics type used in the Push Events feed?
A: Here is a list of the valid statistics types you can expect to see.
- fieldgoal
- assist
- block
- attemptblocked
- rebound
- freethrow
- turnover
- steal
- personalfoul
- flagrantfoul
- technicalfoul
- ejection
- fouldrawn
- offensivefoul
Q: What formulas are used to calculate efficiency and efficiency game score?
A: Here are the formulas we use:
Efficiency: (Points + Rebounds + Assists + Steals + Blocks − Missed Field Goal Attempts − Missed Free Throw Attempts - Turnovers)
Efficiency Game Score: (Points) + (0.4*Field Goals Made) - (0.7*Field Goals Attempted) - (0.4*Free Throws Missed) + (0.7*Offensive Rebounds) + (0.3*Defensive Rebounds) + (Steals) + (0.7*Assists) + (0.7*Blocks) – (0.4*Personal Fouls) – (Turnovers)
Note: For this team efficiency calculations, statistics attributed to the team rather than a player are not counted (i.e. team rebounds, team turnovers, team fouls, etc.).
Q: What are the possible values for player – not_playing_reason?
A: Here is a list of the valid not playing reasons you can expect to see, and their descriptions.
- DNP - Coaches Decision
- DNP - Injury/Illness
- DNP - Personal
- DNP - Rest
- DNP - Trade Pending
- DNP - League Suspension
- DNP - Team Suspension
- DNP - Return to Competition Reconditioning
- DNP - Ineligible to Play
- DNP - Health and Safety Protocols
- DND - Coaches Decision
- DND - Injury/Illness
- DND - Personal
- DND - Rest
- DND - Trade Pending
- DND - League Suspension
- DND - Team Suspension
- DND - Return to Competition Reconditioning
- DND - Ineligible to Play
- DND - Health and Safety Protocols
- NWT - Coaches Decision
- NWT - Injury/Illness
- NWT - Personal
- NWT - Rest
- NWT - Trade Pending
- NWT - League Suspension
- NWT - Team Suspension
- NWT - Return to Competition Reconditioning
- NWT - Ineligible to Play
- NWT - Health and Safety Protocols
- NWT - Not With Team
- Inactive - Injury/Illness
- Inactive - Personal
- Inactive - Rest
- Inactive - Suspended
- Inactive - Trade Pending
- Inactive - Coaches Decision
- Inactive - G League Team
- Inactive - G League - On Assignment
- Inactive - G League - Two-Way
- Inactive - Not With Team
- Inactive - Team Suspension
- Inactive - League Suspension
- Inactive - Health and Safety Protocols
- Inactive - Return to Competition Reconditioning
- Inactive - NWT Return to Competition Reconditioning
- Inactive - Ineligible to Play
Docs Navigation
- Documentation
- Football (American Football)
- Football (Soccer)
- Australian Rules Football
- Baseball
- Basketball
- NBA v8
- NBA v7
- NBA v5
- NBA v4
- WNBA v8
- WNBA v7
- WNBA v4
- WNBA v3
- NBA G League v8
- NBA G League v7
- NBA G League v5
- NCAA Men's Basketball v8
- NCAA Men's Basketball v7
- NCAA Men's Basketball v4
- NCAA Men's Basketball v3
- NCAA Women's Basketball v8
- NCAA Women's Basketball v7
- NCAA Women's Basketball v3
- Global Basketball v2
- Global Basketball v1
- NBA Historical v1
- Combat Sports
- Cricket
- Editorial Content
- Golf
- Handball
- Hockey
- Images
- Insights
- Insights User Interface
- NBA Insights v1
- NHL Insights v1
- MLB Insights v1
- NFL Insights v1
- MLB Betting Splits v2
- MLB Betting Splits v1
- NBA Betting Splits v2
- NBA Betting Splits v1
- NCAAFB Betting Splits v2
- NCAAFB Betting Splits v1
- NCAAMB Betting Splits v2
- NCAAMB Betting Splits v1
- NFL Betting Splits v2
- NFL Betting Splits v1
- NHL Betting Splits v2
- NHL Betting Splits v1
- Soccer Betting Splits v2
- Soccer Betting Splits v1
- Odds
- Broadcast Graphics
- Racing
- Rugby
- Tennis
- Widgets
- Baseline Sports Coverage
- Badminton v2
- Badminton v1
- Bandy v2
- Bandy v1
- Beach Soccer v2
- Beach Soccer v1
- Curling v2
- Curling v1
- Cycling v2
- Darts v2
- Darts v1
- Field Hockey v2
- Field Hockey v1
- Floorball v2
- Floorball v1
- Futsal v2
- Futsal v1
- Pesapallo v2
- Pesapallo v1
- Snooker v2
- Snooker v1
- Squash v2
- Squash v1
- Table Tennis v2
- Volleyball (Beach) v2
- Volleyball (Beach) v1
- Volleyball (Indoor) v2
- Volleyball (Indoor) v1
- Waterpolo v2
- Waterpolo v1
- Winter Sports v1