Images v3

For media use only. Use of this API is prohibited for betting clients.
Frequently Asked Questions
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.
## Images API Map To retrieve Sportradar's images you will need to pull a manifest file (for either action shots, players, coaches, venues, logos, or flags). Within each manifest you will find asset IDs (including syntax) for corresponding images located within each API. Reference the right panel for step-by-step samples on retrieving each image type. Please note that calling the Images v3 API requires parameters for both the sport and the provider of the image. Each provider we use only supplies images for a limited number of sports. ## Action Shot Manifest (by date) Provides the manifest for all action shots available on a given date, for a specified sport and provider. >

Action Shot (by date) Request Example

>To find an image from the 2022 NBA Finals:
1: Reference the Coverage Matrix section for the proper provider. In this case, NBA action shots are provided by Getty.
2: Ensure you have the correct API key to retrieve this image. You can view all of your keys here. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Call the Action Shot Manifest for the desired date (e.g. 2022/06/17), using your Getty NBA Actionshot API key, and with getty in the provider parameter.
```html https://api.sportradar.us/nba-images-t3/getty/actionshots/events/2022/06/17/manifest.xml?api_key=**your_api_key** ``` >4: Locate the asset id and/or link for an action shot. You can reference the description element for a description of each image.
>![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 Coverage Matrix section for the proper provider. In this case, NBA action shots are provided by Getty.
2: Ensure you have the correct API key to retrieve this image. You can view all of your keys here. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Make a request to the NBA API (using your separate NBA API key) to retrieve the game id for Game 6 of the 2022 NBA Finals.
```html https://api.sportradar.us/nba/trial/v7/en/games/2022/06/16/schedule.xml?api_key=**your_api_key** ``` >![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 Coverage Matrix section for the proper provider. In this case, MLB player headshots are provided by USA Today.
2: Ensure you have the correct API key to retrieve this image. You can view all of your keys here. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Call the Player Manifest for the most current season, using your USA Today MLB Headshot API key, and with usat in the provider parameter.
```html https://api.sportradar.us/mlb-images-t3/usat/headshots/players/2022/manifest.xml?api_key=**your_api_key** ``` >4: Locate the asset id and/or link for Byron Buxton's headshots.
>![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 Coverage Matrix section for the proper provider. In this case, NFL venues are provided by USA Today and the Associated Press.
2: Ensure you have the correct API key to retrieve this image. You can view all of your keys here. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Call the Venue Manifest using your AP (or USA Today) NFL Headshot (or Action Shot) API key, and with ap (or usat) in the provider parameter. Note that both headshot and action shot keys will return data for venues.
```html https://api.sportradar.us/nfl-images-t3/ap/venues/manifest.xml?api_key=**your_api_key** ``` >4: Locate the asset id and/or link for AT&T Stadium.
>![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 Coverage Matrix section for the proper provider. In this case, NBA logos are provided by the Associated Press.
2: Ensure you have the correct API key to retrieve this image. You can view all of your keys here. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Call the Logo Manifest using your AP NBA Logo API key, and with ap in the provider parameter. Note that the trial syntax omits the year parameter.
>Production Syntax: ```shell curl -X GET "https://api.sportradar.us/nba-images-p3/ap/logos/2022/manifest.xml?api_key={your_api_key}" ``` >Trial Syntax: ```shell curl -X GET "https://api.sportradar.us/nba-images-t3/ap/logos/manifest.xml?api_key={your_api_key}" ``` >4: Locate the asset id and/or link for Golden State.
>![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` | Optional parameter depending on collection and year. The following collections and leagues will require the league parameter for an individual logo:

Soccer, Rugby, Cricket, and LPGA.

league: bundesliga, epl, serie-a, bra-serie-a, jleague, la-liga, ligue-1, uefa-champions-league, eng-championship, europa-league, mls, united-rugby, super-rugby, national-rugby-league, premiership-rugby, cricket-world-cup, car-premier-league, ind-premier-league, aus-big-bash, or lpga. | | `year` | Year in 4 digit format (YYYY).
Note: Year parameter is omitted for trial access. | | `format` | xml or json. | | `your_api_key` | Your API key. | To retrieve the XML Schema Definition (.xsd) for the Logo Manifests, replace the parameters in the following URL. https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/schema/manifest-v2.5.xsd?api_key=`{your_api_key}` Return to top ## Logo Image Provides a download of a team/league logo given a specified asset id taken from the Logo Manifest. ```ruby require 'uri' require 'net/http' require 'openssl' url = URI("https://api.sportradar.us/nfl-images-t3/ap/logos/1bcd10ac-11e1-4373-89df-c77ee52f0f05/original.jpg?api_key={your_api_key}") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true http.verify_mode = OpenSSL::SSL::VERIFY_NONE request = Net::HTTP::Get.new(url) response = http.request(request) puts response.read_body ``` ```python import http.client conn = http.client.HTTPSConnection("api.sportradar.us") conn.request("GET", "/nfl-images-t3/ap/logos/1bcd10ac-11e1-4373-89df-c77ee52f0f05/original.jpg?api_key={your_api_key}") res = conn.getresponse() data = res.read() print(data.decode("utf-8")) ``` Access a Logo Image by replacing the parameters in the following URL: https://api.sportradar.us/`{sport}`-images-`{access_level}{version}`/`{provider}`/`{league}`/logos/`{asset_id}`/`{file_name}`.jpg?api_key=`{your_api_key}` | Parameter | Description | | --------- | ----------- | | `sport` | Abbreviation for the specified sport: mlb, nfl, nba, nbdl, wnba, nhl, ncaafb, ncaamb, ncaawb, ncaamh, npb, tennis, golf, f1, australianrules, or soccer. | | `access_level` | Defines the access level of your API key as Production (p) or Trial (t). | | `version` | Version number of the API you are accessing (Current Version: 3). | | `provider` | News provider: Associated Press (ap). | | `league` | Optional parameter depending on collection and year. The following collections and leagues will require the league parameter for an individual logo:

Soccer, Rugby, Cricket, and LPGA.

league: bundesliga, epl, serie-a, bra-serie-a, jleague, la-liga, ligue-1, uefa-champions-league, eng-championship, europa-league, mls, united-rugby, super-rugby, national-rugby-league, premiership-rugby, cricket-world-cup, car-premier-league, ind-premier-league, aus-big-bash, or lpga. | | `asset_id` | ID for a given asset (see manifest). | | `file_name` | Name of the file (see manifest). | | `your_api_key` | Your API key. | Return to top ## Country Flags Manifest Provides the manifest for all country flag images. >

Country Flags Image Request Example

>To find the national flag for Sweden:
1: Reference the Coverage Matrix section for the proper provider. In this case, Sportradar is the provider.
2: Ensure you have the correct API key to retrieve this image. You can view all of your keys here. Trial keys will require a t in the access_level parameter; production keys will use a p.
3: Call the Country Flags Manifest using your Sportradar Country Flags API key, and with sr in the provider parameter.
```html https://api.sportradar.us/flags-images-t3/sr/country-flags/flags/manifest.xml?api_key=**your_api_key** ``` >4: Locate the asset id and/or link for Sweden.
>![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 ## Frequently Asked Questions

Q: What format are the date/time fields presented in?

A: All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.
ex: 2013-04-03T18:15:00+00:00
For more information: https://en.wikipedia.org/wiki/ISO_8601

Q: How do I access your images with my API key?

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 step-by-step samples on our developer portal or visit our public Postman collection for pre-built sample requests.

Q: What is your Premium package?

Our Premium headshots offer transparent backgrounds to simplify implementation. Visit our Image Provider Coverage doc to view Premium availability.

Q: How long are your action shots available?

Action shot manifests and images are retained for 2 years.

Q: Why are my API requests less for Images compared to other products?

The intention is for you to save each image on your end as requests are made, reducing the number of times needed to call the collection APIs.

Return to top

Docs Navigation