RecipesDocs
Coverage MatrixDocumentationRelease LogLog In

Provides the yearly manifest for all player images available for a given sport and provider.


Data Points

Asset List:
AttributeParent ElementTypeDescription
entityassetlistStringType of image entity
players
leagueassetlistStringName of league for a manifest
ex. mlb or nfl
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)
typeassetlistStringType of images in a manifest
ex. actionshot or headshot
Assets:
AttributeParent ElementTypeDescription
idassetGUIDUnique ID of an image
ex. 6345232f-019c-46ef-a283-6c9aac604ec4
copyrightassetStringCopyright ownership of an image
ex. Getty
createdassetStringTimestamp of a creation of an image
ex. 2022-10-06T15:01:48+00:00
descriptionassetStringText description of an image
ex. <![CDATA[MINNEAPOLIS, MN - SEPTEMBER 27: Karl-Anthony Towns #32 of the Minnesota Timberwolves poses for a head shot during NBA Media Day on September 27, 2021 at the Minnesota Timberwolves and Lynx Courts at Mayo Clinic Square in Minneapolis, Minnesota. 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 the Getty Images License Agreement. Mandatory Copyright Notice: Copyright 2021 NBAE (Photo by Jordan Johnson/NBAE via Getty Images)]]>
player_idassetGUIDUnique Sportradar ID of a player
ex. ab532a66-9314-4d57-ade7-bb54a70c65ad
posedassetBooleanSignifies the image is a posed 'media day' headshot
titleassetStringTitle (or headline) of an image
ex. <![CDATA[Karl-Anthony Towns]]>
updatedassetStringTimestamp of an update to an image
ex. 2022-10-06T15:02:21+00:00
Links:
AttributeParent ElementTypeDescription
heightlinkIntegerHeight in pixels of an image
ex. 2747
hreflinkStringHypertext reference used to create a downloadable URL to an image
ex. /headshots/players/6345232f-019c-46ef-a283-6c9aac604ec4/original.jpg
widthlinkIntegerWidth in pixels of an image
ex. 1840
Reference:
AttributeParent ElementTypeDescription
namerefStringName of an image type (eg. event, player, team)
ex. Minnesota Timberwolves
typerefStringImage type (eg. event, player, team)
profile, organization, event, venue, tournament, season
primaryrefBooleanSignifies the image is the primary headshot image for a player
sportrefStringSport or league of an image
ex. nfl, mlb or soccer
sportradar_idref - entity_idGUIDUnique Sportradar ID of an image
ex. a7723160-10b7-4277-a309-d8dd95a8ae65
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 most up-to-date official headshot for Byron Buxton:

1: Reference the Coverage document for the proper provider. In this case, MLB player headshots are provided by USA Today.

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 Player Manifest for the most current season, using your USA Today MLB Headshot API key, and with usat in the provider parameter.

https://api.sportradar.us/mlb-images-t3/usat/headshots/players/2022/manifest.xml?api_key=**your_api_key**

4: Locate the asset id and/or link for Byron Buxton's headshots.

<asset id="0c25a61f-809d-4a39-91c4-cda0c3bc5b3e" created="2022-04-19T13:40:20+00:00" updated="2022-04-19T13:40:35+00:00" player_id="f45963f1-0379-45da-9e2b-c6a099910a35" posed="true">
        <title>
            <![CDATA[Byron Buxton]]>
    
        </title>
        <description>
            <![CDATA[Mar 15, 2022; USA; Minnesota Twins Byron Buxton poses for a 2022 MLB portrait. Mandatory Credit: MLB photos via USA TODAY Sports]]>
    
        </description>
        <copyright>USA Today Sports Images</copyright>
        <links>
            <link width="1200" height="1200" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/original.jpg"/>
            <link width="90" height="90" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/90x90-crop.jpg"/>
            <link width="250" height="250" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/250w-resize.jpg"/>
            <link width="120" height="120" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/120x120-crop.jpg"/>
            <link width="80" height="80" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/80x80-crop.jpg"/>
            <link width="205" height="205" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/205x205-crop.jpg"/>
            <link width="90" height="90" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/90x90-crop.jpg"/>
            <link width="45" height="45" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/45x45-crop.jpg"/>
            <link width="250" height="250" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/250x250-crop.jpg"/>
            <link width="180" height="180" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/180x180-crop.jpg"/>
            <link width="195" height="270" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/195x270-crop.jpg"/>
            <link width="410" height="410" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/410x410-crop.jpg"/>
            <link width="940" height="940" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/940x940-crop.jpg"/>
            <link width="300" height="300" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/300w-resize.jpg"/>
            <link width="200" height="300" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/200x300-crop.jpg"/>
            <link width="160" height="160" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/160x160-crop.jpg"/>
            <link width="160" height="160" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/160x160-crop.jpg"/>
            <link width="135" height="135" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/135x135-crop.jpg"/>
            <link width="300" height="300" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/300x300-crop.jpg"/>
            <link width="600" height="600" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/600x600-crop.jpg"/>
            <link width="705" height="705" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/705x705-crop.jpg"/>
            <link width="150" height="150" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/150x150-crop.jpg"/>
            <link width="820" height="820" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/820x820-crop.jpg"/>
            <link width="40" height="40" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/40x40-crop.jpg"/>
            <link width="60" height="60" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/60x60-crop.jpg"/>
            <link width="615" height="615" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/615x615-crop.jpg"/>
            <link width="235" height="235" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/235x235-crop.jpg"/>
            <link width="450" height="450" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/450x450-crop.jpg"/>
            <link width="470" height="470" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/470x470-crop.jpg"/>
            <link width="240" height="240" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/240x240-crop.jpg"/>
            <link width="90" height="90" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/90x90-crop.jpg"/>
            <link width="120" height="120" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/120x120-crop.jpg"/>
            <link width="80" height="80" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/80x80-crop.jpg"/>
            <link width="45" height="45" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/45x45-crop.jpg"/>
            <link width="180" height="180" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/180x180-crop.jpg"/>
            <link width="410" height="410" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/410x410-crop.jpg"/>
            <link width="300" height="300" href="/headshots/players/0c25a61f-809d-4a39-91c4-cda0c3bc5b3e/300w-resize.jpg"/>
        </links>
        <refs>
            <ref name="Buxton, Byron" type="profile" sport="mlb" sportradar_id="f45963f1-0379-45da-9e2b-c6a099910a35" primary="true">
                <entity_id origin="SD" id="f45963f1-0379-45da-9e2b-c6a099910a35" sport="mlb"/>
            </ref>
            <ref name="Minnesota Twins" type="organization" sport="mlb" sportradar_id="aa34e0ed-f342-4ec6-b774-c79b47b60e2d">
                <entity_id origin="SD" id="aa34e0ed-f342-4ec6-b774-c79b47b60e2d" sport="mlb"/>
            </ref>
        </refs>
        <provider name="usat">
            <provider_item_id>18075201</provider_item_id>
            <original_publish>2022-03-15T08:20:54+00:00</original_publish>
        </provider>
    </asset>

5: Select the size of headshot desired within the link attribute and use this href file_name in your next call to the Player Image endpoint.

https://api.sportradar.us/mlb-images-t3/usat/headshots/players/ef652acf-ab82-4154-9fbb-7d8e25be8339/705x705-crop.jpg?api_key=**your_api_key**

The headshot for Byron Buxton is downloaded.

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!