GET v2/images/search
Operation ID: searchImages
Auth: unknown
Description
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.
Parameters (40)
(string, query, optional)
Show images added on the specified date
(string, query, optional)
Show images added before the specified date
(string, query, optional)
Show images added on or after the specified date
(string, query, optional)
For AI-powered search, specify the industry to target; requires that the `ai_search` parameter is set to true
Constraints: {'enum': ['automotive', 'cpg', 'finance', 'healthcare', 'retail', 'technology']}
(integer, query, optional, default: 20)
For AI-powered search, specify the maximum number of labels to return
Constraints: {'minimum': 0, 'maximum': 500}
(string, query, optional)
For AI-powered search, specify the goal of the media; requires that the `ai_search` parameter is set to true
Constraints: {'enum': ['awareness', 'traffic', 'conversions']}
(boolean, query, optional)
Set to true and specify the `ai_objective` and `ai_industry` parameters to use AI-powered search; the API returns information about how well images meet the objective for the industry
(number, query, optional)
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
Constraints: {'minimum': 0}
(number, query, optional)
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
Constraints: {'minimum': 0}
(number, query, optional)
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
Constraints: {'minimum': 0}
(string, query, optional)
Show images with the specified Shutterstock-defined category; specify a category name or ID
(string, query, optional)
Specify either a hexadecimal color in the format '4F21EA' or 'grayscale'; the API returns images that use similar colors
(array, query, optional)
Show images with the specified contributor names or IDs, allows multiple
(?, query, optional)
Show images from contributors in one or more specified countries, or start with NOT to exclude a country from the search
(string, query, optional)
Fields to display in the response; see the documentation for the fields parameter in the overview section
(integer, query, optional)
(Deprecated; use height_from and height_to instead) Show images with the specified height
(integer, query, optional)
Show images with the specified height or larger, in pixels
(integer, query, optional)
Show images with the specified height or smaller, in pixels
(array, query, optional)
Show images of the specified type
(boolean, query, optional, default: True)
Hide results with potentially unsafe keywords
(?, query, optional)
Set query and result language (uses Accept-Language header if not set)
(array, query, optional)
Show only images with the specified license
(array, query, optional)
Show image results with the specified model IDs
(string, query, optional)
Show image results with horizontal or vertical orientation
Constraints: {'enum': ['horizontal', 'vertical']}
(integer, query, optional, default: 1)
Page number
Constraints: {'minimum': 1}
(string, query, optional)
Show images that feature people of the specified age category
Constraints: {'enum': ['infants', 'children', 'teenagers', '20s', '30s', '40s', '50s', '60s', 'older']}
(array, query, optional)
Show images with people of the specified ethnicities, or start with NOT to show images without those ethnicities
(string, query, optional)
Show images with people of the specified gender
Constraints: {'enum': ['male', 'female', 'both']}
(boolean, query, optional)
Show images of people with a signed model release
(integer, query, optional)
Show images with the specified number of people
Constraints: {'minimum': 0, 'maximum': 4}
(integer, query, optional, default: 20)
Number of results per page
Constraints: {'minimum': 0, 'maximum': 500}
(string, query, optional)
One or more search terms separated by spaces; you can use NOT to filter out images that match a term
(?, query, optional)
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
(boolean, query, optional, default: True)
Enable or disable safe search
(string, query, optional, default: popular)
Sort by
Constraints: {'enum': ['newest', 'popular', 'relevance', 'random']}
(boolean, query, optional, default: True)
Spellcheck the search query and return results on suggested spellings
(string, query, optional, default: minimal)
Amount of detail to render in the response
Constraints: {'enum': ['minimal', 'full']}
(integer, query, optional)
(Deprecated; use width_from and width_to instead) Show images with the specified width
(integer, query, optional)
Show images with the specified width or larger, in pixels
(integer, query, optional)
Show images with the specified width or smaller, in pixels
No probe data for this endpoint yet.