RecipesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

FAQs

Frequently asked questions for Images v3

Click on the categories below or browse questions on the right panel.

Categories

.


Coverage


What sports and leagues are available?

Click here to see every image type we provide by sport, league, and provider.


What is your Premium package?

Our Premium headshots offer transparent backgrounds to simplify implementation. Visit our Image Provider Coverage doc to view Premium availability.



Integration


How do I access your images with my API key?

To retrieve Sportradar's images you will need to pull a manifest file (for either action shots, players, coaches, venues, logos, or flags). Within each manifest you will find asset IDs (including syntax) for corresponding images located within each API.

Reference our step-by-step samples or visit our public Postman collection for pre-built sample requests.


Why are my API requests less for Images compared to other products?

The intention is for you to save each image on your end as requests are made, reducing the number of times needed to call the collection APIs. In addition, make use of the Change Log endpoint to catch updates to headshots and logos.

See our Headshot Schedule document for important dates on yearly image releases.


Do any Image API endpoints support pagination?

No. All content within a manifest is available in one request. If you do not receive a full response after 60 seconds, attempt a reconnect.


What are the valid sport and league values in the Change Log endpoint?

Sport:

  • australianrules
  • badminton
  • basketball
  • boxing
  • flags
  • golf
  • indoor_volleyball
  • rugby
  • tennis
  • auto_racing
  • baseball
  • beach_volleyball
  • cricket
  • football
  • hockey
  • mma
  • soccer
  • various

League:

  • arg_superliga
  • aus_big_bash
  • australianrules
  • badminton
  • beach_volleyball
  • bel_first_division_a
  • boxing
  • bra_serie_a
  • bundesliga
  • car_premier_league
  • cfl
  • chn_super_league
  • country-flags
  • cricket
  • cricket_world_cup
  • eng_championship
  • epl
  • euroleague
  • europa_league
  • f1
  • golf
  • handball
  • ind_premier_league
  • indoor_volleyball
  • indycar
  • intl_baseball
  • intl_basketball
  • intl_soccer
  • intl_soccer_women
  • jleague
  • khl
  • la_liga
  • la_liga_women
  • liga_mx
  • ligue_1
  • lpga
  • mlb
  • mls
  • nascar
  • national_rugby_league
  • nba
  • nbdl
  • ncaafb
  • ncaamb
  • ncaamh
  • ncaawb
  • ned_eredivisie
  • nfl
  • nhl
  • npb
  • olympics
  • pga
  • premiership_rugby
  • prt_primeira_liga
  • rugby
  • sco_premiership
  • serie_a
  • super_rugby
  • tennis
  • tur_super_lig
  • uefa_champions_league
  • uefa_champions_league_women
  • ufc
  • united_rugby
  • us_national_soccer
  • wnba
  • world_cup
  • world_rally
  • wsl
{
    "start_time": "2024-07-10T04:00:00Z",
    "end_time": "2024-07-11T03:59:59Z",
    "assets":
    {
        "headshots":
        [
            {
                "asset_id": "7dcadb0e-37b4-46d5-9d5c-ab6655a15557",
                "provider": "ap",
                "sport": "football",
                "league": "nfl",
                "sportradar_id": "f95c54c9-e528-4646-b8bc-90a2a6475fa6",
                "last_modified": "2024-07-11T01:17:53+00:00"
            },
            {
                "asset_id": "8a4d1c65-c947-4db7-a8f1-8b5aaa3963ec",
                "provider": "ap",
                "sport": "football",
                "league": "nfl",
                "sportradar_id": "sr:player:831231",
                "last_modified": "2024-07-10T20:06:22+00:00"
            },
            {
                "asset_id": "6af2976e-ef6c-44d6-8d98-93459e8c8ff0",
                "provider": "ap",
                "sport": "football",
                "league": "nfl",
                "sportradar_id": "sr:player:829745",
                "last_modified": "2024-07-10T19:04:21+00:00"
            },
            {
                "asset_id": "1fc6b914-729b-4545-806d-5d7460f367e5",
                "provider": "ap",
                "sport": "football",
                "league": "nfl",
                "sportradar_id": "sr:player:835213",
                "last_modified": "2024-07-11T03:20:08+00:00"
            },
            {
                "asset_id": "b8525055-cb6a-4665-b1ea-719c18c9bf23",
                "provider": "ap",
                "sport": "football",
                "league": "nfl",
                "sportradar_id": "sr:player:989233",
                "last_modified": "2024-07-11T00:27:42+00:00"
            }
        ],
        "logos":
        [
            {
                "asset_id": "7314dade-8182-427c-a870-f9b09fd8f97f",
                "provider": "ap",
                "sport": "auto_racing",
                "league": "nascar",
                "sportradar_id": "851e8e93-40ef-43e1-9682-bd31c197016d",
                "last_modified": "2024-07-10T16:15:48+00:00"
            },
            {
                "asset_id": "105e6e1d-e14a-4c85-956f-b13a737c1db0",
                "provider": "ap",
                "sport": "auto_racing",
                "league": "nascar",
                "sportradar_id": "851e8e93-40ef-43e1-9682-bd31c197016d",
                "last_modified": "2024-07-10T16:15:48+00:00"
            }
        ]
    }
}

What format are the date/time fields presented in?

All of our Date/Time attributes are in UTC, presented in the ISO 8601 standard format.

ex: 2013-04-03T18:15:00+00:00

For more information: https://en.wikipedia.org/wiki/ISO_8601



Headshots


When do yearly headshots typically become available?

Click here for a headshot availability schedule by collection and provider.


Do you have headshots for coaches and managers?

Yes. Some coaches and managers are available in the Player Manifest endpoint for the AP, Getty, Reuters, and USA Today collections. Images are typically limited to NFL, NBA, NHL, and MLB.

The frequency and volume of these headshots vary depending on league and media day availability. In some leagues, only head or assistant coaches will sit at media day, and it may not be every year. Other leagues, like the NFL, may have 10+ coaches sit each year.

Note: Image IDs for player and coaches are dependent on their presence in the corresponding Sportradar data API.

<asset id="437c631a-43cb-47e0-9c37-ad3f68c29079" created="2024-10-04T21:51:16+00:00" updated="2024-10-07T15:43:10+00:00" player_id="033c116a-1a69-4c05-a149-88e38d06cca0" posed="true">
  <title>
    <![CDATA[Doc Rivers]]>

  </title>
  <description>
    <![CDATA[MILWAUKEE, WI - SEPTEMBER 30: Head Coach Doc Rivers of the Milwaukee Bucks poses for a head shot during NBA Media Day on September 30, 2024 at the Fiserv Forum in Milwaukee, Wisconsin. 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 2024 NBAE (Photo by Randy Belice/NBAE via Getty Images)]]>

  </description>
  <copyright>Getty</copyright>
  <links>
    <link width="3117" height="2088" href="/headshots/players/437c631a-43cb-47e0-9c37-ad3f68c29079/original.jpg"/>
    <link width="250" height="167" href="/headshots/players/437c631a-43cb-47e0-9c37-ad3f68c29079/250w-resize.jpg"/>
  </links>
  <refs>
    <ref name="Rivers, Doc" type="profile" sport="nba" sportradar_id="033c116a-1a69-4c05-a149-88e38d06cca0" primary="true">
      <entity_id origin="SD" id="033c116a-1a69-4c05-a149-88e38d06cca0" sport="nba"/>
      <entity_id origin="NBA" id="1941" sport="nba"/>
    </ref>
    <ref name="Milwaukee Bucks" type="organization" sport="nba" sportradar_id="583ecefd-fb46-11e1-82cb-f4ce4684ea4c">
      <entity_id origin="SR" id="sr:competitor:3410" sport="nba"/>
      <entity_id origin="SD" id="583ecefd-fb46-11e1-82cb-f4ce4684ea4c" sport="nba"/>
      <entity_id origin="NBA" id="1610612749" sport="nba"/>
    </ref>
  </refs>
  <provider name="getty">
    <provider_item_id>2175000529</provider_item_id>
    <original_publish>2024-09-30T00:00:00+00:00</original_publish>
  </provider>
</asset>
{
  "id": "437c631a-43cb-47e0-9c37-ad3f68c29079",
  "created": "2024-10-04T21:51:16+00:00",
  "updated": "2024-10-07T15:43:10+00:00",
  "title": "Doc Rivers",
  "description": "MILWAUKEE, WI - SEPTEMBER 30: Head Coach Doc Rivers of the Milwaukee Bucks poses for a head shot during NBA Media Day on September 30, 2024 at the Fiserv Forum in Milwaukee, Wisconsin. 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 2024 NBAE (Photo by Randy Belice/NBAE via Getty Images)",
  "player_id": "033c116a-1a69-4c05-a149-88e38d06cca0",
  "copyright": "Getty",
  "posed=": true,
  "links": [
    {
      "width": 250,
      "height": 167,
      "href": "/headshots/players/437c631a-43cb-47e0-9c37-ad3f68c29079/250w-resize.jpg"
    },
    {
      "width": 205,
      "height": 205,
      "href": "/headshots/players/437c631a-43cb-47e0-9c37-ad3f68c29079/205x205-crop.jpg"
    },
    {
      "type": "original",
      "height": 2088,
      "width": 3117,
      "href": "/headshots/players/437c631a-43cb-47e0-9c37-ad3f68c29079/original.jpg"
    }
  ],
  "refs": [
    {
      "name": "Rivers, Doc",
      "type": "profile",
      "sport": "nba",
      "sportsdata_id": "033c116a-1a69-4c05-a149-88e38d06cca0",
      "sportradar_id": "033c116a-1a69-4c05-a149-88e38d06cca0",
      "primary": true,
      "entity_ids": [
        {
          "origin": "SD",
          "id": "033c116a-1a69-4c05-a149-88e38d06cca0",
          "sport": "nba"
        },
        {
          "origin": "NBA",
          "id": "1941",
          "sport": "nba"
        }
      ]
    },
    {
      "name": "Milwaukee Bucks",
      "type": "organization",
      "sport": "nba",
      "sportsdata_id": "583ecefd-fb46-11e1-82cb-f4ce4684ea4c",
      "sportradar_id": "583ecefd-fb46-11e1-82cb-f4ce4684ea4c",
      "entity_ids": [
        {
          "origin": "SD",
          "id": "583ecefd-fb46-11e1-82cb-f4ce4684ea4c",
          "sport": "nba"
        },
        {
          "origin": "SR",
          "id": "sr:competitor:3410",
          "sport": "nba"
        },
        {
          "origin": "NBA",
          "id": "1610612749",
          "sport": "nba"
        }
      ]
    }
  ],
  "provider": {
    "name": "getty",
    "provider_item_id": "2175000529",
    "original_publish": "2024-09-30T00:00:00+00:00"
  }
},


Action Shots


How long are your action shots available?

Action shot manifests and images are retained for 2 years.


How frequently do your action shots update?

We retrieve all available action shots every ten minutes from our providers.



College Pressbox Headshots


What is included in the College Pressbox offering?

2024 College Pressbox content includes:

  • NCAA Football (FBS)
  • NCAA Men's Basketball (D1)
  • NCAA Women's Basketball (D1)

In 2025, we expect to include FCS schools for NCAA Football


When do College Pressbox headshots typically become available?

Seasonal headshots are updated starting one month prior to a season. Headshots are updated into the first few weeks of a season, as teams make them available.


Are College Pressbox headshots included in the Change Log endpoint?

No. We plan on including College Pressbox images in the Change Log in the coming seasons.




🙋

More questions?

Reach out to [email protected] for further assistance.