--- updatedAt: 2026-08-24T01:40:28.000Z agentTools: siteIndex: https://developer.sportradar.com/llms.txt projectIndex: https://developer.sportradar.com/images-and-editorials/llms.txt --- # Images API Get started with Images API v3 ## Introduction 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. ### Redirects You must be able to follow 302 redirects to retrieve all of our images. ### Sportradar's Images API is for media use only. Use of this API is prohibited for betting clients.
*** ## API Map To best utilize the Images API, you will need specific parameters to create your API calls. The map below shows every feed in the API, grouped by task; the key marks the identifier each feed takes, and each entry links out to its endpoint page. Manifest feeds list the available assets for a provider and league and can be called directly; each image feed takes the asset ID and file name from a manifest entry. {`
PROVIDER + LEAGUE PATHDATEASSET PATH FROM MANIFESTPlayer HeadshotsMANIFESTS LIST ASSETS · IMAGE FEEDS TAKE THE ASSET PATH Player Manifest Player ImageCoaches Coach Manifest Coach ImageVenues Venue Manifest Venue ImageCountry Flags Country Flags Manifest Country Flag ImageAction ShotsBY-DATE MANIFESTS TAKE A DATE · BY-EVENT TAKE AN EVENT ID Action Shot Manifest (by date) Action Shot Manifest (by event) Action Shot ImageLogos Logo Manifest Logo ImageMonitor Data Changes Change Log
`}
*** ## Integration Resources
### Postman Workspace ## Run in Postman Our full Media API suite—including the Images collection—lives in our public Postman workspace. Fork or follow any collection to get updates automatically.
### Schema Download Open the zip file below to access our entire Images API XSD schema. [Images v3 Schema](https://api-docs.sportradar.us/image-editorial/Images_v3.zip)
### MCP Server The **Sportradar Images MCP Server** is a Model Context Protocol (MCP) implementation that bridges AI assistants directly to our Images API feeds. It allows LLMs to use standardized tools to fetch our sports data, helping to power your applications, assist in coding, and streamlining your integration. For detailed instructions on how to set up and use this integration, visit our MCP Server documentation.
*** ## Image Retrieval Samples
### Player Image Request Click on the below recipe for step-by-step instructions on downloading the most up-to-date official headshot for Byron Buxton.
### Action Shot (by date) Request To find an image from the 2022 NBA Finals: 1. Reach out to our Support team or reference our public Postman collection for the proper provider. In this case, NBA action shots are provided by Getty. 2. Ensure you have the correct API access to retrieve this image. Trial access will require a `t` in the `accesss_level` parameter; production access 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 Action Shot Manifest Sample Call https://api.sportradar.com/nba-images-t3/getty/actionshots/events/2022/06/17/manifest.xml ``` 4. Locate the `asset id` and/or `link` for an action shot. You can reference the `description` element for a description of each image ```xml Action Shot Snippet from Manifest <![CDATA[2022 NBA Finals - Golden State Warriors v Boston Celtics]]> Getty 1241353971 2022-06-16T00:00:00+00:00 ``` 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 Action Shot Sample Call https://api.sportradar.com/nba-images-t3/getty/actionshots/events/2022/6/17/452f18ee-ec9f-4491-b2bf-b454e50f1333/h1000-max-resize.jpg ``` The 2022 NBA Finals action shot is [downloaded](https://api-docs.sportradar.us/image-editorial/Images_NBA_ActionShot.jpeg). For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:

### Action Shot (by event) Request To find an image from Game 6 of the 2022 NBA Finals: 1. Reach out to our Support team or reference our public Postman collection for the proper provider. In this case, NBA action shots are provided by Getty. 2. Ensure you have the correct API access to retrieve this image. Trial access will require a `t` in the `access_level` parameter; production access will use a `p`. 3. Make a request to the **NBA API** to retrieve the `game id` for Game 6 of the 2022 NBA Finals. ```http NBA Daily Schedule Sample Request https://api.sportradar.com/nba/trial/v7/en/games/2022/06/16/schedule.xml ``` ```xml NBA Daily Schedule (06/16/2022) Snippet ``` 4. Call the **Action Shot Manifest** for the desired `game id`, using your Getty NBA Actionshot API key, and with `getty` in the `provider` parameter. ```http Action Shot Manifest Sample Request https://api.sportradar.com/nba-images-t3/getty/actionshots/events/game/b568a1fa-f5d4-4543-bdf4-5160c75c27f0/manifest.xml ``` 5. Locate the `asset id` and/or `link` for an action shot. You can reference the `description` element for a description of each image. ```xml Action Shot Event Manifest Snippet <![CDATA[2022 NBA Finals - Golden State Warriors v Boston Celtics]]> Getty 1241355847 2022-06-16T00:00:00+00:00 ``` 6. 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. ```http Action Shot Image Sample Request https://api.sportradar.com/nba-images-t3/getty/actionshots/events/2022/6/17/452f18ee-ec9f-4491-b2bf-b454e50f1333/h1000-max-resize.jpg ``` The 2022 NBA Finals action shot is [downloaded](https://api-docs.sportradar.us/image-editorial/Images_NBA_ActionShot.jpeg). For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:

### Venue Image Request To find the latest venue image for AT\&T Stadium in Dallas: 1. Reach out to our Support team or reference our public Postman collection for the proper provider. In this case, NFL venues are provided by Imagn and the Associated Press. 2. Ensure you have the correct API access to retrieve this image. Trial access will require a `t` in the `access_level` parameter; production access will use a `p` 3. Call the **Venue Manifest** using your AP (or Imagn) 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. ```http Venue Manifest Sample Request https://api.sportradar.com/nfl-images-t3/ap/venues/manifest.xml ``` 4. Locate the `asset id` and/or `link` for AT\&T Stadium. ```xml Venue Manifest Snippet (AT&T Stadium) <![CDATA[AT&T Stadium]]> Associated Press 2011-10-23T16:58:16+00:00 ``` 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. ```http Venue Image Sample Request https://api.sportradar.com/nfl-images-t3/ap/venues/0567ff24-fe88-4fa5-a7ff-d889016a8b37/h1000-max-resize.jpg ``` The image for AT\&T Stadium is [downloaded](https://api-docs.sportradar.us/image-editorial/Images_NFL_Venue.jpeg). For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:

### Logo Image Request To find the latest logo for the Golden State Warriors: 1. Reach out to our Support team or reference our public Postman collection for the proper provider. In this case, NBA logos are provided by the Associated Press. 2. Ensure you have the correct API access to retrieve this image. Trial access will require a `t` in the `access_level` parameter; production access will use a `p`. 3. Call the **Logo Manifest** with `ap` in the `provider` parameter. Note that the trial syntax omits the `year` parameter. **Production Syntax:** ```shell Logo Manifest Sample Request (Prod) curl -X GET "https://api.sportradar.com/nba-images-p3/ap/logos/2022/manifest.xml" ``` **Trial Syntax:** ```shell Logo Manifest Sample Request (Trial) curl -X GET "https://api.sportradar.com/nba-images-t3/ap/logos/manifest.xml" ``` 4. Locate the `asset id` and/or `link` for Golden State. ```xml NBA Logo Manifest Snippet (Golden State) <![CDATA[Golden State Warriors]]> Associated Press 2020-12-18T20:45:19+00:00 ``` 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 NBA Logo Image Sample Request curl -X GET "https://api.sportradar.com/nba-images-t3/ap/logos/4ffaf698-7247-46bd-b6e8-c3a98223b48f/h250-max-resize.jpg" ``` The logo for Golden State is [downloaded](https://api-docs.sportradar.us/image-editorial/goldenstate_primary.jpeg). We provide 4 types of logos: [regular logos](https://api-docs.sportradar.us/image-editorial/goldenstate_primary.jpeg), [transparent logos](https://api-docs.sportradar.us/image-editorial/goldenstate_primary_transparent.png), [text logos](https://api-docs.sportradar.us/image-editorial/goldenstate_lettering.jpg), and [transparent text logos](https://api-docs.sportradar.us/image-editorial/goldenstate_lettering_transparent.png). For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:

### Country Flags Image Request To find the national flag for Sweden: 1. Reach out to our Support team or reference our public Postman collection for the proper provider. In this case, Sportradar is the provider. 2. Ensure you have the correct API access to retrieve this image. Trial access will require a `t` in the `access_level` parameter; production access will use a `p`. 3. Call the **Country Flags Manifest** with `sr` in the `provider` parameter. ```http Country Flags Manifest Sample Request https://api.sportradar.com/flags-images-t3/sr/country-flags/flags/manifest.xml ``` 4. Locate the `asset id` and/or `link` for Sweden. ```xml Country Flags Manifest Snippet (Sweden) <![CDATA[SWEDEN]]> Sportradar AG 0 ``` 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. ```http Country Flag Image Request Sample https://api.sportradar.com/flags-images-t3/sr/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/original.svg ``` The flag for Sweden is [downloaded](https://api-docs.sportradar.us/image-editorial/Images_Sweden_Flag.png). 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: