get https://api.sportradar.com/-images-3///actionshots/events///manifest.
Provides the manifest for all action shots available for a given event, for a specified sport and provider.
Data Points
Asset List:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
entity | assetlist | String | Type of image entity ex. events or players |
league | assetlist | String | Name of league for a manifest ex. mlb or golf |
manifest_date | assetlist | String | Timestamp of the most recent published update to a manifest |
provider | assetlist | String | News image provider for a manifestap (Associated Press), getty (Getty), reuters (Reuters), usat (USA Today) |
type | assetlist | String | Type of images in a manifest ex. actionshot or headshot |
Assets:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | asset | GUID | Unique ID of an image ex. f7dc3e69-fe3a-4ce7-8f84-ea4a3a22c947 |
copyright | asset | String | Copyright ownership of an image ex. Associated Press |
created | asset | String | Timestamp of a creation of an image ex. 2022-08-05T03:12:08+00:00 |
description | asset | String | Text 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)]]> |
title | asset | String | Title (or headline) of an image ex. <![CDATA[Reds Nationals Baseball]]> |
updated | asset | String | Timestamp of an update to an image ex. 2023-07-04T14:56:25+00:00 |
Links:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
height | link | Integer | Height in pixels of an image ex. 3043 |
href | link | String | Hypertext reference used to create a downloadable URL to an image ex. /actionshots/events/2023/7/4/057d0c1d-4a51-4353-ba67-7823b7667780/original.jpg |
width | link | Integer | Width in pixels of an image ex. 5410 |
Reference:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
name | ref | String | Name of an image type (eg. event, player, team) ex. BAL at NYY (MLB - 7/4/2023) (event), Baltimore Orioles (organization), Schmidt, Clarke (profile) |
type | ref | String | Image type (eg. event, player, team)profile, organization, event, venue, tournament, season |
sport | ref | String | Sport or league of an image ex. nfl, mlb or soccer |
sportradar_id | ref - entity_id | GUID | Unique Sportradar ID of an image ex. 07f4f1e1-8eff-4988-a4bf-e35f13d6327b |
sportsdata_id | ref - entity_id | GUID | Unique 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:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
alt_id | ref - entity_id | GUID | Unique 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) |
id | ref - entity_id | GUID | Unique Sportradar ID used to link an image to a type (eg. event, player, team) ex. 20ef56e1-8c82-4f96-84b0-3ce79f1a1a31 or sr:match:33623381 |
origin | ref - entity_id | String | Source 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 |
sport | ref - entity_id | String | Sport or league of a source ID ex. nfl, mlb or soccer |
Provider:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
provider_item_id | provider | String | Provider asset ID ex. 19295403 |
name | provider | String | News provider for an imageap (Associated Press), getty (Getty), reuters (Reuters), usat (USA Today) |
original_publish | provider | String | Original 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:
