RecipesDocs
Coverage MatrixDocumentationRelease LogLog In

Provides the manifest for all action shots available for a given event, for a specified sport and provider.


Data Points

Asset List:
AttributeParent ElementTypeDescription
entityassetlistStringType of image entity
ex. events or players
leagueassetlistStringName of league for a manifest
ex. mlb or golf
manifest_dateassetlistStringTimestamp of the most recent published update to a manifest
providerassetlistStringNews image provider for a manifest
ap (Associated Press), getty (Getty), reuters (Reuters), usat (USA Today)
typeassetlistStringType of images in a manifest
ex. actionshot or headshot
Assets:
AttributeParent ElementTypeDescription
idassetGUIDUnique ID of an image
ex. f7dc3e69-fe3a-4ce7-8f84-ea4a3a22c947
copyrightassetStringCopyright ownership of an image
ex. Associated Press
createdassetStringTimestamp of a creation of an image
ex. 2022-08-05T03:12:08+00:00
descriptionassetStringText description of an image
ex. <![CDATA[Washington Nationals third baseman Jeimer Candelario fields a ground ball during a baseball game against the Cincinnati Reds, Tuesday, July 4, 2023, in Washington. (AP Photo/Patrick Semansky)]]>
titleassetStringTitle (or headline) of an image
ex. <![CDATA[Reds Nationals Baseball]]>
updatedassetStringTimestamp of an update to an image
ex. 2023-07-04T14:56:25+00:00
Links:
AttributeParent ElementTypeDescription
heightlinkIntegerHeight in pixels of an image
ex. 3043
hreflinkStringHypertext reference used to create a downloadable URL to an image
ex. /actionshots/events/2023/7/4/057d0c1d-4a51-4353-ba67-7823b7667780/original.jpg
widthlinkIntegerWidth in pixels of an image
ex. 5410
Reference:
AttributeParent ElementTypeDescription
namerefStringName of an image type (eg. event, player, team)
ex. BAL at NYY (MLB - 7/4/2023) (event), Baltimore Orioles (organization), Schmidt, Clarke (profile)
typerefStringImage type (eg. event, player, team)
profile, organization, event, venue, tournament, season
sportrefStringSport or league of an image
ex. nfl, mlb or soccer
sportradar_idref - entity_idGUIDUnique Sportradar ID of an image
ex. 07f4f1e1-8eff-4988-a4bf-e35f13d6327b
sportsdata_idref - entity_idGUIDUnique SportsData ID of an image. This ID is typically only used as an extra identifier for teams within the NFL or NCAA Football APIs
ex. CHI (Chicago Bears)
Reference Entities:
AttributeParent ElementTypeDescription
alt_idref - entity_idGUIDUnique SportsData ID used to link an image to a type (eg. event, player, team). This ID is typically only used as an extra identifier for teams within the NFL or NCAA Football APIs
ex. CHI (Chicago Bears)
idref - entity_idGUIDUnique Sportradar ID used to link an image to a type (eg. event, player, team)
ex. 20ef56e1-8c82-4f96-84b0-3ce79f1a1a31 or sr:match:33623381
originref - entity_idStringSource of the unique Sportradar ID used to link an image to a type (eg. event, player, team)
SR = Sportradar General Sport IDs such as sr:match:33623381; SD = Sportradar League Specific IDs such as 20ef56e1-8c82-4f96-84b0-3ce79f1a1a31
sportref - entity_idStringSport or league of a source ID
ex. nfl, mlb or soccer
Provider:
AttributeParent ElementTypeDescription
provider_item_idproviderStringProvider asset ID
ex. 19295403
nameproviderStringNews provider for an image
ap (Associated Press), getty (Getty), reuters (Reuters), usat (USA Today)
original_publishproviderStringOriginal publish timestamp of an image
ex. 2023-07-05T01:35:33+00:00

Image Retrieval Example

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:

Language
Authorization
Query
Click Try It! to start a request and see the response here!