Shutterstock

opencollection: 1.0.0
info:
  name: Shutterstock API Reference
  version: 1.0.30
items:
- info:
    name: images
    type: folder
  items:
  - info:
      name: Search for images
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/search
      params:
      - name: added_date
        value: ''
        type: query
        description: Show images added on the specified date
      - name: added_date_start
        value: ''
        type: query
        description: Show images added on or after the specified date
      - name: aspect_ratio_min
        value: ''
        type: query
        description: 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
      - name: aspect_ratio_max
        value: ''
        type: query
        description: 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
      - name: aspect_ratio
        value: ''
        type: query
        description: 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
      - name: added_date_end
        value: ''
        type: query
        description: Show images added before the specified date
      - name: category
        value: ''
        type: query
        description: Show images with the specified Shutterstock-defined category; specify a category name or ID
      - name: color
        value: ''
        type: query
        description: Specify either a hexadecimal color in the format '4F21EA' or 'grayscale'; the API groups it into one
          of 15 color categories and returns images that primarily use that color category
      - name: contributor
        value: ''
        type: query
        description: Show images with the specified contributor names or IDs, allows multiple
      - name: contributor_country
        value: ''
        type: query
        description: Show images from contributors in one or more specified countries
      - name: fields
        value: ''
        type: query
        description: Fields to display in the response; see the documentation for the fields parameter in the overview section
      - name: height
        value: ''
        type: query
        description: (Deprecated; use height_from and height_to instead) Show images with the specified height
      - name: height_from
        value: ''
        type: query
        description: Show images with the specified height or larger, in pixels
      - name: height_to
        value: ''
        type: query
        description: Show images with the specified height or smaller, in pixels
      - name: image_type
        value: ''
        type: query
        description: Show images of the specified type
      - name: keyword_safe_search
        value: ''
        type: query
        description: Hide results with potentially unsafe keywords
      - name: language
        value: ''
        type: query
        description: Set query and result language (uses Accept-Language header if not set)
      - name: license
        value: ''
        type: query
        description: Show only images with the specified license
      - name: model
        value: ''
        type: query
        description: Show image results with the specified model IDs
      - name: orientation
        value: ''
        type: query
        description: Show image results with horizontal or vertical orientation
      - name: page
        value: ''
        type: query
        description: Page number
      - name: per_page
        value: ''
        type: query
        description: Number of results per page
      - name: people_model_released
        value: ''
        type: query
        description: Show images of people with a signed model release
      - name: people_age
        value: ''
        type: query
        description: Show images that feature people of the specified age category
      - name: people_ethnicity
        value: ''
        type: query
        description: Show images with people of the specified ethnicities
      - name: people_gender
        value: ''
        type: query
        description: Show images with people of the specified gender
      - name: people_number
        value: ''
        type: query
        description: Show images with the specified number of people
      - name: query
        value: ''
        type: query
        description: One or more search terms separated by spaces; you can use NOT to filter out images that match a term
      - name: region
        value: ''
        type: query
        description: 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
      - name: safe
        value: ''
        type: query
        description: Enable or disable safe search
      - name: sort
        value: ''
        type: query
        description: Sort by
      - name: spellcheck_query
        value: ''
        type: query
        description: Spellcheck the search query and return results on suggested spellings
      - name: view
        value: ''
        type: query
        description: Amount of detail to render in the response
      - name: width
        value: ''
        type: query
        description: (Deprecated; use width_from and width_to instead) Show images with the specified width
      - name: width_from
        value: ''
        type: query
        description: Show images with the specified width or larger, in pixels
      - name: width_to
        value: ''
        type: query
        description: Show images with the specified width or smaller, in pixels
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: 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
  - info:
      name: Get suggestions for a search term
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/search/suggestions
      params:
      - name: query
        value: cats
        type: query
        description: Search term for which you want keyword suggestions
      - name: limit
        value: ''
        type: query
        description: Limit the number of suggestions
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint provides autocomplete suggestions for partial search terms.
  - info:
      name: Get keywords from text
      type: http
    http:
      method: POST
      url: https://api.shutterstock.com/v2/images/search/suggestions
      body:
        type: json
        data: '{}'
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint returns up to 10 important keywords from a block of plain text.
  - info:
      name: Get details about images
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/:id
      params:
      - name: id
        value: '465011609'
        type: path
        description: Image ID
      - name: language
        value: es
        type: query
        description: Language for the keywords and categories in the response
      - name: view
        value: ''
        type: query
        description: Amount of detail to render in the response
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint shows information about an image, including a URL to a preview image and the sizes that it is available
      in.
  - info:
      name: List image categories
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/categories
      params:
      - name: language
        value: es
        type: query
        description: Language for the keywords and categories in the response
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint lists the categories (Shutterstock-assigned genres) that images can belong to.
  - info:
      name: List similar images
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/:id/similar
      params:
      - name: id
        value: '465011609'
        type: path
        description: Image ID
      - name: language
        value: es
        type: query
        description: Language for the keywords and categories in the response
      - name: page
        value: ''
        type: query
        description: Page number
      - name: per_page
        value: ''
        type: query
        description: Number of results per page
      - name: view
        value: ''
        type: query
        description: Amount of detail to render in the response
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint returns images that are visually similar to an image that you specify.
  - info:
      name: List image licenses
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/licenses
      params:
      - name: image_id
        value: ''
        type: query
        description: Show licenses for the specified image ID
      - name: license
        value: ''
        type: query
        description: Show images that are available with the specified license, such as `standard` or `enhanced`; prepending
          a `-` sign excludes results from that license
      - name: page
        value: ''
        type: query
        description: Page number
      - name: per_page
        value: ''
        type: query
        description: Number of results per page
      - name: sort
        value: ''
        type: query
        description: Sort order
      - name: username
        value: ''
        type: query
        description: Filter licenses by username of licensee
      - name: start_date
        value: 2020-02-02T13:00-05:00
        type: query
        description: Show licenses created on or after the specified date
      - name: end_date
        value: 2020-02-02T13:00-05:00
        type: query
        description: Show licenses created before the specified date
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint lists existing licenses.
  - info:
      name: License images
      type: http
    http:
      method: POST
      url: https://api.shutterstock.com/v2/images/licenses
      params:
      - name: subscription_id
        value: ''
        type: query
        description: Subscription ID to use to license the image
      - name: format
        value: ''
        type: query
        description: Image format
      - name: size
        value: ''
        type: query
        description: Image size
      - name: search_id
        value: ''
        type: query
        description: Search ID that was provided in the results of an image search
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: 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.
  - info:
      name: Download images
      type: http
    http:
      method: POST
      url: https://api.shutterstock.com/v2/images/licenses/:id/downloads
      params:
      - name: id
        value: e123
        type: path
        description: License ID
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint redownloads images that you have already received a license for.
  - info:
      name: List recommended images
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/recommendations
      params:
      - name: id
        value: '465011609'
        type: query
        description: Image IDs
      - name: max_items
        value: ''
        type: query
        description: Maximum number of results returned in the response
      - name: safe
        value: ''
        type: query
        description: Restrict results to safe images
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint returns images that customers put in the same collection as the specified image IDs.
  - info:
      name: List image collections
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/collections
      params:
      - name: embed
        value: share_code
        type: query
        description: Which sharing information to include in the response, such as a URL to the collection
      - name: page
        value: '1'
        type: query
        description: Page number
      - name: per_page
        value: '2'
        type: query
        description: Number of results per page
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint lists your collections of images and their basic attributes.
  - info:
      name: Create image collections
      type: http
    http:
      method: POST
      url: https://api.shutterstock.com/v2/images/collections
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint creates one or more image collections (lightboxes). To add images to the collections, use `POST /v2/images/collections/{id}/items`.
  - info:
      name: Get the details of image collections
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/collections/:id
      params:
      - name: id
        value: '126351027'
        type: path
        description: Collection ID
      - name: embed
        value: ''
        type: query
        description: Which sharing information to include in the response, such as a URL to the collection
      - name: share_code
        value: ''
        type: query
        description: Code to retrieve a shared collection
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: 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`.
  - info:
      name: Rename image collections
      type: http
    http:
      method: POST
      url: https://api.shutterstock.com/v2/images/collections/:id
      params:
      - name: id
        value: '126351027'
        type: path
        description: Collection ID
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint sets a new name for an image collection.
  - info:
      name: Delete image collections
      type: http
    http:
      method: DELETE
      url: https://api.shutterstock.com/v2/images/collections/:id
      params:
      - name: id
        value: '136351027'
        type: path
        description: Collection ID
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint deletes an image collection.
  - info:
      name: Get the contents of image collections
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/collections/:id/items
      params:
      - name: id
        value: '126351027'
        type: path
        description: Collection ID
      - name: share_code
        value: ''
        type: query
        description: Code to retrieve the contents of a shared collection
      - name: page
        value: ''
        type: query
        description: Page number
      - name: per_page
        value: ''
        type: query
        description: Number of results per page
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint lists the IDs of images in a collection and the date that each was added.
  - info:
      name: Add images to collections
      type: http
    http:
      method: POST
      url: https://api.shutterstock.com/v2/images/collections/:id/items
      params:
      - name: id
        value: '126351027'
        type: path
        description: Collection ID
      body:
        type: json
        data: '{}'
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint adds one or more images to a collection by image IDs.
  - info:
      name: Remove images from collections
      type: http
    http:
      method: DELETE
      url: https://api.shutterstock.com/v2/images/collections/:id/items
      params:
      - name: id
        value: '126351027'
        type: path
        description: Collection ID
      - name: item_id
        value: ''
        type: query
        description: One or more image IDs to remove from the collection
      auth:
        type: oauth2
        flow: authorization_code
        authorizationUrl: https://accounts.shutterstock.com/oauth/authorize
        accessTokenUrl: https://api.shutterstock.com/v2/oauth/access_token
        credentials:
          clientId: '{{clientId}}'
          clientSecret: '{{clientSecret}}'
    docs: This endpoint removes one or more images from a collection.
  - info:
      name: List featured image collections
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/collections/featured
      params:
      - name: embed
        value: share_url
        type: query
        description: Which sharing information to include in the response, such as a URL to the collection
      - name: type
        value: photo
        type: query
        description: The types of collections to return
      - name: asset_hint
        value: share_url
        type: query
        description: Cover image size
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint lists featured collections of specific types and a name and cover image for each collection.
  - info:
      name: Get the details of featured image collections
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/collections/featured/:id
      params:
      - name: id
        value: '136351027'
        type: path
        description: Collection ID
      - name: embed
        value: ''
        type: query
        description: Which sharing information to include in the response, such as a URL to the collection
      - name: asset_hint
        value: ''
        type: query
        description: Cover image size
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: 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`.
  - info:
      name: Get the contents of featured image collections
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/collections/featured/:id/items
      params:
      - name: id
        value: '136351027'
        type: path
        description: Collection ID
      - name: page
        value: ''
        type: query
        description: Page number
      - name: per_page
        value: ''
        type: query
        description: Number of results per page
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint lists the IDs of images in a featured collection and the date that each was added.
  - info:
      name: List updated images
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images/updated
      params:
      - name: type
        value: ''
        type: query
        description: Show images that were added, deleted, or edited; by default, the endpoint returns images that were updated
          in any of these ways
      - name: start_date
        value: ''
        type: query
        description: Show images updated on or after the specified date
      - name: end_date
        value: ''
        type: query
        description: Show images updated before the specified date
      - name: interval
        value: ''
        type: query
        description: Show images updated in the specified time period, where the time period is an interval (like SQL INTERVAL)
          such as 1 DAY, 6 HOUR, or 30 MINUTE; the default is 1 HOUR, which shows images that were updated in the hour preceding
          the request
      - name: page
        value: ''
        type: query
        description: Page number
      - name: per_page
        value: ''
        type: query
        description: Number of results per page
      - name: sort
        value: ''
        type: query
        description: Sort order
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: 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`.
  - info:
      name: List images
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/images
      params:
      - name: id
        value: 1110335168,465011609
        type: query
        description: One or more image IDs
      - name: view
        value: minimal
        type: query
        description: Amount of detail to render in the response
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint lists information about one or more images, including the available sizes.
- info:
    name: videos
    type: folder
  items:
  - info:
      name: Search for videos
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/videos/search
      params:
      - name: added_date
        value: ''
        type: query
        description: Show videos added on the specified date
      - name: added_date_start
        value: ''
        type: query
        description: Show videos added on or after the specified date
      - name: added_date_end
        value: ''
        type: query
        description: Show videos added before the specified date
      - name: aspect_ratio
        value: ''
        type: query
        description: Show videos with the specified aspect ratio
      - name: category
        value: ''
        type: query
        description: Show videos with the specified Shutterstock-defined category; specify a category name or ID
      - name: contributor
        value: ''
        type: query
        description: Show videos with the specified artist names or IDs
      - name: contributor_country
        value: US
        type: query
        description: Show videos from contributors in one or more specified countries
      - name: duration
        value: ''
        type: query
        description: (Deprecated; use duration_from and duration_to instead) Show videos with the specified duration in seconds
      - name: duration_from
        value: ''
        type: query
        description: Show videos with the specified duration or longer in seconds
      - name: duration_to
        value: ''
        type: query
        description: Show videos with the specified duration or shorter in seconds
      - name: fps
        value: ''
        type: query
        description: (Deprecated; use fps_from and fps_to instead) Show videos with the specified frames per second
      - name: fps_from
        value: ''
        type: query
        description: Show videos with the specified frames per second or more
      - name: fps_to
        value: ''
        type: query
        description: Show videos with the specified frames per second or fewer
      - name: keyword_safe_search
        value: ''
        type: query
        description: Hide results with potentially unsafe keywords
      - name: language
        value: ''
        type: query
        description: Set query and result language (uses Accept-Language header if not set)
      - name: license
        value: commercial,editorial
        type: query
        description: Show only videos with the specified license or licenses
      - name: model
        value: 442583,434750
        type: query
        description: Show videos with each of the specified models
      - name: page
        value: ''
        type: query
        description: Page number
      - name: per_page
        value: ''
        type: query
        description: Number of results per page
      - name: people_age
        value: ''
        type: query
        description: Show videos that feature people of the specified age range
      - name: people_ethnicity
        value: ''
        type: query
        description: Show videos with people of the specified ethnicities
      - name: people_gender
        value: ''
        type: query
        description: Show videos with people with the specified gender
      - name: people_number
        value: ''
        type: query
        description: Show videos with the specified number of people
      - name: people_model_released
        value: ''
        type: query
        description: Show only videos of people with a signed model release
      - name: query
        value: ''
        type: query
        description: One or more search terms separated by spaces; you can use NOT to filter out videos that match a term
      - name: resolution
        value: ''
        type: query
        description: Show videos with the specified resolution
      - name: safe
        value: ''
        type: query
        description: Enable or disable safe search
      - name: sort
        value: ''
        type: query
        description: Sort by one of these categories
      - name: view
        value: ''
        type: query
        description: Amount of detail to render in the response
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: 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.
  - info:
      name: Get suggestions for a search term
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/videos/search/suggestions
      params:
      - name: query
        value: cats
        type: query
        description: Search term for which you want keyword suggestions
      - name: limit
        value: ''
        type: query
        description: Limit the number of the suggestions
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint provides autocomplete suggestions for partial search terms.
  - info:
      name: List videos
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/videos
      params:
      - name: id
        value: 639703,993721
        type: query
        description: One or more video IDs
      - name: view
        value: ''
        type: query
        description: Amount of detail to render in the response
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint lists information about one or more videos, including the aspect ratio and URLs to previews.
  - info:
      name: Get details about videos
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/videos/:id
      params:
      - name: id
        value: '30867073'
        type: path
        description: Video ID
      - name: language
        value: es
        type: query
        description: Language for the keywords and categories in the response
      - name: view
        value: ''
        type: query
        description: Amount of detail to render in the response
      auth:
        type: basic
        username: '{{username}}'
        password: '{{password}}'
    docs: This endpoint shows information about a video, including URLs to previews and the sizes that it is available in.
  - info:
      name: List video licenses
      type: http
    http:
      method: GET
      url: https://api.shutterstock.com/v2/videos/licenses
      params:
      - name: video_id
        value: ''
        type: query
        description: Show licenses for the specified video ID
      - name: license
        value: ''
        type: query
        description: Show videos that are available with the specified license, such as `standard` or `enhanced`; prepending
          a `-` sign excludes results from that license
      - name: page
     

# --- truncated at 32 KB (89 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/shutterstock/refs/heads/main/apis.yml