RecipesDocs
Coverage MatrixDocumentationRelease LogLog In

Get started with Images API v3

❗️

For media use only. Use of this API is prohibited for betting clients.

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.


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. See below 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. Our Image Coverage document details all available methods.


Coverage Documents

Image Coverage

Click here to see every image type we provide by sport, league, and provider.

Headshot Schedule

Click here for a headshot availability schedule by collection and provider.


Integration Links

Postman Workspace

Our entire Media APIs are available on Postman. Click the link above to be taken directly to our Images API collection.

Feel free to follow and/or fork any collections to receive updates.

Schema Download

Open the zip file below to access our entire Images API XSD schema.

Images v3 Schema


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: Reference the Coverage document 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. 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.

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.

<asset id="4a5feef0-2cfd-4455-a17f-b09ab6a7eb66" created="2022-06-17T02:02:21+00:00" updated="2022-06-17T02:02:28+00:00">
        <title>
            <![CDATA[2022 NBA Finals - Golden State Warriors v Boston Celtics]]>
    
        </title>
        <description>
            <![CDATA[BOSTON, MA - JUNE 16: Stephen Curry #30 of the Golden State Warriors and Jordan Poole #3 of the Golden State Warriors high five against the Boston Celtics during Game Six of the 2022 NBA Finals on June 16, 2022 at TD Garden in Boston, Massachusetts. NOTE TO USER: User expressly acknowledges and agrees that, by downloading and or using this photograph, user is consenting to the terms and conditions of Getty Images License Agreement. Mandatory Copyright Notice: Copyright 2022 NBAE (Photo by Garrett Ellwood/NBAE via Getty Images)]]>
    
        </description>
        <copyright>Getty</copyright>
        <links>
            <link width="2289" height="3434" href="/actionshots/events/2022/6/17/4a5feef0-2cfd-4455-a17f-b09ab6a7eb66/original.jpg"/>
            <link width="667" height="1000" href="/actionshots/events/2022/6/17/4a5feef0-2cfd-4455-a17f-b09ab6a7eb66/h1000-max-resize.jpg"/>
            <link width="333" height="500" href="/actionshots/events/2022/6/17/4a5feef0-2cfd-4455-a17f-b09ab6a7eb66/h500-max-resize.jpg"/>
            <link width="167" height="250" href="/actionshots/events/2022/6/17/4a5feef0-2cfd-4455-a17f-b09ab6a7eb66/h250-max-resize.jpg"/>
        </links>
        <refs>
            <ref name="Boston Celtics" type="organization" sport="nba" sportradar_id="583eccfa-fb46-11e1-82cb-f4ce4684ea4c">
                <entity_id origin="SR" id="sr:competitor:3422" sport="nba"/>
                <entity_id origin="SD" id="583eccfa-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
                <entity_id origin="NBA" id="1610612738" sport="nba"/>
            </ref>
            <ref name="Curry, Stephen" type="profile" sport="nba" sportradar_id="8ec91366-faea-4196-bbfd-b8fab7434795">
                <entity_id origin="SR" id="sr:player:608110" sport="nba"/>
                <entity_id origin="SD" id="8ec91366-faea-4196-bbfd-b8fab7434795" sport="nba"/>
                <entity_id origin="NBA" id="201939" sport="nba"/>
            </ref>
            <ref name="GSW at BOS (NBA - Game 6 - 6/16/2022)" type="event" sport="nba" sportradar_id="b568a1fa-f5d4-4543-bdf4-5160c75c27f0">
                <entity_id origin="SR" id="sr:match:33294127" sport="nba"/>
                <entity_id origin="SD" id="b568a1fa-f5d4-4543-bdf4-5160c75c27f0" sport="nba"/>
                <entity_id origin="NBA" id="0042100406" sport="nba"/>
            </ref>
            <ref name="Golden State Warriors" type="organization" sport="nba" sportradar_id="583ec825-fb46-11e1-82cb-f4ce4684ea4c">
                <entity_id origin="SR" id="sr:competitor:3428" sport="nba"/>
                <entity_id origin="SD" id="583ec825-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
                <entity_id origin="NBA" id="1610612744" sport="nba"/>
            </ref>
            <ref name="Poole, Jordan" type="profile" sport="nba" sportradar_id="2ed2f76f-5a2f-4d79-ab7c-e84a8a42dc21">
                <entity_id origin="SR" id="sr:player:1316820" sport="nba"/>
                <entity_id origin="SD" id="2ed2f76f-5a2f-4d79-ab7c-e84a8a42dc21" sport="nba"/>
                <entity_id origin="NBA" id="1629673" sport="nba"/>
            </ref>
        </refs>
        <provider name="getty">
            <provider_item_id>1241353971</provider_item_id>
            <original_publish>2022-06-16T00:00:00+00:00</original_publish>
        </provider>
    </asset>

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.

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:

Action Shot (by event) Request

To find an image from Game 6 of the 2022 NBA Finals:

1: Reference the Coverage document 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. 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.

https://api.sportradar.us/nba/trial/v7/en/games/2022/06/16/schedule.xml?api_key=**your_api_key**
<league xmlns="http://feed.elasticstats.com/schema/basketball/schedule-v5.0.xsd" id="4353138d-4c22-4396-95d8-5f587d2df25c" name="NBA" alias="NBA">
    <daily-schedule date="2022-06-16">
        <games>
            <game id="b568a1fa-f5d4-4543-bdf4-5160c75c27f0" status="closed" title="Game 6" coverage="full" scheduled="2022-06-17T01:00:00Z" home_points="90" away_points="103" track_on_court="true" sr_id="sr:match:33294127" reference="0042100406" home_team="583eccfa-fb46-11e1-82cb-f4ce4684ea4c" away_team="583ec825-fb46-11e1-82cb-f4ce4684ea4c">
                <time_zones venue="US/Eastern" home="US/Eastern" away="US/Pacific"/>
                <venue id="7d69b080-91ca-53c9-9302-45c1a72c5549" name="TD Garden" capacity="18624" address="100 Legends Way" city="Boston" state="MA" zip="02114" country="USA" sr_id="sr:venue:5940"/>
                <home name="Boston Celtics" alias="BOS" id="583eccfa-fb46-11e1-82cb-f4ce4684ea4c" sr_id="sr:team:3422" reference="1610612738">
        </home>
                <away name="Golden State Warriors" alias="GSW" id="583ec825-fb46-11e1-82cb-f4ce4684ea4c" sr_id="sr:team:3428" reference="1610612744">
        </away>
                <broadcasts>
                    <broadcast network="ABC" type="TV" locale="National"/>
                </broadcasts>
            </game>
        </games>
    </daily-schedule>
</league>

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.

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.

<asset id="1cf20dce-dbb5-4c64-a4d8-0cf8de3dc49b" created="2022-06-17T04:50:41+00:00" updated="2022-06-17T04:50:52+00:00">
        <title>
            <![CDATA[2022 NBA Finals - Golden State Warriors v Boston Celtics]]>
    
        </title>
        <description>
            <![CDATA[BOSTON, MA - JUNE 16: Stephen Curry #30 of the Golden State Warriors embraces Jordan Poole #3 of the Golden State Warriors after Game Six of the 2022 NBA Finals on June 16, 2022 at TD Garden in Boston, Massachusetts. NOTE TO USER: User expressly acknowledges and agrees that, by downloading and or using this photograph, user is consenting to the terms and conditions of Getty Images License Agreement. Mandatory Copyright Notice: Copyright 2022 NBAE (Photo by Joe Murphy/NBAE via Getty Images)]]>
    
        </description>
        <copyright>Getty</copyright>
        <links>
            <link width="5472" height="3648" href="/actionshots/events/2022/6/17/1cf20dce-dbb5-4c64-a4d8-0cf8de3dc49b/original.jpg"/>
            <link width="1000" height="667" href="/actionshots/events/2022/6/17/1cf20dce-dbb5-4c64-a4d8-0cf8de3dc49b/h1000-max-resize.jpg"/>
            <link width="500" height="333" href="/actionshots/events/2022/6/17/1cf20dce-dbb5-4c64-a4d8-0cf8de3dc49b/h500-max-resize.jpg"/>
            <link width="250" height="167" href="/actionshots/events/2022/6/17/1cf20dce-dbb5-4c64-a4d8-0cf8de3dc49b/h250-max-resize.jpg"/>
        </links>
        <refs>
            <ref name="Boston Celtics" type="organization" sport="nba" sportradar_id="583eccfa-fb46-11e1-82cb-f4ce4684ea4c">
                <entity_id origin="SR" id="sr:competitor:3422" sport="nba"/>
                <entity_id origin="SD" id="583eccfa-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
                <entity_id origin="NBA" id="1610612738" sport="nba"/>
            </ref>
            <ref name="Curry, Stephen" type="profile" sport="nba" sportradar_id="8ec91366-faea-4196-bbfd-b8fab7434795">
                <entity_id origin="SR" id="sr:player:608110" sport="nba"/>
                <entity_id origin="SD" id="8ec91366-faea-4196-bbfd-b8fab7434795" sport="nba"/>
                <entity_id origin="NBA" id="201939" sport="nba"/>
            </ref>
            <ref name="GSW at BOS (NBA - Game 6 - 6/16/2022)" type="event" sport="nba" sportradar_id="b568a1fa-f5d4-4543-bdf4-5160c75c27f0">
                <entity_id origin="SR" id="sr:match:33294127" sport="nba"/>
                <entity_id origin="SD" id="b568a1fa-f5d4-4543-bdf4-5160c75c27f0" sport="nba"/>
                <entity_id origin="NBA" id="0042100406" sport="nba"/>
            </ref>
            <ref name="Golden State Warriors" type="organization" sport="nba" sportradar_id="583ec825-fb46-11e1-82cb-f4ce4684ea4c">
                <entity_id origin="SR" id="sr:competitor:3428" sport="nba"/>
                <entity_id origin="SD" id="583ec825-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
                <entity_id origin="NBA" id="1610612744" sport="nba"/>
            </ref>
            <ref name="Poole, Jordan" type="profile" sport="nba" sportradar_id="2ed2f76f-5a2f-4d79-ab7c-e84a8a42dc21">
                <entity_id origin="SR" id="sr:player:1316820" sport="nba"/>
                <entity_id origin="SD" id="2ed2f76f-5a2f-4d79-ab7c-e84a8a42dc21" sport="nba"/>
                <entity_id origin="NBA" id="1629673" sport="nba"/>
            </ref>
        </refs>
        <provider name="getty">
            <provider_item_id>1241355847</provider_item_id>
            <original_publish>2022-06-16T00:00:00+00:00</original_publish>
        </provider>
    </asset>

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.

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:

Venue Image Request

To find the latest venue image for AT&T Stadium in Dallas:

1: Reference the Coverage document 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. 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.

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.

<asset id="0567ff24-fe88-4fa5-a7ff-d889016a8b37" created="2018-06-07T17:33:24+00:00" updated="2018-06-07T17:33:29+00:00" venue_id="1e84213a-ff1f-4c9d-a003-8ee782b25a40">
        <title>
            <![CDATA[AT&T Stadium]]>
    
        </title>
        <copyright>Associated Press</copyright>
        <links>
            <link width="4256" height="2832" href="/venues/0567ff24-fe88-4fa5-a7ff-d889016a8b37/original.jpg"/>
            <link width="250" height="166" href="/venues/0567ff24-fe88-4fa5-a7ff-d889016a8b37/h250-max-resize.jpg"/>
            <link width="1000" height="665" href="/venues/0567ff24-fe88-4fa5-a7ff-d889016a8b37/h1000-max-resize.jpg"/>
            <link width="500" height="333" href="/venues/0567ff24-fe88-4fa5-a7ff-d889016a8b37/h500-max-resize.jpg"/>
        </links>
        <refs>
            <ref name="AT&amp;T Stadium" type="venue" sport="nfl" sportradar_id="1e84213a-ff1f-4c9d-a003-8ee782b25a40" primary="true">
                <entity_id origin="SD" id="1e84213a-ff1f-4c9d-a003-8ee782b25a40" sport="nfl"/>
            </ref>
        </refs>
        <provider name="ap">
            <original_publish>2011-10-23T16:58:16+00:00</original_publish>
        </provider>
    </asset>

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.

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:

Logo Image Request

To find the latest logo for the Golden State Warriors:

1: Reference the Coverage document 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. 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:

curl -X GET "https://api.sportradar.us/nba-images-p3/ap/logos/2022/manifest.xml?api_key={your_api_key}"

Trial Syntax:

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.

    <asset id="4ffaf698-7247-46bd-b6e8-c3a98223b48f" created="2020-12-18T20:45:19+00:00" updated="2020-12-18T20:45:21+00:00" team_id="583ec825-fb46-11e1-82cb-f4ce4684ea4c" type="global">
        <title>
            <![CDATA[Golden State Warriors]]>
    
        </title>
        <copyright>Associated Press</copyright>
        <links>
            <link width="1500" height="1125" href="/logos/4ffaf698-7247-46bd-b6e8-c3a98223b48f/original.jpg"/>
            <link width="1000" height="750" href="/logos/4ffaf698-7247-46bd-b6e8-c3a98223b48f/h1000-max-resize.jpg"/>
            <link width="250" height="188" href="/logos/4ffaf698-7247-46bd-b6e8-c3a98223b48f/h250-max-resize.jpg"/>
            <link width="500" height="375" href="/logos/4ffaf698-7247-46bd-b6e8-c3a98223b48f/h500-max-resize.jpg"/>
        </links>
        <refs>
            <ref name="Golden State Warriors" type="organization" sport="nba" sportradar_id="583ec825-fb46-11e1-82cb-f4ce4684ea4c" primary="true">
                <entity_id origin="SD" id="583ec825-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
            </ref>
        </refs>
        <provider name="ap">
            <original_publish>2020-12-18T20:45:19+00:00</original_publish>
        </provider>
    </asset>

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.

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:

Country Flags Image Request

To find the national flag for Sweden:

1: Reference the Coverage document for the proper provider. In this case, Sportradar is the provider.

2: Ensure you have the correct API key to retrieve this image. 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.

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.

    <asset id="7be83df7-5970-4814-b1b0-a4dd558ab29e" created="2018-07-10T19:35:56+00:00" updated="2019-02-27T23:13:11+00:00">
        <title>
            <![CDATA[SWEDEN]]>
    
        </title>
        <description>
            <![CDATA[National Flag for SWEDEN]]>
    
        </description>
        <copyright>Sportradar AG</copyright>
        <links>
            <link width="1200" height="800" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/original.svg"/>
            <link width="250" height="167" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h250-max-resize.png"/>
            <link width="1000" height="667" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h1000-max-resize.png"/>
            <link width="500" height="333" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h500-max-resize.png"/>
            <link width="3480" height="2320" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/h3480-max-resize.png"/>
            <link width="3840" height="2160" href="/country-flags/flags/7be83df7-5970-4814-b1b0-a4dd558ab29e/3840x2160-crop.png"/>
        </links>
        <refs>
            <ref name="SWEDEN" type="country" sport="flags" sportradar_id="" iso_country_code="SWE" primary="true">
      </ref>
        </refs>
        <provider name="sr">
            <version>0</version>
        </provider>
    </asset>

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.

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: