get https://api.sportradar.com////actionshots/events////manifest.
Provides the manifest for all action shots available on a given date, 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 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:
