Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
images

Run multiple image searches

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.

post/v2/bulk_search/images

Query parameters

added_datestring date

Show images added on the specified date

added_date_startstring date

Show images added on or after the specified date

aspect_ratio_minnumber

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_maxnumber

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_rationumber

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_endstring date

Show images added before the specified date

categorystring

Show images with the specified Shutterstock-defined category; specify a category name or ID

colorstring

Specify either a hexadecimal color in the format '4F21EA' or 'grayscale'; the API returns images that use similar colors

contributorstring[]

Show images with the specified contributor names or IDs, allows multiple

string[]
OR
string[]

Show images from contributors in one or more specified countries, or start with NOT to exclude a country from the search

fieldsstring

Fields to display in the response; see the documentation for the fields parameter in the overview section

heightinteger

(Deprecated; use height_from and height_to instead) Show images with the specified height

height_frominteger

Show images with the specified height or larger, in pixels

height_tointeger

Show images with the specified height or smaller, in pixels

image_typestring[]

Show images of the specified type

keyword_safe_searchboolean

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'

Language code

Example:cs

Set query and result language (uses Accept-Language header if not set)

licensestring[]

Show only images with the specified license

modelstring[]

Show image results with the specified model IDs

orientation'horizontal' | 'vertical'

Show image results with horizontal or vertical orientation

pageinteger

Page number

per_pageinteger

Number of results per page

people_model_releasedboolean

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_ethnicitystring[]

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_numberinteger

Show images with the specified number of people

string country-code-2
OR
string ipv4

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

safeboolean

Enable or disable safe search

sort'newest' | 'popular' | 'relevance' | 'random'

Sort by

spellcheck_queryboolean

Spellcheck the search query and return results on suggested spellings

view'minimal' | 'full'

Amount of detail to render in the response

widthinteger

(Deprecated; use width_from and width_to instead) Show images with the specified width

width_frominteger

Show images with the specified width or larger, in pixels

width_tointeger

Show images with the specified width or smaller, in pixels

Request body

added_datestring date

Show images added on the specified date

added_date_startstring date

Show images added on or after the specified date

aspect_ratio_minnumber

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_maxnumber

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_rationumber

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_endstring date

Show images added before the specified date

authenticboolean

Show only authentic images

categorystring

Show images with the specified Shutterstock-defined category; specify a category name or ID

colorstring

Specify either a hexadecimal color in the format '4F21EA' or 'grayscale'; the API returns images that use similar colors

contributorstring[]

Show images with the specified contributor names or IDs, allows multiple

fieldsstring

Fields to display in the response; see the documentation for the fields parameter in the overview section

heightinteger

(Deprecated; use height_from and height_to instead) Show images with the specified height

height_frominteger

Show images with the specified height or larger, in pixels

height_tointeger

Show images with the specified height or smaller, in pixels

image_typestring[]

Show images of the specified type

keyword_safe_searchboolean

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)

licensestring[]

Show only images with the specified license

modelstring[]

Show image results with the specified model IDs

orientation'horizontal' | 'vertical'

Show image results with horizontal or vertical orientation

pageinteger

Page number

per_pageinteger

Number of results per page

people_model_releasedboolean

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_ethnicitystring[]

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_numberinteger

Show images with the specified number of people

querystring

One or more search terms separated by spaces; you can use NOT to filter out images that match a term

safeboolean

Enable or disable safe search

sort'newest' | 'popular' | 'relevance' | 'random'

Sort by

spellcheck_queryboolean

Spellcheck the search query and return results on suggested spellings

view'minimal' | 'full'

Amount of detail to render in the response

widthinteger

(Deprecated; use width_from and width_to instead) Show images with the specified width

width_frominteger

Show images with the specified width or larger, in pixels

width_tointeger

Show images with the specified width or smaller, in pixels

Example request

[
  {
    "query": "cat",
    "license": [
      "editorial"
    ],
    "sort": "popular"
  },
  {
    "query": "dog",
    "orientation": "horizontal"
  }
]

Response

OK

bulk_search_idstring

Unique identifier for the search request

Example response

{
  "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
    }
  ]
}