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