## Images API Overview
Sportradar’s Images API provides an extensive output of player headshots, venue images, team and league logos, and in-game action shots.
Over 100 image collections are available from four different providers. All images include Sportradar IDs, allowing for simple linking to teams, players, and events. Images are available in a variety of sizes to suit your needs.
An extra Premium package is also available for select sports. This upgrade offers transparent headshots to simplify implementation.
Note: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format. For example, if a game is scheduled at 7:00 pm Central time, it will be on the next day’s manifest.
Note: Images for each league require separate API keys.
## Images API Map
To retrieve Sportradar's images you will need to pull a manifest file (for either action shots, players, coaches, venues, logos, or flags). Within each manifest you will find asset IDs (including syntax) for corresponding images located within each API. Reference the right panel for step-by-step samples on retrieving each image type.
Please note that calling the Images v3 API requires parameters for both the sport and the provider of the image. Each provider we use only supplies images for a limited number of sports.
## Action Shot Manifest (by date)
Provides the manifest for all action shots available on a given date, for a specified sport and provider.
>
Action Shot (by date) Request Example
>To find an image from the 2022 NBA Finals: 1: Reference the Coverage Matrix section for the proper provider. In this case, NBA action shots are provided by Getty. 2: Ensure you have the correct API key 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 the Action Shot Manifest for the desired date (e.g. 2022/06/17), using your Getty NBA Actionshot API key, and with getty in the provider parameter.
```html
https://api.sportradar.us/nba-images-t3/getty/actionshots/events/2022/06/17/manifest.xml?api_key=**your_api_key**
```
>4: Locate the asset id and/or link for an action shot. 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 Action Shot Image endpoint.
```html
https://api.sportradar.us/nba-images-t3/getty/actionshots/events/2022/6/17/452f18ee-ec9f-4491-b2bf-b454e50f1333/h1000-max-resize.jpg?api_key=**your_api_key**
```
>The 2022 NBA Finals action shot is downloaded.
>For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:
Update Frequency:
As Necessary
Content Type:
XML or JSON
Asset List Data Points:
Entity League
Manifest Date Provider
Type
Asset Data Points:
Asset ID Copyright
Created Description
Title Updated
Link Data Points:
Height
HREF
Width
Reference Data Points:
Entity Alternate ID Entity ID Entity ID Origin
Entity ID Sport Reference Name Reference Type
Reference Sport Reference Sportradar ID Reference Sportsdata ID
Provider Data Points:
Provider Item ID
Provider Name
Provider Original Publish Date
Note:
For Golf we provide action shots for: The full PGA Tour schedule including all 4 Majors and Ryder Cup. We also provide select coverage of LPGA, Nationwide, and Senior Tour events.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-images-t3/usat/actionshots/events/2017/2/9/manifest.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", "/nhl-images-t3/usat/actionshots/events/2017/2/9/manifest.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access the Action Shot Manifest (By Date) feed by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/`{image_type}`/events/`{year}`/`{month}`/`{day}`/manifest.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: nfl, mlb, nba, wnba, nhl, ncaafb, ncaamb, ncaawb, hockey, nascar, basketball, golf, cfl, mls, soccer, tennis, boxing, ufc, f1, world-rally, indycar, rugby, cricket, olympics, handball, volleyball, or badminton. |
| `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: Reuters (reuters), USA Today (usat), Associated Press (ap), or Getty (getty). |
| `league` | Only required for International Soccer, International Baseball, International Basketball, International Hockey, or Volleyball. League name: bundesliga, epl, serie-a, bra-serie-a, liga-mx, arg-superliga, la-liga, ligue-1, europa-league, us-national-soccer, uefa-champions-league, world-cup, intl-soccer, sco-premiership, ned-eredivisie, bel-first-division-a, prt-primeira-liga, tur-super-lig, euroleague, intl-baseball, intl-basketball, khl, beach, or indoor. |
| `image_type` | Type of images: actionshots |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.xsd) for the Action Shot Manifest, replace the parameters in the following URL.
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/schema/manifest-v2.5.xsd?api_key=`{your_api_key}`
Return to top
## Action Shot Manifest (by event)
Provides the manifest for all action shots available for a given event, for a specified sport and provider.
>
Action Shot (by event) Request Example
>To find an image from Game 6 of the 2022 NBA Finals: 1: Reference the Coverage Matrix section for the proper provider. In this case, NBA action shots are provided by Getty. 2: Ensure you have the correct API key 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: Make a request to the NBA API (using your separate NBA API key) to retrieve the game id for Game 6 of the 2022 NBA Finals.
```html
https://api.sportradar.us/nba/trial/v7/en/games/2022/06/16/schedule.xml?api_key=**your_api_key**
```
>
3: Call the Action Shot Manifest for the desired game id, using your Getty NBA Actionshot API key, and with getty in the provider parameter.
```html
https://api.sportradar.us/nba-images-t3/getty/actionshots/events/game/b568a1fa-f5d4-4543-bdf4-5160c75c27f0/manifest.xml=**your_api_key**
```
>4: Locate the asset id and/or link for an action shot. 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 Action Shot Image endpoint.
```html
https://api.sportradar.us/nba-images-t3/getty/actionshots/events/2022/6/17/452f18ee-ec9f-4491-b2bf-b454e50f1333/h1000-max-resize.jpg?api_key=**your_api_key**
```
>The 2022 NBA Finals action shot is downloaded.
>For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:
Update Frequency:
As Necessary
Content Type:
XML or JSON
Asset List Data Points:
Entity League
Manifest Date Provider
Type
Asset Data Points:
Asset ID Copyright
Created Description
Title Updated
Link Data Points:
Height
HREF
Width
Reference Data Points:
Entity Alternate ID Entity ID Entity ID Origin
Entity ID Sport Reference Name Reference Type
Reference Sport Reference Sportradar ID Reference Sportsdata ID
Provider Data Points:
Provider Item ID
Provider Name
Provider Original Publish Date
Note:
For Golf we provide action shots for: The full PGA Tour schedule including all 4 Majors and Ryder Cup. We also provide select coverage of LPGA, Nationwide, and Senior Tour events.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-images-t3/usat/actionshots/events/game/bab68443-539e-48ba-a61f-3a835fdcfc81/manifest.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", "/nhl-images-t3/usat/actionshots/events/game/bab68443-539e-48ba-a61f-3a835fdcfc81/manifest.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access the Action Shots Manifest (By Event) feed by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/`{image_type}`/events/`{event_entity_name}`/`{event_entity_id}`/manifest.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: nfl, mlb, nba, wnba, nhl, ncaafb, ncaamb, ncaawb, hockey, nascar, basketball, golf, cfl, mls, soccer, tennis, f1, indycar, rugby, cricket, olympics, handball, volleyball, or badminton. |
| `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: Reuters (reuters), USA Today (usat), Associated Press (ap), or Getty (getty). |
| `league` | Only required for International Soccer, International Basketball, International Hockey, or Volleyball. League name: bundesliga, epl, serie-a, bra-serie-a, liga-mx, arg-superliga, la-liga, ligue-1, europa-league, us-national-soccer, uefa-champions-league, world-cup, intl-soccer, sco-premiership, ned-eredivisie, bel-first-division-a, prt-primeira-liga, tur-super-lig, euroleague, intl-basketball, khl, beach, or indoor. |
| `image_type` | Type of images: actionshots |
| `event_entity_name` | Relevant event type based on sport. (i.e.: tournament, stage, event, match, game, or sport). NOTE: For Olympics images use event. |
| `event_entity_id` | Id of a given event type. NOTE: Both sportradar_id or sportsdata_id can be used. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.xsd) for Action Shot Manifest, replace the parameters in the following URL.
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/schema/manifest-v2.5.xsd?api_key=`{your_api_key}`
Return to top
## Action Shot Image
Provides a download of the action shot image given a specified asset id taken from the manifest.
Note:
For Golf we provide action shots for: The full PGA Tour schedule including all 4 Majors and Ryder Cup. We also provide select coverage of LPGA, Nationwide, and Senior Tour events.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nhl-images-t3/usat/actionshots/events/2017/1/24/1f9e876e-cb2e-40c5-94b2-059111293d4b/original.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", "/nhl-images-t3/usat/actionshots/events/2017/1/24/1f9e876e-cb2e-40c5-94b2-059111293d4b/original.jpg?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access an Action Shot Image by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/`{image_type}`/events/`{year}`/`{month}`/`{day}`/`{asset_id}`/`{file_name}`.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: nfl, mlb, nba, wnba, nhl, ncaafb, ncaamb, ncaawb, hockey, nascar, basketball, golf, cfl, mls, soccer, tennis, boxing, ufc, f1, world-rally, indycar, rugby, cricket, olympics, handball, volleyball, or badminton. |
| `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: Reuters (reuters), USA Today (usat), Associated Press (ap), or Getty (getty). |
| `league` | Only required for International Soccer, International Baseball, International Basketball, or International Hockey. League name: bundesliga, epl, serie-a, bra-serie-a, liga-mx, arg-superliga, la-liga, ligue-1, europa-league, us-national-soccer, uefa-champions-league, world-cup, intl-soccer, sco-premiership, ned-eredivisie, bel-first-division-a, prt-primeira-liga, tur-super-lig, euroleague, intl-basketball, intl_baseball, khl, beach, or indoor. |
| `image_type` | Type of images: actionshots |
| `year` | Year in 4 digit format (YYYY). |
| `month` | Month in 2 digit format (MM). |
| `day` | Day in 2 digit format (DD). |
| `asset_id` | ID for a given asset (see manifest). |
| `file_name` | Name of the file (see manifest). |
| `format` | jpg (regular) or png (premium). |
| `your_api_key` | Your API key. |
Return to top
## Player Manifest
Provides the yearly manifest for all player images available for a given sport and provider.
>
Player Image Request Example
>To find the most up-to-date official headshot for Byron Buxton: 1: Reference the Coverage Matrix section for the proper provider. In this case, MLB player headshots are provided by USA Today. 2: Ensure you have the correct API key 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 the Player Manifest for the most current season, using your USA Today MLB Headshot API key, and with usat in the provider parameter.
```html
https://api.sportradar.us/mlb-images-t3/usat/headshots/players/2022/manifest.xml?api_key=**your_api_key**
```
>4: Locate the asset id and/or link for Byron Buxton's headshots.
>
5: Select the size of headshot desired within the link attribute and use this href file_name in your next call to the Player Image endpoint.
```html
https://api.sportradar.us/mlb-images-t3/usat/headshots/players/ef652acf-ab82-4154-9fbb-7d8e25be8339/705x705-crop.jpg?api_key=**your_api_key**
```
>The headshot for Byron Buxton is downloaded.
>For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:
Update Frequency:
As Necessary
Content Type:
XML or JSON
Asset List Data Points:
Entity League
Manifest Date Provider
Type
Asset Data Points:
Asset ID Copyright Created
Description Player ID Posed
Title Updated
Link Data Points:
Height
HREF
Width
Reference Data Points:
Entity Alternate ID Entity ID Entity ID Origin Entity ID Sport
Reference Name Reference Primary Reference Type
Reference Sport Reference Sportradar ID Reference Sportsdata ID
Note: Only UFC ranked players will have player topics.
Access the Player Manifest feed by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/`{image_type}`/players/`{year}`/manifest.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: golf, mlb, nascar, nfl, nba, wnba, nbdl, nhl, ncaafb, ncaamb, mls, soccer, super-rugby, tennis, ufc, or f1. |
| `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: Reuters (reuters), USA Today (usat), USA Today Premium (usat_premium), Associated Press (ap), Associated Press Premium (ap_premium), Getty (getty), or Getty Premium (getty_premium). |
| `league` | Only required for International Soccer or Getty Golf. League name: bra-serie-a, bundesliga, chn-super-league, world-cup, epl, eng-championship, jleague, serie-a, la-liga, liga-mx, ligue-1, pga, or lpga. |
| `image_type` | Type of images: headshots or full-body (UFC only) |
| `year` | Year in 4 digit format (YYYY). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.xsd) for the Player Manifests, replace the parameters in the following URL.
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/schema/manifest-v2.5.xsd?api_key=`{your_api_key}`
Return to top
## Player Image
Provides a download of a player image given a specified asset id taken from the Player Manifest.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-images-t3/ap/headshots/players/000b5aca-724b-4768-a5d5-127d1e7cef02/original.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", "/nfl-images-t3/ap/headshots/players/000b5aca-724b-4768-a5d5-127d1e7cef02/original.jpg?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Note: Only UFC ranked players will have player topics.
Access a Player Image by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/`{image_type}`/players/`{asset_id}`/`{file_name}`.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: golf, mlb, nascar, nfl, nba, wnba, nbdl, nhl, ncaafb, ncaamb, mls, soccer, super-rugby, tennis, ufc, or f1. |
| `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: Reuters (reuters), USA Today (usat), USA Today Premium (usat_premium), Associated Press (ap), Associated Press Premium (ap_premium), Getty (getty), or Getty Premium (getty_premium). |
| `league` | Only required for International Soccer or Getty Golf. League name: bra-serie-a, bundesliga, chn-super-league, world-cup, epl, eng-championship, jleague, serie-a, la-liga, liga-mx, ligue-1, pga, or lpga. |
| `image_type` | Type of images: headshots or full-body (UFC only) |
| `asset_id` | ID for a given asset (see manifest). |
| `file_name` | Name of the file (see manifest). |
| `format` | jpg (regular) or png (premium). |
| `your_api_key` | Your API key. |
Return to top
## Coach Manifest
Provides the yearly manifest for all coach images available for a given sport and provider.
Update Frequency:
As Necessary
Content Type:
XML or JSON
Asset List Data Points:
Entity League
Manifest Date Provider
Type
Asset Data Points:
Asset ID Copyright Created
Description Posed
Title Updated
Link Data Points:
Height
HREF
Width
Reference Data Points:
Entity Alternate ID Entity ID Entity ID Origin Entity ID Sport
Reference Name Reference Primary Reference Type
Reference Sport Reference Sportradar ID Reference Sportsdata ID
Provider Data Points:
Provider Item ID
Provider Name
Provider Original Publish Date
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/mlb-images-t3/usat/headshots/coaches/2017/manifest.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", "/mlb-images-t3/usat/headshots/coaches/2017/manifest.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/mlb-images-t3/usat/headshots/coaches/2017/manifest.xml?api_key={your_api_key}"
```
> The above command returns xml structured like this.
Access the Coach Manifest feed by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/`{image_type}`/coaches/`{year}`/manifest.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: mlb, nfl, nhl. |
| `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: USA Today (usat). |
| `image_type` | Type of images: headshots. |
| `year` | Year in 4 digit format (YYYY). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.xsd) for the Coaches Manifests, replace the parameters in the following URL.
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/schema/manifest-v2.5.xsd?api_key=`{your_api_key}`
Return to top
## Coach Image
Provides a download of a coach image given a specified asset id taken from the Coach Manifest.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/mlb-images-t3/usat/headshots/coaches/f2e5ff64-af7d-40ce-9f38-15332b8a2538/original.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", "/mlb-images-t3/usat/headshots/coaches/f2e5ff64-af7d-40ce-9f38-15332b8a2538/original.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/mlb-images-t3/usat/headshots/coaches/f2e5ff64-af7d-40ce-9f38-15332b8a2538/original.jpg?api_key={your_api_key}"
```
> The above command returns an image like this.
Access a Coach Image feed by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/`{image_type}`/coaches/`{asset_id}`/`{file_name}`.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: mlb, nfl, nhl. |
| `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: USA Today (usat). |
| `image_type` | Type of images: headshots. |
| `asset_id` | ID for a given asset (see manifest). |
| `file_name` | Name of the file (see manifest). |
| `format` | jpg (regular) or png (premium). |
| `your_api_key` | Your API key. |
Return to top
## Venue Manifest
Provides the manifest for all venue images available for a given sport and provider.
>
Venue Image Request Example
>To find the latest venue image for AT&T Stadium in Dallas: 1: Reference the Coverage Matrix section for the proper provider. In this case, NFL venues are provided by USA Today and the Associated Press. 2: Ensure you have the correct API key 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 the Venue Manifest using your AP (or USA Today) NFL Headshot (or Action Shot) API key, and with ap (or usat) in the provider parameter. Note that both headshot and action shot keys will return data for venues.
```html
https://api.sportradar.us/nfl-images-t3/ap/venues/manifest.xml?api_key=**your_api_key**
```
>4: Locate the asset id and/or link for AT&T Stadium.
>
5: Select the size of image desired within the link attribute and use this href file_name in your next call to the Venue Image endpoint.
```html
https://api.sportradar.us/nfl-images-t3/ap/venues/0567ff24-fe88-4fa5-a7ff-d889016a8b37/h1000-max-resize.jpg?api_key=**your_api_key**
```
>The image for AT&T Stadium is downloaded.
>For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:
Update Frequency:
As Necessary
Content Type:
XML or JSON
Asset List Data Points:
Entity League
Manifest Date Provider
Type
Asset Data Points:
Asset ID Copyright Created
Description Title
Updated Venue ID
Link Data Points:
Height
HREF
Width
Reference Data Points:
Entity ID Entity ID Origin Entity ID Sport
Reference Name Reference Primary Reference Type
Reference Sport Reference Sportradar ID
Provider Data Points:
Provider Item ID
Provider Name
Provider Original Publish Date
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-images-t3/usat/venues/manifest.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", "/nfl-images-t3/usat/venues/manifest.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access the Venue Manifest feed by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/venues/manifest.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: mlb, nfl, nba, nhl, nascar, 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` | Provider: USA Today (usat), Associated Press (ap), or Getty (getty). |
| `league` | Only required for Soccer. League name: epl. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.xsd) for the Venue Manifests, replace the parameters in the following URL.
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/schema/manifest-v2.5.xsd?api_key=`{your_api_key}`
Return to top
## Venue Image
Provides a download of a venue image given a specified asset id taken from the Venue Manifest.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-images-t3/usat/venues/066080b7-9d21-49ca-a5f4-a255cc728722/original.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", "/nfl-images-t3/usat/venues/066080b7-9d21-49ca-a5f4-a255cc728722/original.jpg?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access a Venue Image by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/venues/`{asset_id}`/`{file_name}`.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: mlb, nfl, nba, nhl, nascar, 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` | Provider: USA Today (usat), Associated Press (ap), or Getty (getty). |
| `league` | Only required for Soccer. League name: epl. |
| `asset_id` | ID for a given asset (see manifest). |
| `file_name` | Name of the file (see manifest). |
| `format` | jpg (regular) or png (premium). |
| `your_api_key` | Your API key. |
Return to top
## Logo Manifest
Provides the yearly manifest for all team/league logos available for a given sport.
>
Logo Image Request Example
>To find the latest logo for the Golden State Warriors: 1: Reference the Coverage Matrix section for the proper provider. In this case, NBA logos are provided by the Associated Press. 2: Ensure you have the correct API key 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 the Logo Manifest using your AP NBA Logo API key, and with ap in the provider parameter. Note that the trial syntax omits the year parameter.
>Production Syntax:
```shell
curl -X GET "https://api.sportradar.us/nba-images-p3/ap/logos/2022/manifest.xml?api_key={your_api_key}"
```
>Trial Syntax:
```shell
curl -X GET "https://api.sportradar.us/nba-images-t3/ap/logos/manifest.xml?api_key={your_api_key}"
```
>4: Locate the asset id and/or link for Golden State.
>
5: Select the size of image desired within the link attribute and use this href file_name in your next call to the Logo Image endpoint.
```shell
curl -X GET "https://api.sportradar.us/nba-images-t3/ap/logos/4ffaf698-7247-46bd-b6e8-c3a98223b48f/h250-max-resize.jpg?api_key={your_api_key}"
```
>The logo for Golden State is downloaded.
>We provide 4 types of logos: regular logos, transparent logos, text logos, and transparent text logos.
>For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:
Update Frequency:
As Necessary
Content Type:
XML or JSON
Asset List Data Points:
Entity League
Manifest Date Provider
Trial Type
Asset Data Points:
Asset ID Copyright Created
Description Premium Team ID
Title Type Updated
Link Data Points:
Height
HREF
Width
Reference Data Points:
Entity Alternate ID Entity ID Entity ID Origin Entity ID Sport
Reference Name Reference Primary Reference Type
Reference Sport Reference Sportradar ID Reference Sportsdata ID
Provider Data Points:
Provider Item ID Provider Name
Provider Original Publish Date
Provider Version
Note: Logo trial paths contain only watermarked sample images.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-images-p3/ap/logos/2022/manifest.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", "/nfl-images-p3/ap/logos/2022/manifest.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access the Logo Manifest feed by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/logos/`{year}`/manifest.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: mlb, nfl, nba, wnba, nbdl, nhl, ncaafb, ncaamb, ncaawb, ncaamh, npb, tennis, golf, f1, australianrules, 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). |
| `league` | Optional parameter depending on collection and year. The following collections and leagues will require the league parameter for an individual logo:
Soccer, Rugby, Cricket, and LPGA.
league: bundesliga, epl, serie-a, bra-serie-a, jleague, la-liga, ligue-1, uefa-champions-league, eng-championship, europa-league, mls, united-rugby, super-rugby, national-rugby-league, premiership-rugby, cricket-world-cup, car-premier-league, ind-premier-league, aus-big-bash, or lpga. |
| `year` | Year in 4 digit format (YYYY). Note: Year parameter is omitted for trial access. |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.xsd) for the Logo Manifests, replace the parameters in the following URL.
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/schema/manifest-v2.5.xsd?api_key=`{your_api_key}`
Return to top
## Logo Image
Provides a download of a team/league logo given a specified asset id taken from the Logo Manifest.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-images-t3/ap/logos/1bcd10ac-11e1-4373-89df-c77ee52f0f05/original.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", "/nfl-images-t3/ap/logos/1bcd10ac-11e1-4373-89df-c77ee52f0f05/original.jpg?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access a Logo Image by replacing the parameters in the following URL:
https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/logos/`{asset_id}`/`{file_name}`.jpg?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `sport` | Abbreviation for the specified sport: mlb, nfl, nba, nbdl, wnba, nhl, ncaafb, ncaamb, ncaawb, ncaamh, npb, tennis, golf, f1, australianrules, 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). |
| `league` | Optional parameter depending on collection and year. The following collections and leagues will require the league parameter for an individual logo:
Soccer, Rugby, Cricket, and LPGA.
league: bundesliga, epl, serie-a, bra-serie-a, jleague, la-liga, ligue-1, uefa-champions-league, eng-championship, europa-league, mls, united-rugby, super-rugby, national-rugby-league, premiership-rugby, cricket-world-cup, car-premier-league, ind-premier-league, aus-big-bash, or lpga. |
| `asset_id` | ID for a given asset (see manifest). |
| `file_name` | Name of the file (see manifest). |
| `your_api_key` | Your API key. |
Return to top
## Country Flags Manifest
Provides the manifest for all country flag images.
>
Country Flags Image Request Example
>To find the national flag for Sweden: 1: Reference the Coverage Matrix section for the proper provider. In this case, Sportradar is the provider. 2: Ensure you have the correct API key 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 the Country Flags Manifest using your Sportradar Country Flags API key, and with sr in the provider parameter.
```html
https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/manifest.xml?api_key=**your_api_key**
```
>4: Locate the asset id and/or link for Sweden.
>
5: Select the size of image desired within the link attribute and use this href file_name in your next call to the Country Flag Image endpoint.
```html
https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/original.svg?api_key=**your_api_key**
```
>The flag for Sweden is downloaded.
>Flags are available in svg or png formats.
>For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:
Update Frequency:
As Necessary
Content Type:
XML or JSON
Asset List Data Points:
Entity League
Manifest Date Provider
Type
Asset Data Points:
Asset ID Copyright
Created Description
Title Updated
Link Data Points:
Height
HREF
Width
Reference Data Points:
Entity ID Entity ID Origin Entity ID Sport
Reference ISO Country Code Reference Name Reference Primary
Reference Type Reference Sport Reference Sportradar ID
Provider Data Points:
Provider Name
Provider Version
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/manifest.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", "/flags-images-t3/sr/country-flags/flags/manifest.xml?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access the Country Flag Manifest feed by replacing the parameters in the following URL:
https://api.sportradar.us/flags-images-`{access_level}{version}`/sr/country-flags/flags/manifest.`{format}`?api_key=`{your_api_key}`
| Parameter | Description |
| --------- | ----------- |
| `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). |
| `format` | xml or json. |
| `your_api_key` | Your API key. |
To retrieve the XML Schema Definition (.xsd) for the Country Flag manifest use the following URL.
https://feed.elasticstats.com/schema/assets/manifest-v2.5.xsd
Return to top
## Country Flag Image
Provides a download of a country flag image given a specified asset id taken from the Country Flags Manifest.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/bd8d501f-fdf1-48ce-8085-4aad5aa2afd5/original.svg?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", "/flags-images-t3/sr/country-flags/flags/bd8d501f-fdf1-48ce-8085-4aad5aa2afd5/original.svg?api_key={your_api_key}")
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```
Access a Country Flag by replacing the parameters in the following URL:
https://api.sportradar.us/flags-images-`{access_level}{version}`/sr/country-flags/flags/`{flag_id}`/original.svg?api_key=`{your_api_key}`
Replace placeholders with the following query parameters:
| Parameter | Description |
| --------- | ----------- |
| `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). |
| `flag_id` | ID for a given flag (see manifest). |
| `your_api_key` | Your API key. |
Return to top