Editorial Content v3

For media use only: Use of this API is prohibited for betting clients.

Coverage Data Summary Documentation

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 Provides the latest news content for a given sport and league. Articles will include statistics, quotes, injuries, and transactions. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/content-mlb-t3/ap/news/2022/07/04/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/2022/07/04/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/2022/07/04/all.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. > Or click here for a sample of our Premium News output, with image references included. >For pre-built requests for all of our Content collections, feel free to browse and fork our Postman workspace:
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 Provides in-depth previews and recaps for events in a given sport and league. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/content-nfl-t3/ap/analysis/2022/12/23/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-nfl-t3/ap/analysis/2022/12/23/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-nfl-t3/ap/analysis/2022/12/23/all.xml?api_key={your_api_key}" ``` > The above command returns xml structured like this. > Or click here for a sample of our Premium Analysis output, with image references included. >For pre-built requests for all of our Content collections, feel free to browse and fork our Postman workspace:
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 Image >

Editorial Image Request Example

>To find an image from Super Bowl LVI:
1: Reference the Editorial Content Overview section to verify Premium content is available for the NFL.
2: Ensure you have the correct API key (AP NFL Premium Content) to retrieve this image. You can view all of your keys here. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Call either the News or Analysis feed for the desired date (e.g. 2022/02/14), using your AP NFL Premium Content API key, and with ap_premium in the provider parameter.
```html News: https://api.sportradar.us/content-nfl-t3/ap_premium/news/2022/02/12/all.xml?api_key=**your_api_key** ``` ```html Analysis: https://api.sportradar.us/content-nfl-t3/ap_premium/analysis/events/2022/02/14/all.xml=**your_api_key** ``` >4: Locate the asset id and/or link for an image. You can reference the description element for a description of each image.
> 5: Select the size of the image desired within the link attribute and use this href file_name in your next call to the Editorial Image endpoint. ```html https://api.sportradar.us/content-nfl-t3/ap_premium/assets/2022/2/13/0de668e5-c3a8-4ed5-88e9-2a99a4be98e9/h1000-max-resize.jpg?api_key=**your_api_key** ``` >The image from Super Bowl LVI is downloaded (News, Analysis). >For pre-built requests for all of our Content collections, feel free to browse and fork our Postman workspace:
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")) ``` 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