Images v3

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 - 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.
>![NBA Action Shot Manifest](../../../files/Images_NBA_Actionshot_By_Date_Manifest.png "NBA Action Shot Manifest") 5: Select the size of the image desired within the link attribute and use this href file_name in your next call to the 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** ``` >![NBA Game ID](../../../files/Images_NBA_Game_ID.png "NBA Game ID") 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.
>![NBA Action Shot Manifest](../../../files/Images_NBA_Actionshot_By_Date_Manifest.png "NBA Action Shot Manifest") 5: Select the size of the image desired within the link attribute and use this href file_name in your next call to the 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.
>![MLB Player Manifest](../../../files/Images_MLB_Player_Manifest.png "MLB Player Manifest") 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
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/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")) ```
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.
>![NFL Venue Manifest](../../../files/Images_NFL_Venue_Manifest.png "NFL Venue Manifest") 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.
>![NBA Logo Manifest](../../../files/Images_NBA_Logo_Manifest.png "NBA Logo Manifest") 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.
>![Country Flags Manifest](../../../files/Images_Country_Flags_Manifest.png "Country Flags Manifest") 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

Docs Navigation