Shutterstock API Explorer

Tools (120)

Extracted live via the executor SDK.

• audio.addTrackCollectionItems

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

• audio.createTrackCollection

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

• audio.deleteTrackCollection

  This endpoint deletes a collection.

• audio.deleteTrackCollectionItems

  This endpoint removes one or more tracks from a collection.

• audio.downloadTracks

  This endpoint redownloads tracks that you have already received a license for. The download links in the response are valid for 8 hours.

• audio.getTrack

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

• audio.getTrackCollection

  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.

• audio.getTrackCollectionItems

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

• audio.getTrackCollectionList

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

• audio.getTrackLicenseList

  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.

• audio.getTrackList

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

• audio.licenseTrack

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

• audio.listGenres

  This endpoint returns a list of all audio genres.

• audio.listInstruments

  This endpoint returns a list of all audio instruments.

• audio.listMoods

  This endpoint returns a list of all audio moods.

• audio.renameTrackCollection

  This endpoint sets a new name for a collection.

• audio.searchTracks

  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.

• catalog.addToCollection

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

• catalog.createCollection

  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.

• catalog.deleteCollection

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

• catalog.deleteFromCollection

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

• catalog.getCollections

  This endpoint returns a list of catalog collections.

• catalog.searchCatalog

  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.

• catalog.updateCollection

  This endpoint updates the metadata of a catalog collection.

• computerVision.getKeywords

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

• computerVision.getSimilarImages

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

• computerVision.getSimilarVideos

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

• computerVision.uploadEphemeralImage

  Deprecated; use POST /v2/cv/images instead. This endpoint uploads an image for reverse image search. The image must be in JPEG or PNG format. To get the search results, pass the ID that this endpoint returns to the GET /v2/images/{id}/similar endpoint.

• computerVision.uploadImage

  This endpoint uploads an image for reverse image or video search. Images must be in JPEG or PNG format. To get the search results, pass the upload ID that this endpoint returns to the GET /v2/cv/similar/images or GET /v2/cv/similar/videos endpoints. Contact us for access to this endpoint.

• contributors.getContributor

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

• contributors.getContributorCollectionItems

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

• contributors.getContributorCollections

  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.

• contributors.getContributorCollectionsList

  This endpoint lists collections based on contributor ID.

• contributors.getContributorList

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

• customMusic.createAudioRenders

  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.

• customMusic.fetchRenders

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

• customMusic.listCustomDescriptors

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

• customMusic.listCustomInstruments

  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.

• editorialImages.getEditorialCategories

  Deprecated; use GET /v2/editorial/images/categories instead. 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.

• editorialImages.getEditorialImage

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

• editorialImages.getEditorialImageLicenseList

  This endpoint lists existing editorial image licenses.

• editorialImages.getEditorialImageLivefeed

  Get editorial livefeed

• editorialImages.getEditorialImageLivefeedItems

  Get editorial livefeed items

• editorialImages.getEditorialImageLivefeedList

  Get editorial livefeed list

• editorialImages.getEditorialLivefeed

  Deprecated: use GET /v2/editorial/images/livefeeds/{id} instead to get an editorial livefeed.

• editorialImages.getEditorialLivefeedItems

  Deprecated; use GET /v2/editorial/images/livefeeds/{id}/items instead to get editorial livefeed items.

• editorialImages.getEditorialLivefeedList

  Deprecated; use GET /v2/editorial/images/livefeeds instead to get a list of editorial livefeeds.

• editorialImages.getUpdatedEditorialImage

  Deprecated; use GET /v2/editorial/images/updated instead to get recently updated items.

• editorialImages.getUpdatedEditorialImages

  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.

• editorialImages.getV2EditorialId

  Deprecated; use GET /v2/editorial/images/{id} instead to show information about an editorial image, including a URL to a preview image and the sizes that it is available in.

• editorialImages.licenseEditorialImage

  Deprecated; use POST /v2/editorial/images/licenses instead to get 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.

• editorialImages.licenseEditorialImages

  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.

• editorialImages.listEditorialImageCategories

  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.

• editorialImages.searchEditorial

  Deprecated; use GET /v2/editorial/images/search instead to search for editorial images.

• editorialImages.searchEditorialImages

  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.

• editorialVideo.getEditorialVideo

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

• editorialVideo.getEditorialVideoLicenseList

  This endpoint lists existing editorial video licenses.

• editorialVideo.licenseEditorialVideo

  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.

• editorialVideo.listEditorialVideoCategories

  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.

• editorialVideo.searchEditorialVideos

  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.

• images.addImageCollectionItems

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

• images.bulkSearchImages

  This endpoint runs up to 5 image searches in a single request and returns up to 20 results per search. You can provide global search parameters in the query parameters and override them for each search in the body parameter. The query and body parameters are the same as in the GET /v2/images/search endpoint.

• images.createImageCollection

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

• images.deleteImageCollection

  This endpoint deletes an image collection.

• images.deleteImageCollectionItems

  This endpoint removes one or more images from a collection.

• images.downloadImage

  This endpoint redownloads images that you have already received a license for. The download links in the response are valid for 8 hours.

• images.getFeaturedImageCollection

  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.

• images.getFeaturedImageCollectionItems

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

• images.getFeaturedImageCollectionList

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

• images.getImage

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

• images.getImageCollection

  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.

• images.getImageCollectionItems

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

• images.getImageCollectionList

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

• images.getImageKeywordSuggestions

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

• images.getImageLicenseList

  This endpoint lists existing licenses.

• images.getImageList

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

• images.getImageRecommendations

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

• images.getImageSuggestions

  This endpoint provides autocomplete suggestions for partial search terms.

• images.getUpdatedImages

  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.

• images.licenseImages

  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.

• images.listImageCategories

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

• images.listSimilarImages

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

• images.renameImageCollection

  This endpoint sets a new name for an image collection.

• images.searchImages

  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.

• oauth.authorize

  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.

• oauth.createAccessToken

  This endpoint returns an access token for the specified user and with the specified scopes. The token does not expire until the user changes their password. The body parameters must be encoded as form data.

• soundEffects.downloadSfx

  This endpoint redownloads sound effects that you have already received a license for. The download links in the response are valid for 8 hours.

• soundEffects.getSfxDetails

  This endpoint shows information about a sound effect.

• soundEffects.getSfxLicenseList

  This endpoint lists existing licenses.

• soundEffects.getSfxListDetails

  This endpoint shows information about sound effects.

• soundEffects.licensesSfx

  This endpoint licenses sounds effect assets.

• soundEffects.searchSfx

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

• test.echo

  Echo text

• test.validate

  Validate input

• users.getAccessToken

  Get access token details

• users.getUser

  Get user details

• users.getUserSubscriptionList

  List user subscriptions

• videos.addVideoCollectionItems

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

• videos.createVideoCollection

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

• videos.deleteVideoCollection

  This endpoint deletes a collection.

• videos.deleteVideoCollectionItems

  This endpoint removes one or more videos from a collection.

• videos.downloadVideos

  This endpoint redownloads videos that you have already received a license for.

• videos.findSimilarVideos

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

• videos.getFeaturedVideoCollection

  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.

• videos.getFeaturedVideoCollectionItems

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

• videos.getFeaturedVideoCollectionList

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

• videos.getUpdatedVideos

  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.

• videos.getVideo

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

• videos.getVideoCollection

  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.

• videos.getVideoCollectionItems

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

• videos.getVideoCollectionList

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

• videos.getVideoLicenseList

  This endpoint lists existing licenses.

• videos.getVideoList

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

• videos.getVideoSuggestions

  This endpoint provides autocomplete suggestions for partial search terms.

• videos.licenseVideos

  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.

• videos.listVideoCategories

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

• videos.renameVideoCollection

  This endpoint sets a new name for a collection.

• videos.searchVideos

  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.

• openapi.previewSpec

  Preview an OpenAPI document before adding it as a source

• openapi.addSource

  Add an OpenAPI source and register its operations as tools