Run multiple image searches
POST {{baseUrl}}/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.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
added_date | string | Show images added on the specified date | |
added_date_start | string | Show images added on or after the specified date | |
aspect_ratio_min | string | 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 | string | 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 | string | 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 | Show images added before the specified date | |
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 | string | Show images from contributors in one or more specified countries, or start with NOT to exclude a country from the search | |
fields | string | Fields to display in the response; see the documentation for the fields parameter in the overview section | |
height | string | (Deprecated; use height_from and height_to instead) Show images with the specified height | |
height_from | string | Show images with the specified height or larger, in pixels | |
height_to | string | 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 | string | 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 | string | Show image results with horizontal or vertical orientation | |
page | number | Page number | |
per_page | number | Number of results per page | |
people_model_released | string | Show images of people with a signed model release | |
people_age | string | 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 | string | Show images with people of the specified gender | |
people_number | string | Show images with the specified number of people | |
region | string | 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 | |
safe | boolean | Enable or disable safe search | |
sort | string | Sort by | |
spellcheck_query | boolean | Spellcheck the search query and return results on suggested spellings | |
view | string | Amount of detail to render in the response | |
width | string | (Deprecated; use width_from and width_to instead) Show images with the specified width | |
width_from | string | Show images with the specified width or larger, in pixels | |
width_to | string | Show images with the specified width or smaller, in pixels |
Request Body
[{"added_date"=>"<date>", "added_date_start"=>"<date>", "aspect_ratio_min"=>"<number>", "aspect_ratio_max"=>"<number>", "aspect_ratio"=>"<number>", "added_date_end"=>"<date>", "authentic"=>"<boolean>", "category"=>"<string>", "color"=>"<string>", "contributor"=>["<string>", "<string>"], "contributor_country"=>["<country-code-2>", "<country-code-2>"], "fields"=>"<string>", "height"=>"<integer>", "height_from"=>"<integer>", "height_to"=>"<integer>", "image_type"=>["<string>", "<string>"], "keyword_safe_search"=>true, "language"=>"<string>", "license"=>["commercial"], "model"=>["<string>", "<string>"], "orientation"=>"<string>", "page"=>1, "per_page"=>20, "people_model_released"=>"<boolean>", "people_age"=>"<string>", "people_ethnicity"=>["<string>", "<string>"], "people_gender"=>"<string>", "people_number"=>"<integer>", "query"=>"<string>", "region"=>"<country-code-2>", "safe"=>true, "sort"=>"popular", "spellcheck_query"=>true, "view"=>"minimal", "width"=>"<integer>", "width_from"=>"<integer>", "width_to"=>"<integer>"}, {"added_date"=>"<date>", "added_date_start"=>"<date>", "aspect_ratio_min"=>"<number>", "aspect_ratio_max"=>"<number>", "aspect_ratio"=>"<number>", "added_date_end"=>"<date>", "authentic"=>"<boolean>", "category"=>"<string>", "color"=>"<string>", "contributor"=>["<string>", "<string>"], "contributor_country"=>["<country-code-2>", "<country-code-2>"], "fields"=>"<string>", "height"=>"<integer>", "height_from"=>"<integer>", "height_to"=>"<integer>", "image_type"=>["<string>", "<string>"], "keyword_safe_search"=>true, "language"=>"<string>", "license"=>["commercial"], "model"=>["<string>", "<string>"], "orientation"=>"<string>", "page"=>1, "per_page"=>20, "people_model_released"=>"<boolean>", "people_age"=>"<string>", "people_ethnicity"=>["<string>", "<string>"], "people_gender"=>"<string>", "people_number"=>"<integer>", "query"=>"<string>", "region"=>"<country-code-2>", "safe"=>true, "sort"=>"popular", "spellcheck_query"=>true, "view"=>"minimal", "width"=>"<integer>", "width_from"=>"<integer>", "width_to"=>"<integer>"}]
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
User-Agent | string |
RESPONSES
status: OK
{"results":[{"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/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"}],"page":1,"per_page":5,"search_id":"749090bb-2967-4a20-b22e-c800dc845e10","spellcheck_info":{},"total_count":45},{"data":[],"page":1,"per_page":5,"search_id":"749090bb-2967-4a20-b22e-c800dc845e11","spellcheck_info":{},"total_count":0}]}