## 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.
## Image Provider Coverage
Calling the Images v3 API requires parameters for both the sport and the provider of the images. Each provider we use only supplies images for a limited number of sports. The table below illustrates which providers offer which sports.
Reuters
USAT
AP
Getty
Sportradar
NFL
x
x†‡
MLB
x†
‡
NBA
‡
x†‡
WNBA
‡
x†
NBA G League
‡
x†
NHL
x
‡
x†
NCAA FB, NCAA MB, NCAA WB
x
x‡
MLS
x†
‡
NCAA MH
‡
KHL
x
Golf - PGA
x
‡
x†
Golf - LPGA
‡
x†
NASCAR
x†
‡
x
Canadian Football
x
International Basketball, Euroleague Basketball
x
EPL, Bundesliga, La Liga, Italy Serie A, Ligue 1
x
‡
x
Superliga Argentina
x
Brazil Serie A
x
‡
x
Liga MX
x
‡
x
J1 League
‡
x†
Europa League
x
x
US National Soccer
x
UEFA Champions League
x
‡
x
English Football League Championship
‡
Boxing
x
UFC
x
x†
F1
x
‡
x
World Rally, IndyCar
x
Tennis
x
x
x
Cricket
x
Cricket World Cup, Indian Premier League, Australia Big Bash, Caribbean Premier League
‡
Soccer World Cup, International Soccer, Scottish Premiership, Netherlands Eredivisie, Belgian First Division A, Portuguese Primeira Liga, and Turkish Super Lig
x
Chinese Super League, England Championship
x
Rugby
x
Super Rugby
‡
x
United Rugby Championship, Premiership Rugby, National Rugby League
‡
Winter Olympics
x
Handball
x
Beach Volleyball
x
Indoor Volleyball
x
Badminton
x
Australian Rules Football
‡
Nippon Professional Baseball
‡
† Indicates premium (transparent background) headshots are available.
‡ Indicates logos are available.
## Image Types by Sport
API keys are separated between Action Shots (actionshots), Headshots (players and coaches), Venues (venues), Logos (logos), and Country Flags (flags). Action Shots and Headshots keys can access Venue Images and Venue Manifests automatically. The table below lists which image types are available from which providers based on sport.
Action Shots
Player Headshots
Coach Headshots
Venue Images
Logos
Country Flags
NFL
USAT and AP
USAT and AP
USAT
USAT and AP
AP
Sportradar
MLB
USAT
USAT
USAT
USAT
AP
Sportradar
NBA
Getty
Getty
Getty
AP
Sportradar
WNBA
Getty
Getty
AP
Sportradar
NBA G League
Getty
AP
Sportradar
NHL
USAT
USAT and Getty
USAT
USAT
AP
Sportradar
NCAA FB
USAT and AP
USAT
AP
Sportradar
NCAA MB
USAT and AP
USAT
AP
Sportradar
NCAA WB
USAT and AP
AP
Sportradar
NCAA MH
AP
Sportradar
KHL
Getty
Sportradar
NASCAR
USAT and Getty
USAT
USAT
AP
Sportradar
MLS
USAT
USAT
AP
Sportradar
Golf - PGA
USAT
USAT and Getty
AP
Sportradar
Golf - LPGA
Getty
AP
Sportradar
Canadian Football
USAT
Sportradar
International Basketball, Euroleague Basketball
Getty
Sportradar
Soccer EPL
Reuters and Getty
Reuters
Getty
AP
Sportradar
Soccer Bundesliga
Reuters and Getty
Reuters
AP
Sportradar
Soccer La Liga
Reuters and Getty
Reuters
AP
Sportradar
Soccer Italy Serie A
Reuters and Getty
Reuters
AP
Sportradar
Soccer Brazil Serie A
Getty
Reuters
AP
Sportradar
Soccer J1 League
Getty
AP
Sportradar
Soccer Liga MX
Getty
Reuters
AP
Sportradar
Soccer Superliga Argentina
Getty
Sportradar
Soccer Ligue 1
Reuters and Getty
Reuters
AP
Sportradar
Soccer Europa League
Reuters and Getty
AP
Sportradar
Chinese Super League
Reuters
Sportradar
England Championship
Reuters
Sportradar
US National Soccer
USAT
Sportradar
Soccer UEFA Champions League
Reuters and Getty
AP
Sportradar
Soccer English Football League Championship
AP
Sportradar
Soccer World Cup
Getty
Getty
Sportradar
International Soccer
Getty
Sportradar
Scottish Premiership
Getty
Sportradar
Netherlands Eredivisie
Getty
Sportradar
Belgian First Division A
Getty
Sportradar
Portuguese Primeira Liga
Getty
Sportradar
Turkish Super Lig
Getty
Sportradar
Boxing
USAT
Sportradar
UFC
USAT
Getty
Sportradar
Tennis
Reuters and Getty
Reuters
Getty
AP
Sportradar
Rugby
Getty
Sportradar
Super Rugby
Getty
AP
United Rugby Championship, Premiership Rugby, National Rugby League
AP
Cricket
Getty
Sportradar
Cricket World Cup, Indian Premier League, Australia Big Bash, Caribbean Premier League
AP
F1
Reuters and Getty
Reuters
AP
Sportradar
World Rally, IndyCar
Getty
Sportradar
Winter Olympics
USAT
Sportradar
Handball
Getty
Sportradar
Beach Volleyball
Getty
Sportradar
Indoor Volleyball
Getty
Sportradar
Badminton
Getty
Sportradar
Australian Rules Football
AP
Nippon Professional Baseball
AP
Return to Image Provider Coverage
## 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.
Return to Image Provider Coverage
## 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 Image Types by Sport 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=**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 Image Types by Sport 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 Image Types by Sport 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 Image Types by Sport 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 Image Types by Sport 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` | Only required for Soccer, Rugby, Cricket, and LPGA. League name: 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` | Only required for Soccer, Rugby, Cricket, and LPGA. League name: 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 Image Types by Sport 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
Return to Image Provider Coverage
## Action Shot Manifest (by date)
Provides the manifest for all action shots available on a given date, for a specified sport and provider.
>
