## Content Provider Coverage
Calling the Editorial Content API requires parameters for both the sport and the provider of the images. Each provider we use only supplies content for a limited number of sports. The table below illustrates which providers offer which sports.
|
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 |
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 |
† 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}`/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, ncaamb, mlb, golf, nascar, 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 (ap), or Associated Press Premium (ap_premium). |
| `league` | 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. |
## 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 |
† 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, ncaamb, mlb, golf, nascar, 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 (ap), or Associated Press Premium (ap_premium). |
| `league` | 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. |
