Shutterstock API Explorer

Add audio tracks to collections

This endpoint adds one or more tracks to a collection by track IDs.

Add images to collections

This endpoint adds one or more images to a collection by image IDs.

Add items to catalog collections

This endpoint adds assets to a catalog collection. It also automatically adds the assets to the user's account's catalog.

Add videos to collections

This endpoint adds one or more videos to a collection by video IDs.

Authorize applications

This endpoint returns a redirect URI (in the 'Location' header) that the customer uses to authorize your application and, together with POST /v2/oauth/access_token, generate an access token that represents that authorization.

Create audio collections

This endpoint creates one or more collections (soundboxes). To add tracks, use `POST /v2/audio/collections/{id}/items`.

Create catalog collections

This endpoint creates a catalog collection and optionally adds assets. To add assets to the collection later, use `PATCH /v2/catalog/collections/{collection_id}/items`.

Create image collections

This endpoint creates one or more image collections (lightboxes). To add images to the collections, use `POST /v2/images/collections/{id}/items`.

Create rendered audio

This endpoint creates rendered audio from timeline data. It returns a render ID that you can use to download the finished audio when it is ready. The render ID is valid for up to 48 hours.

Create video collections

This endpoint creates one or more collections (clipboxes). To add videos to collections, use `POST /v2/videos/collections/{id}/items`.

Delete audio collections

This endpoint deletes a collection.

Delete catalog collections

This endpoint deletes a catalog collection. It does not remove the assets from the user's account's catalog.

Delete image collections

This endpoint deletes an image collection.

Delete video collections

This endpoint deletes a collection.

Echo text

Get details about a single contributor

This endpoint shows information about a single contributor, including contributor type, equipment they use, and other attributes.

Get details about audio renders

This endpoint shows the status of one or more audio renders, including download links for completed audio.

Get details about audio tracks

This endpoint shows information about a track, including its genres, instruments, and other attributes.

Get details about contributors' collections

This endpoint gets more detailed information about a contributor's collection, including its cover image, timestamps for its creation, and most recent update. To get the items in collections, use GET /v2/contributors/{contributor_id}/collections/{id}/items.

Get details about images

This endpoint shows information about an image, including a URL to a preview image and the sizes that it is available in.

Get details about multiple contributors

This endpoint lists information about one or more contributors, including contributor type, equipment they use and other attributes.

Get details about sound effects

This endpoint shows information about a sound effect.

Get details about videos

This endpoint shows information about a video, including URLs to previews and the sizes that it is available in.

Get editorial content details

This endpoint shows information about an editorial image, including a URL to a preview image and the sizes that it is available in.

Get editorial livefeed

Get editorial livefeed items

Get editorial livefeed list

Get editorial video content details

This endpoint shows information about an editorial image, including a URL to a preview image and the sizes that it is available in.

Get keywords from text

This endpoint returns up to 10 important keywords from a block of plain text.

Get suggestions for a search term

This endpoint provides autocomplete suggestions for partial search terms.

Get suggestions for a search term

This endpoint provides autocomplete suggestions for partial search terms.

Get the contents of audio collections

This endpoint lists the IDs of tracks in a collection and the date that each was added.

Get the contents of featured image collections

This endpoint lists the IDs of images in a featured collection and the date that each was added.

Get the contents of featured video collections

This endpoint lists the IDs of videos in a featured collection and the date that each was added.

Get the contents of image collections

This endpoint lists the IDs of images in a collection and the date that each was added.

Get the contents of video collections

This endpoint lists the IDs of videos in a collection and the date that each was added.

Get the details of audio collections

This endpoint gets more detailed information about a collection, including the number of items in it and when it was last updated. To get the tracks in collections, use `GET /v2/audio/collections/{id}/items`.

Get the details of featured image collections

This endpoint gets more detailed information about a featured collection, including its cover image and timestamps for its creation and most recent update. To get the images, use `GET /v2/images/collections/featured/{id}/items`.

Get the details of featured video collections

This endpoint gets more detailed information about a featured video collection, including its cover video and timestamps for its creation and most recent update. To get the videos, use `GET /v2/videos/collections/featured/{id}/items`.

Get the details of image collections

This endpoint gets more detailed information about a collection, including its cover image and timestamps for its creation and most recent update. To get the images in collections, use `GET /v2/images/collections/{id}/items`.

Get the details of video collections

This endpoint gets more detailed information about a collection, including the timestamp for its creation and the number of videos in it. To get the videos in collections, use GET /v2/videos/collections/{id}/items.

Get the items in contributors' collections

This endpoint lists the IDs of items in a contributor's collection and the date that each was added.

Get user details

License audio tracks

This endpoint gets licenses for one or more tracks. The download links in the response are valid for 8 hours.

License editorial content

This endpoint gets licenses for one or more editorial images. You must specify the country and one or more editorial images to license. The download links in the response are valid for 8 hours.

License editorial video content

This endpoint gets licenses for one or more editorial videos. You must specify the country and one or more editorial videos to license. The download links in the response are valid for 8 hours.

License images

This endpoint gets licenses for one or more images. You must specify the image IDs in the body parameter and other details like the format, size, and subscription ID either in the query parameter or with each image ID in the body parameter. Values in the body parameter override values in the query parameters. The download links in the response are valid for 8 hours.

License sound effects

This endpoint licenses sounds effect assets.

License videos

This endpoint gets licenses for one or more videos. You must specify the video IDs in the body parameter and the size and subscription ID either in the query parameter or with each video ID in the body parameter. Values in the body parameter override values in the query parameters. The download links in the response are valid for 8 hours.

List audio collections

This endpoint lists your collections of audio tracks and their basic attributes.

List audio genres

This endpoint returns a list of all audio genres.

List audio instruments

This endpoint returns a list of all audio instruments.

List audio licenses

This endpoint lists existing licenses. You can filter the results according to the track ID to see if you have an existing license for a specific track.

List audio moods

This endpoint returns a list of all audio moods.

List audio tracks

This endpoint lists information about one or more audio tracks, including the description and publication date.

List catalog collections

This endpoint returns a list of catalog collections.

List computer audio descriptors

This endpoint lists the descriptors that you can use in the audio regions in an audio render.

List computer audio instruments

This endpoint lists the instruments that you can include in computer audio. If you specify more than one search parameter, the API uses an AND condition.

List contributors' collections

This endpoint lists collections based on contributor ID.

List details about sound effects

This endpoint shows information about sound effects.

List editorial categories

This endpoint lists the categories that editorial images can belong to, which are separate from the categories that other types of assets can belong to.

List editorial image licenses

This endpoint lists existing editorial image licenses.

List editorial video categories

This endpoint lists the categories that editorial videos can belong to, which are separate from the categories that other types of assets can belong to.

List editorial video licenses

This endpoint lists existing editorial video licenses.

List featured image collections

This endpoint lists featured collections of specific types and a name and cover image for each collection.

List featured video collections

This endpoint lists featured video collections and a name and cover video for each collection.

List image categories

This endpoint lists the categories (Shutterstock-assigned genres) that images can belong to.

List image collections

This endpoint lists your collections of images and their basic attributes.

List image licenses

This endpoint lists existing licenses.

List images

This endpoint lists information about one or more images, including the available sizes.

List recommended images

This endpoint returns images that customers put in the same collection as the specified image IDs.

List similar images

This endpoint returns images that are visually similar to an image that you specify or upload.

List similar images

This endpoint returns images that are visually similar to an image that you specify.

List similar videos

This endpoint searches for videos that are similar to a video that you specify.

List similar videos

This endpoint returns videos that are visually similar to an image that you specify or upload.

List sound effects licenses

This endpoint lists existing licenses.

List suggested keywords

This endpoint returns a list of suggested keywords for a media item that you specify or upload.

List updated content

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.

List updated images

This endpoint lists 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 `interval` parameter to show images that were updated recently, but you can also use the `start_date` and `end_date` parameters to specify a range of no more than three days. Do not use the `interval` parameter with either `start_date` or `end_date`.

List updated videos

This endpoint lists videos 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 `interval` parameter to show videos that were updated recently, but you can also use the `start_date` and `end_date` parameters to specify a range of no more than three days. Do not use the `interval` parameter with either `start_date` or `end_date`.

List user subscriptions

List video categories

This endpoint lists the categories (Shutterstock-assigned genres) that videos can belong to.

List video collections

This endpoint lists your collections of videos and their basic attributes.

List video licenses

This endpoint lists existing licenses.

List videos

This endpoint lists information about one or more videos, including the aspect ratio and URLs to previews.

Remove audio tracks from collections

This endpoint removes one or more tracks from a collection.

Remove images from collections

This endpoint removes one or more images from a collection.

Remove items from catalog collection

This endpoint removes assets from a catalog collection. It does not remove the assets from the user's account's catalog.

Remove videos from collections

This endpoint removes one or more videos from a collection.

Rename audio collections

This endpoint sets a new name for a collection.

Rename image collections

This endpoint sets a new name for an image collection.

Search catalogs for assets

This endpoint searches for assets in the account's catalog. 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.

Search editorial images

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.

Search editorial video content

This endpoint searches for editorial videos. 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 videos 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.

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.

Search for sound effects

This endpoint searches for sound effects. If you specify more than one search parameter, the API uses an AND condition.

Search for tracks

This endpoint searches for tracks. 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.

Search for videos

This endpoint searches for videos. 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.

Update collection metadata

This endpoint updates the metadata of a catalog collection.

Validate input