computer_vision

List similar images

Changed on Oct 14, 2026

This endpoint returns images that are visually similar to an image that you specify or upload.

get/v2/cv/similar/images

Request

Base URL
https://api.shutterstock.com
Auth
- HTTP basic
- or OAuth 2
  Authorization codehttps://accounts.shutterstock.com/oauth/authorize
  Token URLhttps://api.shutterstock.com/v2/oauth/access_token
TypeScript
https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/docs/v2/cv/similar/images/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

asset_idstring required

The asset ID or upload ID to find similar images for

licensestring[]

Show only images with the specified license

safeboolean

Enable or disable safe search

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

pageinteger

Page number

per_pageinteger

Number of results per page

view'minimal' | 'full'

Amount of detail to render in the response

Response

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

search_idstring required

Unique identifier for the search request

spellcheck_infoobject

Returns information if search phrase has potentially been mistyped or another query would lead to better search results

total_countinteger required

Total count of all results across all pages

Example response

{
  "data": [
    {
      "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/stock-photo-cropped-image-of-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"
    }
  ],
  "page": 1,
  "per_page": 5,
  "search_id": "749090bb-2967-4a20-b22e-c800dc845e10",
  "spellcheck_info": {},
  "total_count": 45
}

Changes

Oct 14, 2026b43cab3aaaaa Revision 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
- info
  added the optional property to the response with the status
Jul 13, 2026d2e03e7f655d Revision changes
- breaking
  for the query request parameter license, default value was changed from commercial to commercial
- 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

Operation history