computer_vision

List similar videos

Changed on Oct 14, 2026

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

get/v2/cv/similar/videos

Request

Base URL
https://api.shutterstock.com
Auth
- HTTP basic
- or OAuth 2
  Authorization codehttps://accounts.shutterstock.com/oauth/authorize
  Token URLhttps://api.shutterstock.com/v2/oauth/access_token
TypeScript
https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/docs/v2/cv/similar/videos/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

asset_idstring required

The asset ID or upload ID to find similar videos for

licensestring[]

Show only videos with the specified license

safeboolean

Enable or disable safe search

language'ar' | 'bg' | 'bn' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'es' | 'fi' | 'fr' | 'gu' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'it' | 'ja' | 'kn' | 'ko' | 'ml' | 'mr' | 'nb' | 'nl' | 'or' | 'pl' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sv' | 'ta' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'vi' | 'zh' | 'zh-Hant'

Language code

Example:cs

Language for the keywords and categories in the response

pageinteger

Page number

per_pageinteger

Number of results per page

view'minimal' | 'full'

Amount of detail to render in the response

Response

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

total_countinteger required

Total count of all results across all pages

search_idstring required

Unique identifier for the search request

Example response

{
  "data": [
    {
      "id": "1033184651",
      "aspect": 1.778,
      "aspect_ratio": "16:9",
      "assets": {
        "thumb_webm": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.webm"
        },
        "thumb_mp4": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.mp4"
        },
        "preview_webm": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/preview/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.webm"
        },
        "preview_mp4": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/preview/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.mp4"
        },
        "thumb_jpg": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/12.jpg"
        },
        "preview_jpg": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/12.jpg"
        }
      },
      "contributor": {
        "id": "4411978"
      },
      "description": "Camera follows hipster millennial young woman in orange jacket running up on top of mountain summit at sunset, jumps on top of rocks, raises arms into air, happy and drunk on life, youth and happiness",
      "duration": 14.081,
      "has_model_release": true,
      "media_type": "video"
    }
  ],
  "page": 1,
  "per_page": 5,
  "total_count": 123,
  "search_id": "749090bb-2967-4a20-b22e-c800dc845e10"
}

Changes

Oct 14, 2026b43cab3aaaaa Revision changes
- info
  added the optional property // to the response with the status
- info
  added the optional property /// to the response with the status
Jul 13, 2026d2e03e7f655d Revision changes
- breaking
  for the query request parameter license, default value was changed from commercial to commercial
- breaking
  for the query request parameter per_page, the max was decreased from 500.00 to 200.00
- info
  added the new enum value ar to the query request parameter language
- info
  added the new enum value bg to the query request parameter language
- info
  added the new enum value bn to the query request parameter language
- info
  added the new enum value gu to the query request parameter language
- info
  added the new enum value he to the query request parameter language
- info
  added the new enum value hi to the query request parameter language
- info
  added the new enum value hr to the query request parameter language
- info
  added the new enum value kn to the query request parameter language
- info
  added the new enum value ml to the query request parameter language
- info
  added the new enum value mr to the query request parameter language
- info
  added the new enum value or to the query request parameter language
- info
  added the new enum value sk to the query request parameter language
- info
  added the new enum value sl to the query request parameter language
- info
  added the new enum value ta to the query request parameter language
- info
  added the new enum value te to the query request parameter language
- info
  added the new enum value uk to the query request parameter language
- info
  added the new enum value ur to the query request parameter language
- info
  added the optional property // to the response with the status
- info
  added the optional property // to the response with the status

Operation history