Data Dictionary - Title Primary Images

Title Primary Images

The primary poster IMDb displays for each country and language — the artwork IMDb.com shows to visitors in that locale. Each record holds a global default poster, each country's primary poster, and any language-specific variants, so the most relevant image for a given country and language is found entirely within one record.

Each image item has the following attributes:

• "imageId": IMDb image identifier (rmconst), e.g. rm1479851521.
• "url": Hosted image URL on m.media-amazon.com.
• "width": Image width in pixels.
• "height": Image height in pixels.
• "country": ISO 3166 country code this poster is the primary for (e.g. FR). Omitted on the global default poster.
• "languages": A list of ISO 639 language codes this poster is the primary for within the country (e.g. ["fr"]). Omitted on a country-level primary and on the global default.

To choose a poster for a desired country and language, pick the most specific match: (1) an image whose country matches and whose languages includes the language; (2) an image whose country matches and has no languages (the country's primary poster); (3) the image with no country (the global default). Every title includes the global default, so this always resolves to a usable image.

Example

{
    "titleId": "tt0111161",
    "images": [
        {
            "imageId": "rm1010101010",
            "url": "https://m.media-amazon.com/images/M/...jpg",
            "width": 1200,
            "height": 1800
        },
        {
            "imageId": "rm2020202020",
            "url": "https://m.media-amazon.com/images/M/...jpg",
            "width": 1000,
            "height": 1500,
            "country": "FR"
        },
        {
            "imageId": "rm3030303030",
            "url": "https://m.media-amazon.com/images/M/...jpg",
            "width": 1000,
            "height": 1500,
            "country": "FR",
            "languages": ["fr"]
        }
    ]
}