SHshutterstock
images

Get details about images

Changed on

This endpoint shows information about an image, including a URL to a preview image and the sizes that it is available in.

get/v2/images/{id}

Request

Path parameters

idstring asset-id required

Image ID

Query parameters

language'ar' | 'bg' | 'bn' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'fi' | 'fr' | 'gu' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'ja' | 'kn' | 'ko' | 'ml' | 'mr' | 'nb' | 'nl' | 'or' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'ta' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh' | 'zh-Hant'

Language code

Example:cs

Language for the keywords and categories in the response

view'minimal' | 'full'

Amount of detail to render in the response

search_idstring

The ID of the search that is related to this request

Response

OK

added_datestring date

Date that the image was added by the contributor

affiliate_urlstring uri

Affiliate referral link; appears only for registered affiliate partners

aspectnumber

Aspect ratio of the image in decimal format, such as 0.6667

descriptionstring

Detailed description of the image

has_model_releaseboolean

Indicates whether there are model releases for the image

has_property_releaseboolean

Indicates whether there are property releases for the image

idstring required

Image ID

image_typestring

Type of image

is_adultboolean

Whether or not this image contains adult content

is_editorialboolean

Whether or not this image is editorial content

is_illustrationboolean

Whether or not this image is an illustration

asset_collection'Starter' | 'Essentials' | 'Choice' | 'Offset'

Asset collection for this image

keywordsstring[]

Keywords associated with the content of this image

media_typestring required

Media type of this image, should always be "image"

releasesstring[]

List of all releases of this image

urlstring

Link to image information page; included only for certain accounts

Example response

{
  "id": "1572478477",
  "aspect": 1.5,
  "assets": {
    "preview": {
      "height": 300,
      "url": "https://image.shutterstock.com/display_pic_with_logo/250738318/1572478477/stock-photo-cropped-image-of-woman-gardening-1572478477.jpg",
      "width": 450
    },
    "small_thumb": {
      "height": 67,
      "url": "https://thumb7.shutterstock.com/thumb_small/250738318/1572478477/stock-photo-cropped-image-of-woman-gardening-1572478477.jpg",
      "width": 100
    },
    "large_thumb": {
      "height": 100,
      "url": "https://thumb7.shutterstock.com/thumb_large/250738318/1572478477/stock-photo-cropped-image-of-woman-gardening-1572478477.jpg",
      "width": 150
    },
    "mosaic": {
      "height": 167,
      "url": "https://image.shutterstock.com/image-photo/cropped-image-woman-gardening-250nw-1572478477.jpg",
      "width": 250
    },
    "huge_thumb": {
      "height": 260,
      "url": "https://image.shutterstock.com/image-photo/cropped-image-woman-gardening-260nw-1572478477.jpg",
      "width": 390
    },
    "preview_1000": {
      "url": "https://ak.picdn.net/shutterstock/photos/1572478477/watermark_1000/1706028c641ea2f443057287c67d9b91/preview_1000-1572478477.jpg",
      "width": 1000,
      "height": 667
    },
    "preview_1500": {
      "url": "https://image.shutterstock.com/z/stock-photo-cropped-image-of-woman-gardening-1572478477.jpg",
      "width": 1500,
      "height": 1000
    }
  },
  "contributor": {
    "id": "250738318"
  },
  "description": "cropped image of woman gardening",
  "image_type": "photo",
  "has_model_release": true,
  "media_type": "image",
  "original_filename": "123.jpg"
}

Changes

  • b43cab3aaaaaRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • d2e03e7f655dRevision changes
    • breaking

      for the path request parameter id, the format changed from no format to asset-id

    • info

      added the new optional query request parameter search_id

    • info

      added the new enum value ar to the query request parameter language

    • info

      added the new enum value bg to the query request parameter language

    • info

      added the new enum value bn to the query request parameter language

    • info

      added the new enum value gu to the query request parameter language

    • info

      added the new enum value he to the query request parameter language

    • info

      added the new enum value hi to the query request parameter language

    • info

      added the new enum value hr to the query request parameter language

    • info

      added the new enum value kn to the query request parameter language

    • info

      added the new enum value ml to the query request parameter language

    • info

      added the new enum value mr to the query request parameter language

    • info

      added the new enum value or to the query request parameter language

    • info

      added the new enum value sk to the query request parameter language

    • info

      added the new enum value sl to the query request parameter language

    • info

      added the new enum value ta to the query request parameter language

    • info

      added the new enum value te to the query request parameter language

    • info

      added the new enum value uk to the query request parameter language

    • info

      added the new enum value ur to the query request parameter language

    • info

      added the optional property / to the response with the status