RecipesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Provides a download of a team/league logo given a specified asset id taken from the Logo Manifest.

Note: Your image will not render in the Response section

❗️

Logo trial paths contain only watermarked sample images.

🔀

Access Note

Use the Endpoints with League Params section for the following sports/leagues:

  • Soccer
  • Rugby
  • Cricket
  • LPGA

Data Points

Asset List:
AttributeParent ElementTypeDescription
entityassetlistStringType of image entity
ex. logos
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)
trialassetlistBooleanSignifies a trial manifest is returned. Logo trial paths contain only watermarked sample images.
typeassetlistStringType of images in a manifest
ex. actionshot or headshot
Assets:
AttributeParent ElementTypeDescription
idassetGUIDUnique ID of a logo
ex. 00e8023f-1913-4736-bab8-740dba9d694d
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[TORONTO RAPTORS (transparent)]]>
premiumassetBooleanSignifies a Premium (transparent) logo
team_idassetGUIDUnique team ID of a logo
ex. 583ecd4f-fb46-11e1-82cb-f4ce4684ea4c
titleassetStringTitle (or headline) of an image
ex. <![CDATA[TORONTO RAPTORS (transparent)]]>
typeassetStringType of logo
ex. letter, global, primary, secondary
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. 2000
hreflinkStringHypertext reference used to create a downloadable URL to an image
ex. /logos/00e8023f-1913-4736-bab8-740dba9d694d/original.png
widthlinkIntegerWidth in pixels of an image
ex. 1500
Reference:
AttributeParent ElementTypeDescription
namerefStringName of an image type (eg. event, player, team)
ex. Toronto Raptors (organization)
primaryrefBooleanSignifies the image is the primary logo for a team or event
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 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:

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