Editorial Content v3
|
Quick Access | |
Postman Collection | XSD Schema |
Download |
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 | |
Golf, NASCAR, Olympics |
TTL / Cache: | 2 seconds | ||
Update Frequency: | As Necessary |
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.
TTL / Cache: | 2 seconds | ||
Update Frequency: | As Necessary |
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.>![NFL Editorial Content Manifest](../../../files/Editorial_NFL_Manifest.png "NFL Editorial Content Manifest") 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
Docs Navigation
- Documentation
- Football (American Football)
- Football (Soccer)
- Australian Rules Football
- Baseball
- Basketball
- NBA v8
- NBA v7
- NBA v5
- NBA v4
- WNBA v8
- WNBA v7
- WNBA v4
- WNBA v3
- NBA G League v8
- NBA G League v7
- NBA G League v5
- NCAA Men's Basketball v8
- NCAA Men's Basketball v7
- NCAA Men's Basketball v4
- NCAA Men's Basketball v3
- NCAA Women's Basketball v8
- NCAA Women's Basketball v7
- NCAA Women's Basketball v3
- Global Basketball v2
- Global Basketball v1
- Combat Sports
- Cricket
- Editorial Content
- Golf
- Handball
- Hockey
- Images
- Insights
- Insights User Interface
- NBA Insights v2
- NFL Insights v2
- NHL Insights v2
- MLB Insights v2
- NBA Betting Splits v2
- NHL Betting Splits v2
- MLB Betting Splits v2
- NFL Betting Splits v2
- NCAAFB Betting Splits v2
- NCAAMB Betting Splits v2
- NCAAWB Betting Splits v2
- Soccer Betting Splits v2
- NBA Insights v1
- NHL Insights v1
- MLB Insights v1
- NFL Insights v1
- Odds
- Broadcast Graphics
- Racing
- Rugby
- Tennis
- Widgets
- Baseline Sports Coverage
- Badminton v2
- Badminton v1
- Bandy v2
- Bandy v1
- Beach Soccer v2
- Beach Soccer v1
- Curling v2
- Curling v1
- Cycling v2
- Darts v2
- Darts v1
- Field Hockey v2
- Field Hockey v1
- Floorball v2
- Floorball v1
- Futsal v2
- Futsal v1
- Pesapallo v2
- Pesapallo v1
- Snooker v2
- Snooker v1
- Squash v2
- Squash v1
- Table Tennis v2
- Volleyball (Beach) v2
- Volleyball (Beach) v1
- Volleyball (Indoor) v2
- Volleyball (Indoor) v1
- Waterpolo v2
- Waterpolo v1
- Winter Sports v1