Editorial Content v3

For media use only: Use of this API is prohibited for betting clients.
Quick Access
Postman Collection XSD Schema
Download
## Editorial Content API Overview Sportradar’s Editorial Content API provides in-depth news coverage for all major US sports and international soccer leagues. Content is broken down into two feeds: News and Analysis. News returns the latest factual information, which may include statistics, quotes, injuries, and/or transactions. Analysis feeds are dedicated to previews and recaps of games and important events. An extra Premium package is also available for select sports. This upgrade offers the same editorial content, but also includes image assets that are linked within the articles. The table below illustrates which sports can include the Premium add-on.
AP
NFL, NBA, NHL, MLB, NCAA FB, NCAA MB, NCAA WB, Formula 1, Indy Car, Tennis, WNBA, EPL Soccer, Women's Super League Soccer, Women's International Soccer, International Soccer, Women's UEFA Champions Soccer, UEFA Champions Soccer, La Liga Soccer, Women's La Liga Soccer, MLS
x†
Golf, NASCAR, Olympics
x
† Denotes that Premium content is available, which includes images with most editorial content. ## News This endpoint retrieves News. News articles are classified as "transactions", "injuries", or general "news". See the table below for the content available by sport:
Product News Injuries Transactions
NFL † x x x
NBA † x x x
WNBA † x x x
MLB † x x x
NHL † x x x
NCAA FB † x x x
NCAA MB † x x x
NCAA WB † x x x
Golf x x
NASCAR x x x
Formula 1 † x x
Indycar † x x x
Tennis † x x
EPL Soccer † x x x
Women's Super League Soccer † x
Women's International Soccer † x x x
International Soccer † x x x
UEFA Champions Soccer † x x x
Women's UEFA Champions Soccer † x
Women's La Liga Soccer † x
La Liga Soccer † x x
MLS † x x x
Olympics x
† Denotes that Premium content is available, which includes images with specified editorial content types. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/content-mlb-t3/ap/news/2019/05/20/all.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", "/content-mlb-t3/ap/news/2019/05/20/all.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/content-mlb-t3/ap/news/2019/05/20/all.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. To access the News endpoint, use the following URL syntax: https://api.sportradar.us/content-`{sport}`-`{access_level}{version}`/`{provider}`/`{league}`/news/`{year}`/`{month}`/`{day}`/`{type}`.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `sport` | Abbreviation for the specified sport: nfl, ncaafb, nhl, nba, wnba, nbdl, ncaamb, mlb, golf, nascar, f1, indycar, tennis, soccer, or olympics. | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `provider` | News provider: Associated Press (ap), or Associated Press Premium (ap_premium). | | `league` | Only required for Soccer. Defines the requested soccer league: English Premier League (epl), La Liga (la-liga), Women's La Liga (la-liga-women), MLS (mls), UEFA Champions League (uefa-champions-league), Women's UEFA Champions League (uefa-champions-league-women), International (intl-soccer), Women's International (intl-soccer-women), Women's Super League (wsl). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `type` | Type of news: all, injuries, or transactions. | | `format` | xml or json. | | `your_api_key` | Your API key. | Return to top ## Analysis This endpoint retrieves sports Analysis. Analysis articles are classified as general "previews" or "recaps". See the table below for the content available by sport:
Product Previews Recaps
NFL † x x
NBA † x x
WNBA † x
MLB † x x
NHL † x x
NCAA FB † x x
NCAA MB † x x
NCAA WB † x x
Golf x x
NASCAR x x
Formula 1 † x x
Indycar † x x
Tennis † x x
EPL Soccer † x x
Women's Super League Soccer
Women's International Soccer † x
International Soccer † x
Women's UEFA Champions Soccer
UEFA Champions Soccer † x x
Women's La Liga Soccer † x
La Liga Soccer † x x
MLS † x x
Olympics x x
† Denotes that Premium content is available, which includes images with specified editorial content types. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/content-mlb-t3/ap/analysis/2019/05/20/all.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", "/content-mlb-t3/ap/analysis/2019/05/20/all.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/content-mlb-t3/ap/analysis/2019/05/20/all.xml?api_key={your_api_key}" ``` > The above command returns xml structured for preview, recap, or team report. To access the Analysis endpoint, use the following URL syntax: https://api.sportradar.us/content-`{sport}`-`{access_level}{version}`/`{provider}`/`{league}`/analysis/`{year}`/`{month}`/`{day}`/`{type}`.`{format}`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `sport` | Abbreviation for the specified sport: nfl, ncaafb, nhl, nba, wnba, nbdl, ncaamb, mlb, golf, nascar, f1, indycar, tennis, soccer, or olympics. | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `provider` | News provider: Associated Press (ap), or Associated Press Premium (ap_premium). | | `league` | Only required for Soccer. Defines the requested soccer league: English Premier League (epl), La Liga (la-liga), Women's La Liga (la-liga-women), MLS (mls), UEFA Champions League (uefa-champions-league), Women's UEFA Champions League (uefa-champions-league-women), International (intl-soccer), Women's International (intl-soccer-women), Women's Super League (wsl). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `day` | Day of month in 2 digit format (DD). | | `type` | Type of news: all, preview, recap. | | `format` | xml or json. | | `your_api_key` | Your API key. | ## Editorial Images Premium Editorial packages feature images to support the news articles. This endpoint provides a download of an image when given an asset id taken from the News or Analysis feeds. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/content-nfl-t3/ap_premium/assets/2021/10/24/bf87f9da-7c96-44da-9642-2e340259798c/h1000-max-resize.jpg?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", "/content-nfl-t3/ap_premium/assets/2021/10/24/bf87f9da-7c96-44da-9642-2e340259798c/h1000-max-resize.jpg?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` ```shell curl -X GET "https://api.sportradar.us/content-nfl-t3/ap_premium/assets/2021/10/24/bf87f9da-7c96-44da-9642-2e340259798c/h1000-max-resize.jpg?api_key={your_api_key}" ``` > The above command returns an image like this. Access an Editorial Image by replacing the parameters in the following URL: https://api.sportradar.us/content-`{sport}`-`{access_level}{version}`/`{provider}`/`league`/assets/`year`/`month`/`day`/`{asset_id}`/`{file_name}`/`format`?api_key=`{your_api_key}` Replace placeholders with the following query parameters: | Parameter | Description | | --------- | ----------- | | `sport` | Abbreviation for the specified sport: nfl, nba, wnba, mlb, nhl, ncaafb, ncaamb, ncaawb, f1, indycar, tennis, or soccer. | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `provider` | News provider: Associated Press Premium (ap_premium). | | `league` | Only required for Soccer. Defines the requested soccer league: English Premier League (epl), La Liga (la-liga), Women's La Liga (la-liga-women), MLS (mls), UEFA Champions League (uefa-champions-league), International (intl-soccer), Women's International (intl-soccer-women), Women's Super League (wsl), or Women's UEFA Champions League (uefa-champions-league-women). | | `year` | Year in 4 digit format (YYYY). | | `month` | Month in 2 digit format (MM). | | `asset_id` | ID for a given asset (see News or Analysis feed). | | `file_name` | Name of the file (see News or Analysis feed). | | `day` | Day of month in 2 digit format (DD). | | `format` | .jpg | | `your_api_key` | Your API key. | Return to top

Docs Navigation