NCAA Men's Basketball v7
Quick Access | |
Postman Collection | XSD Schema |
Download |
- Player profiles
- Team rosters
- Top 25 rankings
- Seasonal statistics
- In-game substitution info
- Live event positional data
API | API Version | Data Entry Workflow |
NCAA Men's Basketball | v7 | Data Entry Workflow |
Note: Authentication is required for all API calls. |
Examples:
>To find a team's leader in assists for a given game: >- Call the schedule or daily 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: Tournament Ids are only listed in the Tournament List feed. Use the Tournament List to get the Ids required to access the Tournament Schedule and Tournament Summary. |
Note: All early season tournament games as well as all conference tournament games, available via a reliable broadcast, will be done via our full coverage offering. |
Note: Coverage levels may be adjusted up to the scheduled start time at the discretion of our data entry managers for such reasons as resource availability as well as possible broadcast and technical difficulties. |
All tournament games are included, with team
id
and seed
omitted for TBD matchups. Teams are promoted to the next round within 10 minutes of complete
status (when a game has ended and the final score confirmed) of the prior game.
Tournament_Schedule - Tournament Summary
Completed Bracket
You can reference a completed Division I Tournament bracket here and here.
### Live Tournament Coverage
Men’s: All games are covered via “full” coverage with substitution data. Realtime data includes:
- Full play-by-play
- Team statistics
- Player statistics (including player minutes and plus/minus)
- Full play-by-play
- Team statistics
- Player statistics (no realtime player minutes or plus/minus)
complete
status (when a game has ended and the final score confirmed) of the prior game.
Tournament Statistics:
Team statistics will be updated in the Tournament Statistics feed within 20 minutes after a game goes to closed
status.
On average, it takes about 30 minutes to close a men’s game. As a result, on average, it takes approximately an hour for team statistics to update after a game ends.
### March Madness FAQ
Q: How do I know the order or position (top left, bottom left, etc) in the bracket for each region?
A: In the Tournament Summary feed, each region has a rank
value. The region's position in the bracket is based on that rank value.
* Top Left Quadrant: Regional Rank = 1 - South Regional in Example Provided
* Bottom Left Quadrant: Regional Rank = 4 - West Regional in Example Provided
* Top Right Quadrant: Regional Rank = 2 - East Regional In Example Provided
* Bottom Right Quadrant: Regional Rank = 3 - Midwest Regional in Example Provided
The region rank value will be populated as soon as each number 1 seed is announced (top 4 overall seeds in the tournament) at the start of the Selection Sunday show.
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Data Point: | Id | Last Modified | |
League Data Point: | Alias Id |
Name | Season Id |
Player Data Points: | Full Name | Id | Last Modified |
Team Data Points: | Id Last Modified |
Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Seed Number Broadcast - Cable Broadcast - Internet Broadcast - Network |
Broadcast - Radio Broadcast - Satellite Conference Game Daily Schedule Date Game Coverage Game Id Game Status Game Title |
Home Team Alias Home Team Id Home Team Name Home Team Points Home Team Seed Number Neutral Site Scheduled Date and Time |
League Data Points: | League Alias | League Id | League Name |
Venue Data Points: | Address Capacity City |
Country Description Name |
State Venue Id Zip |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Boxscore Data Points: | Attendance Away Team Bonus Flag Away Team Double Bonus Flag Away Team Game Score Away Team Half Score Away Team Id Away Team Market Away Team Name Away Team Overtime Score Away Team Rank Away Team Timeouts Remaining Half Number |
Half Sequence Home Team Bonus Flag Home Team Double Bonus Flag Home Team Flag Home Team Game Score Home Team Half Score Home Team Id Home Team Market Home Team Name Home Team Overtime Score Home Team Rank Home Team Timeouts Remaining |
Lead Changes Overtime Number Overtime Sequence Possession Arrow Team Assists Leader - Player Full Name Team Assists Leader - Player Id Team Points Leader - Player Full Name Team Points Leader - Player Id Team Rebounds Leader - Player Full Name Team Rebounds Leader - Player Id Times Tied |
Game Data Points: | Away Team Id Conference Game Game Clock Game Coverage |
Game Half Game Id Game Status Game Title |
Home Team Id Neutral Site Scheduled Date And Time |
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 Ejections 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 Percentage Points in the Paint Made Points Off Turnovers Rebounds |
Second Chance Points Steals Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Triple Double True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Made |
Player Data Points: | Full Name Id |
Jersey Number Position |
Primary Position |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Boxscore Data Points: | Attendance Away Team Bonus Flag Away Team Double Bonus Flag Away Team Game Score Away Team Half Score Away Team Id Away Team Market Away Team Name Away Team Overtime Score Away Team Rank Away Team Timeouts Remaining Half Number |
Half Sequence Home Team Bonus Flag Home Team Double Bonus Flag Home Team Flag Home Team Game Score Home Team Half Score Home Team Id Home Team Market Home Team Name Home Team Overtime Score Home Team Rank Home Team Timeouts Remaining |
Lead Changes Lineup Active for Game Lineup Ejected Lineup Fouled Out Lineup Played Lineup Started Overtime Number Overtime Sequence Possession Arrow Times Tied |
Game Data Points: | Away Team Id Conference Game Entry Mode Game Clock |
Game Coverage Game Half Game Id Game Status |
Game Title Home Team Id Neutral Site Scheduled Date And Time |
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 Ejections 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 Percentage Points in the Paint Made Points Off Turnovers Rebounds |
Second Chance Points Steals Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Triple Double True Shooting Attempts True Shooting Percentage Turnovers 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 Technical Fouls Defensive Rebounds Effective Field Goal Percentage Efficiency Efficiency Game Score Ejections 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 Minutes Played Most Unanswered - Own Score Most Unanswered - Opponent Score Most Unanswered - Points Offensive Fouls Offensive Rebounds Personal 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 Rebounds |
Second Chance Points Steals Team Rebounds Team Turnovers Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Total Player Technical Fouls True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Made |
Player Period Statistics Data Points: | Assists Assists To Turnover Ratio Blocked Attempts Blocked Shots Defensive Rebounds 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 Id Minutes Played Number Offensive Fouls Offensive Rebounds Personal Fouls Plus/Minus Points Points in the Paint Points in the Paint Attempts Points in the Paint Percentage Points in the Paint Made Points Off Turnovers Rebounds |
Second Chance Points Sequence Steals Technical Fouls Three Point Attempts Three Point Percentage Three Points Made True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Made Type |
Team Period Statistics Data Points: | Assists Assists To Turnover Ratio Bench Points Biggest Lead Blocked Attempts Blocked Shots Coach Technical Fouls Defensive Rebounds 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 Id Minutes Played Number Offensive Fouls Offensive Rebounds Personal 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 Rebounds |
Second Chance Points Sequence Steals Team Rebounds Team Turnovers Technical Fouls Three Point Attempts Three Point Percentage Three Points Made Total Player Technical Fouls True Shooting Attempts True Shooting Percentage Turnovers Two Point Attempts Two Point Percentage Two Points Made Type |
Player Data Points: | First Name Full Name Id |
Jersey Number Last Name |
Position Primary Position |
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: | Conference Alias Conference Id Conference Name |
Division Alias Division Id Division Name |
League Alias League Id League Name |
Team Data Points: | Alias Id |
Market | Name |
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: | Season Id | Season Type | Season Year |
League Leaders Data Points: | Assists Assists Per Game Blocked Shots Blocked Shots Per Game Category Name Category Type Field Goal Percentage Free Throw Percentage Minutes Played |
Minutes Played Per Game Offensive Rebounds Personal Fouls Personal Fouls Per Game Player Rank Points Points Per Game Rebounds Rebounds Per Game |
Stat Category Steals Steals Per Game Three Point Percentage Tied Flag Turnovers Turnovers Per Game Two Point Percentage |
Player Data Points: | First Name Full Name Id |
Jersey Number Last Name |
Position Primary Position |
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 Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Per Game Rebounds |
Rebounds 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 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 | ||
Boxscore Data Points: | Attendance Away Team Bonus Flag Away Team Double Bonus Flag Away Team Game Score Away Team Half Score Away Team Id Away Team Market Away Team Name Away Team Overtime Score Away Team Rank |
Away Team Timeouts Remaining Half Number Half Sequence Home Team Bonus Flag Home Team Double Bonus Flag Home Team Flag Home Team Game Score Home Team Half Score Home Team Id Home Team Market |
Home Team Name Home Team Overtime Score Home Team Rank Home Team Timeouts Remaining Lead Changes Overtime Number Overtime Sequence Possession Arrow Times Tied |
Game Data Points: | Away Team Id Conference Game Game Clock Game Coverage |
Game Half Game Id Game Status Game Title |
Home Team Id Neutral Site Scheduled Date And Time |
Play-By-Play Data Points: | Attributed Basket Team is Defending Attributed Team Id Attributed Team Market Attributed Team Name Event Attempt Event Away Points Event Clock Event Description Event Home Points Event Id Event Location X Coordinate Event Location Y Coordinate Event Participants Player Full Name Event Participants Player Id Event Participants Player Jersey Number Event Participants Team Id |
Event Participants Team Market Event Participants Team Name Event Sequence 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 Half Id Half Number |
Half Sequence 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 Possession Team Id Possession Team Market Possession Team Name Rebound Rebound Type |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Data Points: | League Alias League Id |
League Name Season Id |
Season Type Season Year |
Player Data Points: | Abbreviated Name Birth Place Experience First Name |
Full Name Height (in) Id Jersey Number |
Last Name Position Primary Position Status Updated Weight (lbs) |
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 Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Per Game Rebounds |
Rebounds 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 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: | Alias Id |
Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Rankings Data Points: | Effective Time First Place Votes Overall - Losses Overall - Wins Poll Alias |
Poll Id Poll Name Poll Points Poll Rank |
Previous API Rank Votes Week Year |
Team Data Points: | Id | Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Rankings Data Points: | Effective Time First Place Votes Overall - Losses Overall - Wins Poll Alias |
Poll Id Poll Name Poll Points Poll Rank |
Previous API Rank Votes Week Year |
Team Data Points: | Id | Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Data Points: | Season Id | Season Type | Season Year |
Rankings Data Points: | Adjusted Winning Pct Away Losses Away Wins Current API Rank Home Losses Home Wins Neutral Site Losses Neutral Site Wins Opponent’s Losses Opponent’s Wins |
Opponent’s Opponent’s Winning Pct Opponent’s Winning Pct Opponent’s Ranked 1-25 – Losses Opponent’s Ranked 1-25 – Wins Opponent’s Ranked 1-50 – Losses Opponent’s Ranked 1-50 – Wins Opponent’s Ranked 101-150 – Losses Opponent’s Ranked 101-150 – Wins Opponent’s Ranked 151+ – Losses Opponent’s Ranked 151+ – Wins |
Opponent’s Ranked 26-50 – Losses Opponent’s Ranked 26-50 – Wins Opponent’s Ranked 51-100 – Losses Opponent’s Ranked 51-100 – Wins Opponent’s RPI Rank (Range) Overall - Losses Overall - Wins Previous RPI Rank RPI Rating Strength of Schedule |
Team Data Points: | Id | Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Data Points: | Away Team Alias Away Team Id Away Team Name Away Team Points Away Team Seed Number Broadcast - Cable Broadcast - Internet |
Broadcast - Network Broadcast - Radio Broadcast - Satellite Conference Game Game Coverage Game Id Game Status Game Title |
Home Team Alias Home Team Id Home Team Name Home Team Points Home Team Seed Number Neutral Site Scheduled Date and Time |
League Data Points: | League Alias League Id |
League Name Season Id |
Season Type Season Year |
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: | Season Id | Season Type | Season Year |
Player Data Points: | First Name Full Name Id |
Jersey Number Last Name |
Position Primary Position |
Opponent Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
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 Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points In the Paint Points in the Paint Per Game Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds |
Rebounds Per Game 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 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 Season Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Per Game Rebounds |
Rebounds 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 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 Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
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 Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points In the Paint Points in the Paint Per Game Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds |
Rebounds Per Game 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 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: | League Alias League Id League Name Season End Date |
Season Id Season Start Date Season Status |
Season Type Code Season Type Name Season Year |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Data Points: | Conference Alias Conference Id Conference Name |
League Alias League Id League Name |
Season Id Season Type Season Year |
Standings Data Points: | Games Behind Conference Overall Losses Overall Point Differential Overall Points Against |
Overall Points For Overall Winning Percentage Overall Wins Records Record Type |
Records Wins Records Losses Records Win Percentage Streak Subdivision |
Team Data Points: | Id | Market | Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
League Data Points: | Conference Alias Conference Id Conference Name |
Division Alias Division Id Division Name |
League Alias League Id League Name |
Player Data Points: | Abbreviated Name Birth Place Experience First Name |
Full Name Height (in) Jersey Number Last Name |
Player Id Position Primary Position Status Updated Weight (lbs) |
Team Data Points: | Alias Coach Experience Coach First Name Coach Full Name |
Coach Id Coach Last Name Coach Position |
Id Market Name |
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 Season Id |
Season Type Season Year |
Tournament Data Points: | End Date Start Date |
Status Tournament Id |
Tournament Location Tournament Name |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Game Data Points: | Away Team Previous Tournament Game Away Team Away Team Previous Tournament Game Coverage Away Team Previous Tournament Game Home Team Away Team Previous Tournament Game Id Away Team Previous Tournament Game Outcome Away Team Previous Tournament Game Scheduled Date and Time Away Team Previous Tournament Game Status Away Team Previous Tournament Game Title Away Team Alias Away Team Id Away Team Name Away Team Points |
Away Team Seed Number Broadcast Cable Broadcast Internet Broadcast Network Broadcast Radio Broadcast Satellite Conference Game Game Coverage Game Id Game Status Game Title Home Team Previous Tournament Game Away Team Home Team Previous Tournament Game Coverage |
Home Team Previous Tournament Game Home Team Home Team Previous Tournament Game Id Home Team Previous Tournament Game Outcome Home Team Previous Tournament Game Scheduled Date and Time Home Team Previous Tournament Game Status Home Team Previous Tournament Game Title Home Team Alias Home Team Id Home Team Name Home Team Points Home Team Seed Number Neutral Site Scheduled Date and Time |
League Data Points: | League Alias | League Id | League Name |
Tournament Data Points: | Bracket Id Bracket Location Bracket Name Round Id |
Round Name Round Sequence Tournament Status |
Tournament Id Tournament Location Tournament Name |
Venue Data Points: | Address Capacity City |
Country Description Name |
State Venue Id Zip |
Update Frequency: | As Necessary | ||
Content Type: | XML or JSON | ||
Tournament Data Points: | Tournament Status Tournament Id |
Tournament Location | Tournament Name |
Player Data Points: | First Name Full Name Id |
Jersey Number Last Name |
Position Primary Position |
Opponent Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
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 Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points In the Paint Points in the Paint Per Game Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds |
Rebounds Per Game 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 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 Season Statistics Data Points: | Assists Assists Per Game Assists to Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
Free Throw Attempts Free Throw Attempts Per Game Free Throw Percentage Free Throws Made Free Throws Made Per Game Games Played Games Started Minutes Played Minutes Played Per Game Offensive Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points Per Game Rebounds |
Rebounds 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 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 Season Statistics Data Points: | Assists Assists Per Game Assists To Turnover Ratio Blocked Attempts Blocked Attempts Per Game Blocked Shots Blocked Shots Per Game Defensive Rebounds Defensive Rebounds Per Game Efficiency Efficiency Per Game Ejections 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 |
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 Rebounds Offensive Rebounds Per Game Personal Fouls Personal Fouls Per Game Points Points In the Paint Points in the Paint Per Game Points off Turnovers Points off Turnovers Per Game Points Per Game Rebounds |
Rebounds Per Game 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 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 | ||
Team Information Data Points: | Id Market |
Name | Seed |
Tournament Data Points: | Bracket Id Bracket Location Bracket Name |
End Date Start Date Status |
Tournament Id Tournament Location Tournament Name |
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: 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:d613a22d-91aa-451a-8148-fcff2a5970cc | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:2ed86226-3fff-4083-90fa-6b02307e6f73 | Return to top ## Push Statistics ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/ncaamb/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/ncaamb/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/ncaamb/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/ncaamb/`{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) or Trial (trial)| | `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/ncaamb/trial/stream/en/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:71225e0b-8477-408b-a424-edeff07a81b4") 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/ncaamb/trial/stream/en/statistics/subscribe", params = {'api_key': 'your_api_key', 'status': 'inprogress', 'match': 'sd:match:71225e0b-8477-408b-a424-edeff07a81b4'}, 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/ncaamb/trial/stream/en/statistics/subscribe?api_key={your_api_key}&status=inprogress&match=sd:match:71225e0b-8477-408b-a424-edeff07a81b4' ``` 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:d613a22d-91aa-451a-8148-fcff2a5970cc | | `player` | Player id expressed as: sd:player:{player_id}.
Example: sd:player:7f2291a6-298b-44ce-9dde-21894f386fd3 | | `status` | Status type expressed as: inprogress or created.
Example: status=inprogress | | `stats_type` | Stat type expressed as {stats_type}. Example: stats_type=player | | `team` | Team id expressed as: sd:team:{team_id}.
Example: sd:team:2ed86226-3fff-4083-90fa-6b02307e6f73 | Return to top ## 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. You should request the scheduled feed(s) regularly to identify the re-scheduled makeup game(s).
- 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: Are on-court players available for play-by-play events?
A: On-court player data is only available for selected full coverage games:
- Selected Associated Press Top 25 regular season games
- Selected conference tournament games
- All March Madness games
If “track_on_court” has a value of “true,” on-court player data will be available for that game.
Q: Do full coverage games and extended boxscore games contain the same set of statistics?
A: No. We do not support the following statistics for extended boxscore games:
- Biggest Lead
- Coach Technical Fouls
- Fouls Drawn
- Most Unanswered Points
- Most Unanswered Points Own Score
- Most Unanswered Points Opponent Score
- Offensive Fouls
- Points in the Paint Attempts
- Points in the Paint Made
- Points in the Paint Percentage
- Team Technical Fouls
Q: What are the Period Types I can expect to see in the feeds?
A: Here is a list of the valid period types you can expect to see:
- half
- overtime
- quarter
Q: What are the player experience values I can expect to see in the feeds?
A: Here is a list of the valid player experience values and their definitions:
- FR – Freshman
- SO – Sophomore
- JR – Junior
- SR – Senior
- GR – Graduate Student
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: Are game statistics available for all teams during the regular season?
A: Game statistics are available for all Division I teams, regardless of the coverage level on the game. However, game statistics will only be available for non-Division I teams if the game is covered via our full coverage offering.
Q: Are seasonal statistics available for all teams during the regular season?
A: Seasonal statistics are available for all Division I teams.
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
- NWT – The player is no longer with the team
- SUS – The player is suspended
Q: What are the valid season types?
A: Here is a list of the valid season types and their definition:
- reg – Regular season
- ct – Conference tournaments
- pst – Post-season
Q: What post-season national tournaments do you cover?
A: We will be covering the NCAA National Tournament (March Madness), the CBI, and the NIT. Here are the planned coverage levels for these tournaments:
- March Madness – All games will be covered live via full coverage.
- CBI – All games covered live, via Extended Boxscore coverage.
- NIT – All games covered live, via Extended Boxscore coverage.
- CIT – All games covered live, via Extended Boxscore coverage.
Q: How are you covering the new experimental rules for the 2016-17 NIT (National Invitational Tournament)?
A: When a team reaches the double bonus during a half, a "double bonus" attribute appears in the Play-By-Play, Game Summary, and Game Boxscore feeds with a value of "true." When the fouls reset at halftime or at the 10:00 mark of the half, the double bonus attribute is removed from these feeds. If a team reaches the double bonus again, the double bonus attribute will reappear with a value of true.
During the 2016-17 NIT, the “bonus” attribute will not be used.
Q: How do you plan to cover the conference tournaments games?
A: All conference tournament games, available via a reliable broadcast, will be done via our full coverage offering.
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: 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)
- defensivethreeseconds - <charged_to> defensive 3 seconds violation
- delay - <charged_to> delay of game violation
- ejection - <given_to> ejected from the game
- 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)
- kickball - <charged_to> kicked ball violation
- minortechnicalfoul - <player_name> technical foul
- offensivefoul - <charged_to> offensive foul (<drawn_by> draws the foul)
- officialtimeout - Official timeout
- openinbound - Open inbound <team_name>
- opentip - <home> vs <away> (<possession> gains possession)
- personalfoul - <charged_to> personal foul (<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)
- 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>> or <blocked_by> blocks <taken_by> 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> or <blocked_by> blocks <taken_by> two point <shot_type_desc> <shot_type>
- warning
Q: When we will the NCAA Tournament schedule be available?
A: The initial release of the NCAA Tournament schedule will be released within 2 hours of the completion of the Selection Sunday telecast. Here is a sample of how the schedule will look on Selection Sunday. Please note, this is based on the 2013 NCAA Tournament: https://developer.sportradar.us/files/ncaamb_selection_sunday_example.xml
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: What are the possible values for record type?
A: Any conference alias can be used as a record type for win/loss records. In addition, we track the following record types:
- Below 500 - Win/Loss record against teams with a winning percentage below .500
- Conference - Win/Loss record against team’s own conference
- Home - Win/Loss record for team’s home games
- Last 10 - Win/Loss record in team’s last 10 games
- Last 10 Home - Win/Loss record in team’s last 10 home games
- Last 10 Away - Win/Loss record in team’s last 10 away games
- Over 500 - Win/Loss record against teams with a winning percentage above .500
- Overtime - Win/Loss record for overtime games
- Road - Win/Loss record for team’s road games
- Ten Points - Win/Loss record for games decided by 10 or less points
- Three Points – Win/Loss record for games decided by 3 or less points
- Top 25 - Win/Loss record against teams who were in Associated Press Top 25 when the game took place
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: How are home/away team designations determined for neutral-site games, and are those designations consistent across Sportradar products?
A: In the NCAAMB API, there are no "official" home/away designations for neutral-site games. For neutral-site games, we set the neutral-site value to "true".
As a result, this game will count towards Washington's and Colorado's neutral-site record and not their respective home and away records. In the NCAAMB API, we use the home/away team designations present when we initially ingest the schedules. We will not change the home/away designations after the schedule is initially published. This does not apply to games that have been changed from a neutral-site game to a traditional home/away game, we may change home/away team designations in these cases. Since other Sportradar products may publish schedules at different times and use different fixture management workflows, they may (for neutral-site games) display different home/away team designations.
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
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
- Betting Insights
- Odds
- 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
- Cycling v1
- 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