Coverage MatrixDocumentationRelease LogLog In

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:
AttributeParent ElementTypeDescription
entityassetlistStringType of image entity
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
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
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
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
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

Click on the below recipe for step-by-step instructions on downloading the most up-to-date official headshot for Byron Buxton.

For pre-built requests for all of our Images collections, feel free to browse and fork our Postman workspace:

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