get https://api.sportradar.com/-images-3///headshots/players//manifest.
Provides the yearly manifest for all player images available for a given sport and provider.
Data Points
Asset List:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
entity | assetlist | String | Type of image entityplayers |
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. actionshot or headshot |
Assets:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
id | asset | GUID | Unique ID of an image ex. 6345232f-019c-46ef-a283-6c9aac604ec4 |
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[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_id | asset | GUID | Unique Sportradar ID of a player ex. ab532a66-9314-4d57-ade7-bb54a70c65ad |
posed | asset | Boolean | Signifies the image is a posed 'media day' headshot |
title | asset | String | Title (or headline) of an image ex. <![CDATA[Karl-Anthony Towns]]> |
updated | asset | String | Timestamp of an update to an image ex. 2022-10-06T15:02:21+00:00 |
Links:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
height | link | Integer | Height in pixels of an image ex. 2747 |
href | link | String | Hypertext reference used to create a downloadable URL to an image ex. /headshots/players/6345232f-019c-46ef-a283-6c9aac604ec4/original.jpg |
width | link | Integer | Width in pixels of an image ex. 1840 |
Reference:
| Attribute | Parent Element | Type | Description |
|---|---|---|---|
name | ref | String | Name of an image type (eg. event, player, team) ex. Minnesota Timberwolves |
type | ref | String | Image type (eg. event, player, team)profile, organization, event, venue, tournament, season |
primary | ref | Boolean | Signifies the image is the primary headshot image for a player |
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 |
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 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:
