SHshutterstock
images

Search for images

Changed on

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.

get/v2/images/search

Request

Query parameters

librarystring[]

Search within different Shutterstock owned libraries

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

querystring

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

exact_matchboolean

Require exact keyword matching and disable enhanced search behavior

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' | 'oldest'

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

Response

OK

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

  • b43cab3aaaaaRevision changes
    • info

      added the new optional query request parameter exact_match

    • info

      added the new enum value oldest to the query request parameter sort

    • 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

  • d2e03e7f655dRevision changes
    • info

      added the new optional query request parameter library

    • 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 enum value NOT african to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT african_american to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT black to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT brazilian to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT caucasian to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT chinese to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT east_asian to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT hispanic to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT japanese to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT middle_eastern to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT native_american to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT other to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT pacific_islander to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT south_asian to the property items/ of the query request parameter people_ethnicity

    • info

      added the enum value NOT southeast_asian to the property items/ of the query request parameter people_ethnicity

    • info

      added the optional property /// to the response with the status