Search for images
GET {{baseUrl}}/v2/images/search
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.
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 | |
query | string | One or more search terms separated by spaces; you can use NOT to filter out images that match a term | |
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 |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
User-Agent | string |
RESPONSES
status: OK
{"page":1,"per_page":1,"total_count":193097419,"search_id":"p5S6QwRikdFJTHXwsoiqTg","data":[{"id":"1120280123","aspect":1.6667,"assets":{"preview":{"height":269,"url":"https://image.shutterstock.com/display_pic_with_logo/3673637/1120280123/stock-vector-minimal-geometric-background-dynamic-shapes-composition-eps-vector-1120280123.jpg","width":450},"small_thumb":{"height":60,"url":"https://thumb10.shutterstock.com/thumb_small/3673637/1120280123/stock-vector-minimal-geometric-background-dynamic-shapes-composition-eps-vector-1120280123.jpg","width":100},"large_thumb":{"height":90,"url":"https://thumb10.shutterstock.com/thumb_large/3673637/1120280123/stock-vector-minimal-geometric-background-dynamic-shapes-composition-eps-vector-1120280123.jpg","width":150},"huge_thumb":{"height":260,"url":"https://image.shutterstock.com/image-vector/minimal-geometric-background-dynamic-shapes-260nw-1120280123.jpg","width":435},"preview_1000":{"url":"https://ak.picdn.net/shutterstock/photos/1120280123/watermark_1000/f4954f705e782cc12cd13910137e3555/preview_1000-1120280123.jpg","width":1000,"height":600},"preview_1500":{"url":"https://image.shutterstock.com/z/stock-vector-minimal-geometric-background-dynamic-shapes-composition-eps-vector-1120280123.jpg","width":1500,"height":900}},"contributor":{"id":"3673637"},"description":"Minimal geometric background. Dynamic shapes composition. Eps10 vector.","image_type":"vector","has_model_release":false,"media_type":"image","url":"https://www.shutterstock.com/image-photo/1120280123"}]}