--- title: "Search for images" method: GET path: "/v2/images/search" tags: ["images"] --- # Search for images `GET /v2/images/search` This endpoint searches for images. If you specify more than one search parameter, the API uses an AND condition. Array parameters can be specified multiple times; in this case, the API uses an AND or an OR condition with those values, depending on the parameter. You can also filter search terms out in the `query` parameter by prefixing the term with NOT. Free API accounts show results only from a limited library of media, not the full Shutterstock media library. Also, the number of search fields they can use in a request is limited. ## Query parameters - `library` string[] - `added_date` string, date - `added_date_start` string, date - `aspect_ratio_min` number - `aspect_ratio_max` number - `aspect_ratio` number - `added_date_end` string, date - `category` string - `color` string - `contributor` string[] - `contributor_country` union - string[] - string[] - `fields` string - `height` integer - `height_from` integer - `height_to` integer - `image_type` string[] - `keyword_safe_search` boolean - `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 - `license` string[] - `model` string[] - `orientation` 'horizontal' | 'vertical' - `page` integer - `per_page` integer - `people_model_released` boolean - `people_age` 'infants' | 'children' | 'teenagers' | '20s' | '30s' | '40s' | '50s' | '60s' | 'older' - `people_ethnicity` string[] - `people_gender` 'male' | 'female' | 'both' - `people_number` integer - `query` string - `region` union - string, country-code-2 - string, ipv4 - `safe` boolean - `sort` 'newest' | 'popular' | 'relevance' | 'random' - `spellcheck_query` boolean - `view` 'minimal' | 'full' - `width` integer - `width_from` integer - `width_to` integer ## 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/revisions/d2e03e7f655d/schema)