--- title: "Run multiple image searches" method: POST path: "/v2/bulk_search/images" tags: ["images"] --- # Run multiple image searches `POST /v2/bulk_search/images` This endpoint runs up to 5 image searches in a single request and returns up to 20 results per search. You can provide global search parameters in the query parameters and override them for each search in the body parameter. The query and body parameters are the same as in the `GET /v2/images/search` endpoint. ## Query parameters - `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 - `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 ## Request body - object[] — List of searches - `added_date` string, date — Show images added on the specified date - `added_date_start` string, date — Show images added on or after the specified date - `aspect_ratio_min` number — Show images with the specified aspect ratio or higher, using a positive decimal of the width divided by the height, such as 1.7778 for a 16:9 image - `aspect_ratio_max` number — Show images with the specified aspect ratio or lower, using a positive decimal of the width divided by the height, such as 1.7778 for a 16:9 image - `aspect_ratio` number — Show images with the specified aspect ratio, using a positive decimal of the width divided by the height, such as 1.7778 for a 16:9 image - `added_date_end` string, date — Show images added before the specified date - `authentic` boolean — Show only authentic images - `category` string — Show images with the specified Shutterstock-defined category; specify a category name or ID - `color` string — Specify either a hexadecimal color in the format '4F21EA' or 'grayscale'; the API returns images that use similar colors - `contributor` string[] — Show images with the specified contributor names or IDs, allows multiple - `contributor_country` union — Show images from contributors in one or more specified countries, or start with NOT to exclude a country from the search - string[] - string[] - `fields` string — Fields to display in the response; see the documentation for the fields parameter in the overview section - `height` integer — (Deprecated; use height_from and height_to instead) Show images with the specified height - `height_from` integer — Show images with the specified height or larger, in pixels - `height_to` integer — Show images with the specified height or smaller, in pixels - `image_type` string[] — Show images of the specified type - `keyword_safe_search` boolean — Hide results with potentially unsafe keywords - `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' — Set query and result language (uses Accept-Language header if not set) - `license` string[] — Show only images with the specified license - `model` string[] — Show image results with the specified model IDs - `orientation` 'horizontal' | 'vertical' — Show image results with horizontal or vertical orientation - `page` integer — Page number - `per_page` integer — Number of results per page - `people_model_released` boolean — Show images of people with a signed model release - `people_age` 'infants' | 'children' | 'teenagers' | '20s' | '30s' | '40s' | '50s' | '60s' | 'older' — Show images that feature people of the specified age category - `people_ethnicity` string[] — Show images with people of the specified ethnicities, or start with NOT to show images without those ethnicities - `people_gender` 'male' | 'female' | 'both' — Show images with people of the specified gender - `people_number` integer — Show images with the specified number of people - `query` string — One or more search terms separated by spaces; you can use NOT to filter out images that match a term - `region` union — Raise or lower search result rankings based on the result's relevance to a specified region; you can provide a country code or an IP address from which the API infers a country - string, country-code-2 - string, ipv4 - `safe` boolean — Enable or disable safe search - `sort` 'newest' | 'popular' | 'relevance' | 'random' — Sort by - `spellcheck_query` boolean — Spellcheck the search query and return results on suggested spellings - `view` 'minimal' | 'full' — Amount of detail to render in the response - `width` integer — (Deprecated; use width_from and width_to instead) Show images with the specified width - `width_from` integer — Show images with the specified width or larger, in pixels - `width_to` integer — Show images with the specified width or smaller, in pixels ## Response `200` OK - object — List of search results for each given query - `results` object[] — List of 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 - `bulk_search_id` string — Unique identifier for the search request ## 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)