NAV
cURL Ruby Python

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:

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
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"))
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.

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 Official Simulations

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

Event Description / ID Season Week Example Play-By-Play Feed Path
MIN@GB / f45b4a31-b009-4039-8394-42efbc6d5532 (With Failover @ Q3 13:27) 2015/REG 17 http://api.sportradar.us/nfl-sim1/games/f45b4a31-b009-4039-8394-42efbc6d5532/pbp.xml?api_key={your_api_key}
CHI@TB / 5a7042cb-fe7a-4838-b93f-6b8c167ec384 2015/REG 16 http://api.sportradar.us/nfl-sim1/games/5a7042cb-fe7a-4838-b93f-6b8c167ec384/pbp.xml?api_key={your_api_key}
DAL@BUF / 7f761bb5-7963-43ea-a01b-baf4f5d50fe3 2015/REG 16 http://api.sportradar.us/nfl-sim1/games/7f761bb5-7963-43ea-a01b-baf4f5d50fe3/pbp.xml?api_key={your_api_key}


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
OKC@DEN 2014/REG e054eba7-5b2a-427e-9c19-6244107d4689 http://api.sportradar.us/nba-sim3/games/e054eba7-5b2a-427e-9c19-6244107d4689/pbp.xml?api_key={your_api_key}
LAL@HOU 2014/REG 13a74988-4ff7-43cc-a639-5c0a46d9c39f http://api.sportradar.us/nba-sim3/games/13a74988-4ff7-43cc-a639-5c0a46d9c39f/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 Official API Simulation

Game Description Season Event / Game ID Example Play-By-Play Feed Path
Hurricanes@Jets 2016/reg 2e62b9c0-1422-46cf-9d8f-fbcd699352d0 (with Failover @ Q1 5:00) http://api.sportradar.us/nhlo-sim3/games/2e62b9c0-1422-46cf-9d8f-fbcd699352d0/pbp.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.

What is included in the report?

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:

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:

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.

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?

For Fall 2015, we will be providing 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:

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.