Documentation

# Getting Started Sportradar brings together a whole conference of application programming interfaces (APIs) to give you access to all the sports data you need for your website applications and mobile apps. You can use our APIs to access sport statistics feeds, which contain all the data for leagues, conferences, teams, games, and players in our database. There are two steps to getting started with Sportradar APIs. The first is to get your API Key. This key identifies your account and application to the API and is needed for any API calls.

Get Developer Keys

Once you have your keys, you need to understand how to call the Sportradar APIs. You don't need to write any code to get started. Instead, you can use our API Sandbox to test those calls against our live sports data.

To use the API Sandbox:

1. Select the API you want to view from the dropdown.
2. Enter your API key in the field.
3. Select your desired feed and adjust the parameters to your needs.
4. Click Try It.

API Sandbox

Use the navigation to the left to select the documentation for your desired sport. Detailed documentation and code examples are included for each API endpoint. View code examples in the dark area to the right. You can switch the programming language of the examples with the tabs in the top right.

## Authentication > Below is an example call to the NFL API using API key authentication: ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-ot1/games/2006/REG/03/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", "/nfl-ot1/games/2006/REG/03/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.us/nfl-ot1/games/2006/reg/schedule.xml?api_key={your_api_key}" ``` > You must replace {your_api_key} with your API key. If you have upgraded from a trial key, be sure to change the access_level in the URL to reflect your production key. See the required parameters for the API for details. Sportradar APIs use authentication keys to allow access to the API. Each API requires its own separate key, and the key must be included in each request. To authenticate with the server, replace {your_api_key} with your API key. You can register for free API trial keys at our [developer portal](../member/register). ## Simulations At Sportradar, we strive to make sure you are ready for live games. The live simulations below give you the opportunity to test your code against a simulation of live data being entered **before** the preseason starts! Our simulation system replays select completed games and allows you to view our API feeds as if they were happening live.
### Live Data Simulations The simulations for each sport replay full games one at a time, in the order listed in the tables below. Only one simulation runs at a time, so that all available feeds update with game data as it replays. For instance when a play completes in the play-by-play feed, the seasonal statistics feed updates as well. This allows you to see how each API feed changes over the course of the game. If you need assistance in utilizing these simulations, please contact Sportradar Support.

NFL Classic Simulations

Feeds Available: Game Boxscore, Game Roster, Game Statistics, Extended Boxscore, Game Depth Chart, League Hierarchy, Play-By-Play, Schedule, Seasonal Statistics, Standings, Rankings, Injuries, Team Profile, Team Depth Chart, Weekly Schedule, Weekly League Leaders, Weekly Boxscore

Event Description	Season	Week	Example Play-By-Play Feed Path
PIT@DEN	2015/PST	2	http://api.sportradar.com/nfl-sim-t1/2015/PST/2/PIT/DEN/pbp.xml?api_key={your_api_key}
SEA@CAR	2015/PST	2	http://api.sportradar.com/nfl-sim-t1/2015/PST/2/SEA/CAR/pbp.xml?api_key={your_api_key}

NCAAFB API Simulations

Feeds Available: Weekly Schedule, Season Schedule, Game Statistics, Game Summary, Play-By-Play, Play Summary, Boxscore, Extended-Boxscore, Game Roster, Team Hierarchy, Team Roster, Standings, Seasonal Statistics

Event Description	Season	Week	Example Play-By-Play Feed Path
WKY@MSH	2015/REG	1	http://api.sportradar.us/ncaafb-sim-t1/2015/REG/1/WKY/MSH/pbp.xml?api_key={your_api_key}
KEN@FLA	2015/REG	1	http://api.sportradar.us/ncaafb-sim-t1/2015/REG/1/KEN/FLA/pbp.xml?api_key={your_api_key}
WOU@PRST	2015/REG	1	http://api.sportradar.us/ncaafb-sim-t1/2015/REG/1/WOU/PRST/boxscore.xml?api_key={your_api_key}

MLB API Simulations

Feeds Available: Game Boxscore, Game Summary, Glossary, League Depth Charts, League Hierarchy, League Leaders, League Schedule, Play-By-Play, Rankings, Seasonal Splits, Seasonal Statistics, Series Schedule, Standings, Team Depth Chart, Team Profile, Team Rosters (Full & Active), Venues

Game Description	Season	Event / Game ID	Example Play-By-Play Feed Path
SD@CHC	2016/REG	9a809ad8-df70-4809-960f-e3ac56fadf84	http://api.sportradar.us/mlb-sim5/games/9a809ad8-df70-4809-960f-e3ac56fadf84/pbp.xml?api_key={your_api_key}
PIT@CHC	2016/REG	29fb2c07-0b2f-4036-88d4-52ac92d5f657	http://api.sportradar.us/mlb-sim5/games/29fb2c07-0b2f-4036-88d4-52ac92d5f657/pbp.xml?api_key={your_api_key}

Soccer API Simulations

Feeds Available: Schedule, Match Summary, Match Boxscore, Team Hierarchy, Team Profile, Player Rankings, Standings

Match Description	League Group	Event / Match ID	Example Summary Feed Path
ARG@GER (World Cup)	WC	22653ed5-0b2c-4e30-b10c-c6d51619b52b	http://api.sportradar.us/soccer-sim2/wc/matches/22653ed5-0b2c-4e30-b10c-c6d51619b52b/summary.xml?api_key={your_api_key}

NBA API Simulations

Feeds Available: Schedule, Standings, League Hierarchy, Game Boxscore, Game Summary, Play-By-Play, Team Profile, Seasonal Statistics, Injuries

Game Description	Season	Event / Game ID	Example Play-By-Play Feed Path
ATL@CLE	2016/REG	15f9ac33-8563-4649-b55e-01f82f112806	http://api.sportradar.us/nba-sim3/games/15f9ac33-8563-4649-b55e-01f82f112806/pbp.xml?api_key={your_api_key}
GSW@CLE	2016/REG	1969289d-cbb0-490c-9987-add4058f5ea1	http://api.sportradar.us/nba-sim3/games/1969289d-cbb0-490c-9987-add4058f5ea1/pbp.xml?api_key={your_api_key}

NCAAMB API Simulations

Feeds Available: Schedule, Standings, League Hierarchy, Game Boxscore, Game Summary, Play-By-Play, Team Profile

Game Description	Season	Event / Game ID	Example Play-By-Play Feed Path
AUB@CONN (Replay of 12/23/2016)	2016/REG	50251ac4-d083-4ada-a736-67db9e894196	http://api.sportradar.us/ncaamb-sim3/games/50251ac4-d083-4ada-a736-67db9e894196/pbp.xml?api_key={your_api_key}
PUC@PAC (Replay of 12/23/2016)	2016/REG	db79b069-f4ff-4153-ab5a-86670df5d7ca	http://api.sportradar.us/ncaamb-sim3/games/db79b069-f4ff-4153-ab5a-86670df5d7ca/pbp.xml?api_key=={your_api_key}

NCAAWB API Simulations

Feeds Available: Schedule, League Hierarchy, Game Boxscore

Game Description	Season	Event / Game ID	Example Play-By-Play Feed Path
ND@CONN	2014/pst	bce4735f-2b3c-458d-bad5-0d3ff118738d	http://api.sportradar.us/ncaawb-sim3/games/bce4735f-2b3c-458d-bad5-0d3ff118738d/boxscore.xml?api_key={your_api_key}

NHL Classic API Simulations

Feeds Available: Schedule, Standings, Rankings, League Hierarchy, Team Profile, Injuries, Game Boxscore, Game Summary, Play-By-Play, Seasonal Stats

Game Description	Season	Event / Game ID	Example Play-By-Play Feed Path
SJ@TB	2014/reg	bce17fed-0ed9-4ebb-ad96-6c89dbd13b3a	http://api.sportradar.us/nhl-sim3/games/bce17fed-0ed9-4ebb-ad96-6c89dbd13b3a/pbp.xml?api_key={your_api_key}
BOS@MTL	2014/reg	529752cf-e51a-40a8-8aee-5208da2debcb	http://api.sportradar.us/nhl-sim3/games/529752cf-e51a-40a8-8aee-5208da2debcb/pbp.xml?api_key={your_api_key}

Olympics API Simulations

Feeds Available: Entry List, Event Results, Medals (By Event), Organization List, Schedule

Event Description	Event / Game ID	Example Results Feed Path
Women's Sync. 3m Springboard Final	8da75b91-f972-4d24-90d9-1948335dc90e	http://api.sportradar.us/oly-sim2/event/8da75b91-f972-4d24-90d9-1948335dc90e/results.xml?api_key={your_api_key}

Golf API Simulations

Feeds Available: Tournament Schedule, Tournament Summary, Tournament Leaderboard, Tournament Hole Statistics, Tee Times Per Round, Scorecards Per Round, Player Statistics

Tournament Description	Season	Tournament ID	Round	Example Leaderboard Feed Path
Masters (Actual Event)	2014	a42bd0ff-4fdf-4eee-8ded-ab2e05a54fa6	2	http://api.sportradar.us/golf-sim-t2/leaderboard/pga/2014/tournaments/a42bd0ff-4fdf-4eee-8ded-ab2e05a54fa6/leaderboard.xml?api_key={your_api_key}
Scottish Open Simulation	2015	57bdb770-e0b5-4344-ac24-21e059e1219e	all	http://api.sportradar.us/golf-sim-pga2-t2/leaderboard/pga/2015/tournaments/57bdb770-e0b5-4344-ac24-21e059e1219e/leaderboard.xml?api_key={your_api_key}
Masters Simulation	2015	a2576743-9b52-41b8-be69-b16e73d3b94e	all	http://api.sportradar.us/golf-sim-pga1-t2/leaderboard/pga/2015/tournaments/a2576743-9b52-41b8-be69-b16e73d3b94e/leaderboard.xml?api_key={your_api_key}

## Reporting ### How to generate a report for an API key

1. Sign in to your account.
2. Click on My Account.
3. Scroll to the API key that you would like to see reporting for.
4. Click View Report.

The report is generated. There may be processing time required while the report is created. Our key usage reports are based on the calls made within a rolling 30-day period, which changes daily. We do not track usage based on a calendar month, or set days, but rather the past 30 days from the current moment. ## FAQs ### What is an API request? API stands for "Application Programming Interface." Basically, an API is how computers talk to each other to share data. Web applications will request data through an API, with the path and parameters provided defining what data is returned. ### How do I get started sampling feeds? You can get access to our complete set of data feeds by following these steps:

1. Register for a user account
2. Register your application
3. Navigate to My Account
4. Select Get API Keys

### When does my trial API key run out? Trial API keys will last for 90 days. However, we are willing to work with our prospective customers to allow ample time to sample all of our data feeds. ### How many requests can I make with my trial API keys? Each trial key is specific to a single sport and is limited to 1,000 total calls over a rolling 30 day period. ### How do I get access to a higher number of API requests? Contact our sales group and they will work with you to provide the access level you need to evaluate our products. ### Will I be able to see all the data with my trial API key? A trial key allows you access to the same data as is made available with a production key. A trial key allows you less calls per month as well as less calls per second rate or throttle limit compared to the other tiers. The data itself is not throttled or updated at a lesser frequency between trial and production access levels. ### Where do I find feed documentation? We have two types of feed documentation. For product managers evaluating our coverage, our documentation page has detailed documents outlining every data point included in each feed. For developers parsing our feeds, we provide XSD files in our API gallery. ### Why do you base your pricing tiers on the number of API requests I make? The sports media and fantasy sports industries place a premium on update speed, so we have made substantial investments to generate real-time data feeds. We price our product tiers based on the frequency a customer pulls from these real-time feeds. ### How many API requests do I need? On our pricing page there is a table that provides the number of monthly requests needed to update a single feed at various frequencies. We will work with you to determine the appropriate number of API requests you need to meet your product requirements. ### What happens when I exceed my allocated number of requests? We use two forms of rate limiting for each API we provide. First, depending on your contract level, we limit how many calls per second we accept from a particular account key to prevent overloading the API from a burst of activity. If you exceed this limit, you will receive an HTTP/1.1 403 error ("Forbidden - Account Over Queries Per Second Limit") until the next second begins. Second, we specify how many calls each account key can make over a month. If you exceed this limit, we return a 403 error ("Forbidden - Account Over Rate Limit"). It is up to customers to monitor their contracted API usage. ### Why is one sport more expensive than another? There are two main factors which dictate sport pricing. The first factor is our costs. For example, NFL data collection requires more live data analysts than do other sports to capture all the relevant game action. Another example of a more costly sport is MLB, which has a significant number of games to collect data from each month. The second factor is the value of the data in the marketplace. Media and fantasy companies typically generate more revenue on NFL and MLB data, than on NBA and NHL. ### Will I be charged a fee during the off-season months? No, you will only be charged a licensing fee during the months in which teams play games for a given sport. ### Are the monthly fees the same during the preseason, postseason or any months with fewer games? Yes, the monthly costs are generally lower during months in which there are fewer games. We do not have standard rates for those months, however, as many customers require data during months where there are a mix of pre-season/regular or regular/postseason, while others may only want postseason data. We work with each customer to determine a fair price for these months. ### Do I need separate keys for different versions of your APIs? Yes, each version of our APIs require different keys (e.g., MLB v1 and MLB v2 require separate keys). If you currently have a key to an API that has a new version released, we will create a key for you as part of the new version release. This new key can be viewed on the My Account page when you login to the Sports Data API Portal and will have the same request limits as your key to the previous version. When a new version is created, Sports Data support will send a notification to the email address used to register with our Portal. To view the current versions of all of our APIs, please visit our API Gallery page. ### Do I need separate keys for different NFL seasons? No, with our NFL API, there is no need to have different keys for the preseason, regular season and postseason stats. Your key will allow access to every season by simply adjusting the request path. Please consult the NFL API documentation for further details. ### Does Sportradar US have a data quality team to ensure accurate data? We do have a quality team - it is modeled much like a "pit boss" structure you would see in a casino. There are multiple layers of validation (checked against multiple public sources) to make sure that each stat is spot-on with the official league statistic. The data entry analyst has a "pit-boss" that typically has about 6 events he or she monitors. The "pit-boss" validates that the data is matching public sources in a timely manner and addresses issues immediately. There is then a supervisor who is checking on all the pit-bosses to make sure their games are tight as well (and then is available to address any scoring issues or concerns). We automate as much of this process as possible so that the validation (and alerts) highlight inconsistencies quickly and aggressively. The validation process is both automated and checked with human fail-safes to make sure we provide the highest quality possible. ### When are NCAA Football polls and game coverage levels set? The update schedule for college football during the season is:

• FBS Polls update: 3:00pm CT Sundays
• FCS Polls update: 3:00pm CT Mondays
• College Football Playoff Rankings is Created for the Week's Games (9pm CT Tuesdays - beginning in week 10)
• Schedule updates: Continuous and reviewed 7 days before

### When are NFL injuries and transactions updated for NFL Classic? The injuries, depth charts and transactions are updated on the following schedule through the regular season and postseason: In-Season: For Thursday night games injury reports are published with practice status for M, Tu, W, with Game Statuses attached to the W report.
Friday report reflects official status for upcoming Saturday/Sunday game: Out, Doubtful, or Questionable. Note: The status "probable" is no longer used as of the 2016 season.
For Saturday/Sunday games injury reports are published with practice status for W, Th, F with Game Statuses attached to the F report.
For Monday night games injury reports are published with practice status for Th, F, Sa with Game Statuses attached to the Sa report.
Note that it is possible, but not common, for there to be late additions to the injury report the day before the game.
Trades/transactions: Daily, noon and midnight CT
Depth charts: Same as injuries. Note: Depth Charts are not considered Official.

To get injury information BEFORE Friday night when the games are initialized and the official game injury is posted on Friday night, you will need to iterate through all of the teams (use the hierarchy feed against the roster feed) to pull out all of the currently rostered players practice and injury status (it is always up to date). These are updated each day using a variety of sources for completeness. ### Using NFL Classic, when I try to access an NFL game a few weeks out the URLS appear to be broken even though they are valid. Why? When we initialize a particular game we are creating the roster, depth charts and injuries for that specific game. Until this initialization process is complete - these links appear broken. For the NFL Thursday game, we will initialize the game no later than the night before the game at 11:59pm CT, with injury updates and rosters. Sunday games are initialized on Friday night, no later than 11:59pm CT. Friday night, when the NFL releases the OFFICIAL status - we make our updates, THEN create the games so we have the updated injury and roster status for each game going into the weekend - again as part of the permanent record for the game. Of course, we are updating on Saturday as information becomes available - but generally additional updates mostly are coming in closer to game time. Monday Night games are initialized Saturday night, no later than 11:59 CT. ### When are NFL Classic stats made official? Post game, Sportradar US reviews all statistics and validates that they match official NFL stats. In the game node, the status attribute will change from "inprogess" to "complete" when the game is over. Once the stats have been validated against the league site, the status will change to "closed". This process will be completed within an hour of the end of the game. It is worth noting that game statistics are often updated during the week (game and seasonal) to correct errors. Sportradar US monitors these changes and updates daily. ### When is NFL Classic player participation data updated? Player participation data (found in the Game Roster feed) is updated within an hour after a game is completed. ### For NCAA Football, what defensive stats do you provide? For "Full" coverage games, we provide INT and Sacks. For "Extended Boxscore" coverage we do not provide defensive stats at this time. ### Which NCAA Football games will be covered live this season? We provide two tiers of NCAA Football coverage. The coverage level for each game can be found in the Weekly and Season Schedule feeds, in the attribute "coverage", under the "game" element. The valid settings are "full," and "extended_boxscore". "Full" coverage will be provided for any game involving an FBS team which is available via a reliable broadcast. This will include live play-by-play, live player stats and live game scores. "Extended Boxscore" coverage will be provided for all FCS games, as well as any game involving an FBS team not available via a reliable broadcast. This will include game scores, updated every 3-5 minutes. Please 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 or technical difficulties. ### Which feeds will be included with each NCAAFB coverage level? For all full coverage games, all game centric feeds are available in real time. These include the boxscore, extended boxscore, play by play, play summary, game statistics, etc. For all extended boxscore games, the play-by-play and play summary feeds are not available. The boxscore and extended boxscore feeds are typically updated every 3-5 minutes. The game statistics and game summary feeds are available within 60 minutes of the official results being posted. ### For NFL Classic and NCAAFB games, do the game IDs change? These are the guidelines our live data entry team follows for NCAAFB and NFL:

• If a game is rescheduled or postponed for a day/time in the same week, the day and time are updated, and the id stays the same.
• If a game is rescheduled or postponed for a day/time that is in a different week, the game is recreated, causing the current game to be removed from the schedule and a new id generated for the game in the destination week.

Our recommendation is to frequently parse the schedule feeds storing info as you do now, and then comparing what you have stored to what is in the feed. If you see an ID that is removed for a given week, you can consider that game not available or moved. ### For MLB, what is the process for games that are delayed, postponed, etc.? For MLB games, especially early in the season, weather delays and game postponements are a common occurrence. Click here for a diagram that details how our process works for various types of game delays and movements. ### When will the initial March Madness schedule be available? The initial March Madness schedule will be available within 2 hours after the completion of the Selection Sunday show. Click here for a sample of how the initial schedule will look.