Provides the manifest for all venue images available for a given sport and provider.
Premier League Syntax
For the English Premier League, add the league parameter:
api.sportradar.us/soccer-images-t3/getty/epl/venues/manifest.{format}?api_key={your_api_key}
Data Points
Asset List:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
entity | assetlist | String | Type of image entityvenues |
league | assetlist | String | Name of league for a manifest ex. mlb or nfl |
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. venue |
Assets:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | asset | GUID | Unique ID of an image ex. ffb712cf-9773-437a-bb8b-7624962b50cc |
copyright | asset | String | Copyright ownership of an image ex. Getty |
created | asset | String | Timestamp of a creation of an image ex. 2022-10-06T15:01:48+00:00 |
description | asset | String | Text description of an image ex. <![CDATA[Utah Jazz v Toronto Raptors]]> |
title | asset | String | Title (or headline) of an image ex. <![CDATA[Air Canada Centre]]> |
updated | asset | String | Timestamp of an update to an image ex. 2022-10-06T15:02:21+00:00 |
venue_id | asset | GUID | Unique Sportradar ID of a venue ex. 62cc9661-7b13-56e7-bf4a-bba7ad7be8da |
Links:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
height | link | Integer | Height in pixels of an image ex. 5098 |
href | link | String | Hypertext reference used to create a downloadable URL to an image ex. /venues/ffb712cf-9773-437a-bb8b-7624962b50cc/original.jpg |
width | link | Integer | Width in pixels of an image ex. 3399 |
Reference:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
name | ref | String | Name of an image type (eg. event, player, team) ex. Air Canada Centre |
type | ref | String | Image type (eg. event, player, team)venue |
primary | ref | Boolean | Signifies the image is the primary image for a venue |
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. a7723160-10b7-4277-a309-d8dd95a8ae65 |
Reference Entities:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | ref - entity_id | GUID | Unique Sportradar ID used to link an image to a type (eg. event, player, team) ex. 62cc9661-7b13-56e7-bf4a-bba7ad7be8da |
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 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&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: