RecipesDocs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Frequently asked questions for the Images v3 API

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


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.


What is your Premium package?

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


How long are your action shots available?

Action shot manifests and images are retained for 2 years.


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.


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"
            }
        ]
    }
}




🙋

More questions?

Reach out to [email protected] for further assistance.