Provides the yearly manifest for all team/league logos available for a given sport.
Logo trial paths contain only watermarked sample images.
Production Syntax
For production requests, a year parameter must be used:
api.sportradar.us/{sport}-images-{access_level}{version}/{provider}/logos/{year}/manifest.{format}?api_key={your_api_key}
Data Points
Asset List:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
entity | assetlist | String | Type of image entity ex. logos |
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) |
trial | assetlist | Boolean | Signifies a trial manifest is returned. Logo trial paths contain only watermarked sample images. |
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 a logo ex. 00e8023f-1913-4736-bab8-740dba9d694d |
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[TORONTO RAPTORS (transparent)]]> |
premium | asset | Boolean | Signifies a Premium (transparent) logo |
team_id | asset | GUID | Unique team ID of a logo ex. 583ecd4f-fb46-11e1-82cb-f4ce4684ea4c |
title | asset | String | Title (or headline) of an image ex. <![CDATA[TORONTO RAPTORS (transparent)]]> |
type | asset | String | Type of logo ex. letter, global, primary, secondary |
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. 2000 |
href | link | String | Hypertext reference used to create a downloadable URL to an image ex. /logos/00e8023f-1913-4736-bab8-740dba9d694d/original.png |
width | link | Integer | Width in pixels of an image ex. 1500 |
Reference:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
name | ref | String | Name of an image type (eg. event, player, team) ex. Toronto Raptors (organization) |
primary | ref | Boolean | Signifies the image is the primary logo for a team or event |
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 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:
