Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
images

Search for images

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

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

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

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
}
All 109 operations