GET /v2/editorial/images/updated

shutterstock.com

Summary: List updated content
Operation ID: getUpdatedEditorialImages
Auth: unknown
Description

This endpoint lists editorial images that have been updated in the specified time period to update content management systems (CMS) or digital asset management (DAM) systems. In most cases, use the date_updated_start and date_updated_end parameters to specify a range updates based on when the updates happened. You can also use the date_taken_start and date_taken_end parameters to specify a range of updates based on when the image was taken.

Parameters (10)

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_taken_end (string, query, optional)

Show images that were taken before the specified date

date_taken_start (string, query, optional)

Show images that were taken on or after the specified date; use this parameter if you want recently created images from the collection instead of updated older assets

date_updated_end (string, query, required)

Show images images added, edited, or deleted before the specified date. Acceptable range is 1970-01-01T00:00:01 to 2038-01-19T00:00:00.

date_updated_start (string, query, required)

Show images images added, edited, or deleted after the specified date. Acceptable range is 1970-01-01T00:00:01 to 2038-01-19T00:00:00.

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

Number of results per page

Constraints: {'minimum': 100, 'maximum': 500}

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

Sort by

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

supplier_code (array, query, optional)

Show only editorial content from certain suppliers

type (string, query, required)

Specify `addition` to return only images that were added or `edit` to return only images that were edited or deleted

Constraints: {'enum': ['edit', 'addition']}

No probe data for this endpoint yet.