get https://api.sportradar.com/-images-3///players//manifest.
Provides the yearly manifest for all player images available for a given sport and provider.
Access Note
Use the Endpoints with League Params section for the following sports:
- Golf
- Soccer
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
Click on the below recipe for step-by-step instructions on downloading the most up-to-date official headshot for Byron Buxton.
🦉
Player Image Request
Open Recipe
For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace: