--- title: "List similar images" method: GET path: "/v2/images/{id}/similar" tags: ["images"] --- # List similar images `GET /v2/images/{id}/similar` This endpoint returns images that are visually similar to an image that you specify. ## Path parameters - `id` string, required ## 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 - `page` integer - `per_page` integer - `view` 'minimal' | 'full' ## Response `200` OK - object — Image search results - `data` object[], required — List of images - `added_date` string, date — Date that the image was added by the contributor - `affiliate_url` string, uri — Affiliate referral link; appears only for registered affiliate partners - `aspect` number — Aspect ratio of the image in decimal format, such as 0.6667 - `assets` object — Image asset information - `huge_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `huge_thumb` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `large_thumb` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `medium_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `preview` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `preview_1000` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `preview_1500` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `small_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `small_thumb` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `supersize_jpg` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `vector_eps` object — Image size information - `display_name` string — Display name of this image size - `dpi` integer - `file_size` integer — File size (in bytes) of this image size - `format` string — Format of this image size - `height` integer — Height of this image size - `is_licensable` boolean — Whether or not this image can be licensed in this image size - `width` integer — Width of this image size - `mosaic` object — Image thumbnail information - `height` integer, required — Height in pixels of the image thumbnail - `url` string, required — Direct URL to the image - `width` integer, required — Width in pixels of the image thumbnail - `categories` object[] — Categories that this image is a part of - `id` string — Category ID - `name` string — Category name - `contributor` object, required — Information about a contributor - `id` string, required — ID of the contributor - `description` string — Detailed description of the image - `has_model_release` boolean — Indicates whether there are model releases for the image - `has_property_release` boolean — Indicates whether there are property releases for the image - `id` string, required — Image ID - `image_type` string — Type of image - `is_adult` boolean — Whether or not this image contains adult content - `is_editorial` boolean — Whether or not this image is editorial content - `is_illustration` boolean — Whether or not this image is an illustration - `keywords` string[] — Keywords associated with the content of this image - `media_type` string, required — Media type of this image, should always be "image" - `model_releases` object[] — List of model releases - `id` string — ID of the model or property release - `models` object[] — List of models - `id` string, required — ID of the model - `releases` string[] — List of all releases of this image - `url` string — Link to image information page; included only for certain accounts - `message` string — Server-generated message, if any - `page` integer — Current page that is returned - `per_page` integer — Number of results per page - `search_id` string, required — Unique identifier for the search request - `spellcheck_info` object — Returns information if search phrase has potentially been mistyped or another query would lead to better search results - `total_count` integer, required — Total count of all results across all pages ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden --- [API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/versions/d2e03e7f655d/schema)