|
For media use only: Use of this API is prohibited for betting clients.
|
| Quick Access |
| Postman Collection |
XSD Schema |
 |
Download |
## 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 |
|
x |
‡ |
x† |
|
| NASCAR |
|
x |
|
x |
|
| Canadian Football |
|
x |
|
|
|
| International Basketball, Euroleague Basketball |
|
|
|
x |
|
| EPL, Bundesliga, La Liga, Italy Serie A, Ligue 1 |
x |
|
‡ |
x |
|
| Liga MX, Superliga Argentina |
|
|
|
x |
|
| Brazil Serie A |
|
|
‡ |
x |
|
| J.League |
|
|
‡ |
|
|
| 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 |
|
| Soccer World Cup, International Soccer, Scottish Premiership, Netherlands Eredivisie, Belgian First Division A, Portuguese Primeira Liga, and Turkish Super Lig |
|
|
|
x |
|
| Rugby |
|
|
|
x |
|
| Winter Olympics |
|
x |
|
|
|
| Handball |
|
|
|
x |
|
| Beach Volleyball |
|
|
|
x |
|
| Indoor Volleyball |
|
|
|
x |
|
| Badminton |
|
|
|
x |
|
† 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 |
|
Sportradar |
| MLS |
USAT |
USAT |
|
|
AP |
Sportradar |
| Golf |
USAT |
USAT and 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 |
|
|
|
AP |
Sportradar |
| Soccer J.League |
|
|
|
|
AP |
Sportradar |
| Soccer Liga MX |
Getty |
|
|
|
|
Sportradar |
| Soccer Superliga Argentina |
Getty |
|
|
|
|
Sportradar |
| Soccer Ligue 1 |
Reuters and Getty |
Reuters |
|
|
AP |
Sportradar |
| Soccer Europa League |
Reuters and Getty |
|
|
|
AP |
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 |
| Cricket |
Getty |
|
|
|
|
Sportradar |
| F1 |
Reuters and Getty |
Reuters |
|
|
|
Sportradar |
| World Rally, IndyCar |
Getty |
|
|
|
|
Sportradar |
| Winter Olympics |
USAT |
|
|
|
|
Sportradar |
| Handball |
Getty |
|
|
|
|
Sportradar |
| Beach Volleyball |
Getty |
|
|
|
|
Sportradar |
| Indoor Volleyball |
Getty |
|
|
|
|
Sportradar |
| Badminton |
Getty |
|
|
|
|
Sportradar |
Return to Image Provider Coverage
## Images API Map
>
Example:
>To find the most up-to-date official headshot for Byron Buxton:
>
- Reference the Image Provider Coverage section for the proper provider. In this case, MLB is provided by USA Today.
-
Call the Player Manifest for the most current season, using your USA Today MLB Headshot API key, and with usat in the provider parameter.
- Locate the asset id and/or link for Byron Buxton's headshots.
- 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.
>
Call Sample: 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.
>
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. The map below and sample on the right illustrate how you can obtain the parameters you need.
Return to Image Provider Coverage
## Action Shots Manifest (by date)
Provides the manifest for all action shots available on a given date, for a specified sport and provider.
|
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"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-images-t3/usat/actionshots/events/2017/2/9/manifest.xml?api_key={your_api_key}"
```
> The above command returns xml structured like
this.
Access the Action Shots 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 Daily Event Images, 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 Shots Manifest (by event)
Provides the manifest for all action shots available for a given event, for a specified sport and provider.
|
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"))
```
```shell
curl -X GET "https://api.sportradar.us/nhl-images-t3/usat/actionshots/events/game/bab68443-539e-48ba-a61f-3a835fdcfc81/manifest.xml?api_key={your_api_key}"
```
> The above command returns xml structured like
this.
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 Event Images, 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 Shots Images
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"))
```
```shell
curl -X GET "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}"
```
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. |
To retrieve the XML Schema Definition (.xsd) for Daily Event Images, 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 Manifests
Provides the yearly manifest for all player images available for a given sport and provider.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-images-t3/ap/headshots/players/2016/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/ap/headshots/players/2016/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/nfl-images-t3/ap/headshots/players/2016/manifest.xml?api_key={your_api_key}"
```
> The above command returns xml structured like
this.
|
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, 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: bundesliga, world-cup, epl, serie-a, la-liga, ligue-1, or pga. |
| `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 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 Images
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"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-images-t3/ap/headshots/players/000b5aca-724b-4768-a5d5-127d1e7cef02/original.jpg?api_key={your_api_key}"
```
> The above command returns an image like
this.
|
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, 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: bundesliga, world-cup, epl, serie-a, la-liga, ligue-1, or pga. |
| `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
## Coach Manifests
Provides the yearly manifest for all coach images available for a given sport and provider.
```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 Images
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 Manifests
Provides the manifest for all venue images available for a given sport and provider.
```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"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-images-t3/usat/venues/manifest.xml?api_key={your_api_key}"
```
> The above command returns xml structured like
this.
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 Images
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"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-images-t3/usat/venues/066080b7-9d21-49ca-a5f4-a255cc728722/original.jpg?api_key={your_api_key}"
```
> The above command returns an image like
this.
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 Manifests
Provides the yearly manifest for all team/league logos available for a given sport.
```ruby
require 'uri'
require 'net/http'
require 'openssl'
url = URI("https://api.sportradar.us/nfl-images-p3/ap/logos/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", "/nfl-images-p3/ap/logos/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/nfl-images-p3/ap/logos/2017/manifest.xml?api_key={your_api_key}"
```
> The above command returns xml structured like
this.
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, tennis, golf, 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. League name: bundesliga, epl, serie-a, bra-serie-a, jleague, la-liga, ligue-1, uefa-champions-league, eng-championship, europa-league, or mls. |
| `year` | Year in 4 digit format (YYYY).
Note: Year is not required when using 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 Images
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"))
```
```shell
curl -X GET "https://api.sportradar.us/nfl-images-t3/ap/logos/1bcd10ac-11e1-4373-89df-c77ee52f0f05/original.jpg?api_key={your_api_key}"
```
> The above command can return 4 types of images:
regular logos,
transparent logos,
text logos, and
transparent text logos.
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, tennis, golf, 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. League name: bundesliga, epl, serie-a, bra-serie-a, jleague, la-liga, ligue-1, uefa-champions-league, eng-championship, europa-league, or mls. |
| `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.
```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"))
```
```shell
curl -X GET "https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/manifest.xml?api_key={your_api_key}"
```
> The above command returns xml structured like
this.
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.
http://feed.elasticstats.com/schema/assets/manifest-v2.5.xsd
Return to top
## Country Flag Images
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"))
```
```shell
curl -X GET "https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/bd8d501f-fdf1-48ce-8085-4aad5aa2afd5/original.svg?api_key={your_api_key}"
```
> The above command returns a country flag in svg format.
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
