GET /v2/editorial/images/search

shutterstock.com

Summary: Search editorial images
Operation ID: searchEditorialImages
Auth: unknown
Description

This endpoint searches for editorial images. If you specify more than one search parameter, the API uses an AND condition. For example, if you set the `category` parameter to "Alone,Performing" and also specify a `query` parameter, the results include only images that match the query and are in both the Alone and Performing categories. You can also filter search terms out in the `query` parameter by prefixing the term with NOT.

Parameters (9)

category (string, query, optional)

Show editorial content with each of the specified editorial categories; specify category names in a comma-separated list

country (string, query, required)

Show only editorial content that is available for distribution in a certain country

cursor (string, query, optional)

The cursor of the page with which to start fetching results; this cursor is returned from previous requests

date_end (string, query, optional)

Show only editorial content generated on or before a specific date

date_start (string, query, optional)

Show only editorial content generated on or after a specific date

per_page (integer, query, optional, default: 20)

Number of results per page

Constraints: {'minimum': 1, 'maximum': 50}

query (string, query, optional)

One or more search terms separated by spaces

sort (string, query, optional, default: relevant)

Sort by

Constraints: {'enum': ['relevant', 'newest', 'oldest']}

supplier_code (array, query, optional)

Show only editorial content from certain suppliers

No probe data for this endpoint yet.