---
title: "List similar videos"
method: GET
path: "/v2/cv/similar/videos"
tags: ["computer_vision"]
---

# List similar videos

`GET /v2/cv/similar/videos`

## Request

- Base URL: `https://api.shutterstock.com`
- URL: `https://api.shutterstock.com/v2/cv/similar/videos`
- Auth: one of:
  - HTTP basic
  - OAuth 2
    - Authorization code: `https://accounts.shutterstock.com/oauth/authorize`
    - Token URL: `https://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)

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

## Query parameters

- `asset_id` string, required
- `license` string[]
- `safe` boolean
- `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
- `page` integer
- `per_page` integer
- `view` 'minimal' | 'full'

## Response `200`

OK

- object: Video search results
  - `data` object[], required: List of videos
    - `added_date` string, date: Date this video was added to the Shutterstock library
    - `affiliate_url` string, uri: Affiliate referral link; appears only for registered affiliate partners
    - `aspect` number: Aspect ratio of this video in decimal format, such as 0.6667
    - `aspect_ratio` string: Aspect ratio of the video as a ratio, such as 16:9
    - `assets` object: Video asset information
      - `4k` object: Video asset information
        - `display_name` string: Display name of this video size
        - `file_size` integer: File size (in bytes) of this video size
        - `format` string: Format of this video size
        - `fps` number: Frames per second of this video size
        - `height` integer: Height of this video size
        - `is_licensable` boolean: Whether or not videos can be licensed in this video size
        - `width` integer: Width of this video size
      - `hd` object: Video asset information
        - `display_name` string: Display name of this video size
        - `file_size` integer: File size (in bytes) of this video size
        - `format` string: Format of this video size
        - `fps` number: Frames per second of this video size
        - `height` integer: Height of this video size
        - `is_licensable` boolean: Whether or not videos can be licensed in this video size
        - `width` integer: Width of this video size
      - `preview_jpg` object: URL object
        - `url` string, required: URL that can be used to download the unwatermarked, licensed asset
      - `preview_mp4` object: URL object
        - `url` string, required: URL that can be used to download the unwatermarked, licensed asset
      - `preview_webm` object: URL object
        - `url` string, required: URL that can be used to download the unwatermarked, licensed asset
      - `sd` object: Video asset information
        - `display_name` string: Display name of this video size
        - `file_size` integer: File size (in bytes) of this video size
        - `format` string: Format of this video size
        - `fps` number: Frames per second of this video size
        - `height` integer: Height of this video size
        - `is_licensable` boolean: Whether or not videos can be licensed in this video size
        - `width` integer: Width of this video size
      - `thumb_jpg` object: URL object
        - `url` string, required: URL that can be used to download the unwatermarked, licensed asset
      - `thumb_jpgs` object: List of URLs
        - `urls` string[], required: URLs
      - `thumb_mp4` object: URL object
        - `url` string, required: URL that can be used to download the unwatermarked, licensed asset
      - `thumb_webm` object: URL object
        - `url` string, required: URL that can be used to download the unwatermarked, licensed asset
      - `web` object: Video asset information
        - `display_name` string: Display name of this video size
        - `file_size` integer: File size (in bytes) of this video size
        - `format` string: Format of this video size
        - `fps` number: Frames per second of this video size
        - `height` integer: Height of this video size
        - `is_licensable` boolean: Whether or not videos can be licensed in this video size
        - `width` integer: Width of this video size
    - `categories` object[]: List of categories
      - `id` string: Category ID
      - `name` string: Category name
    - `contributor` object, required: Information about a contributor
      - `id` string, required: ID of the contributor
      - `name` string: Display name of the contributor
    - `description` string: Description of this video
    - `duration` number: Duration of this video, in seconds
    - `has_model_release` boolean: Whether or not this video has been released for use by the model appearing in it
    - `has_property_release` boolean: Whether or not this video has received a release to show the landmark or property appearing in it
    - `id` string, required: ID of the video
    - `is_adult` boolean: Whether or not this video contains adult content
    - `is_editorial` boolean: Whether or not this video is editorial content
    - `is_select` boolean: Whether or not this video is part of the select collection
    - `asset_collection` '' | 'Essentials' | 'Select': Asset collection for this video
    - `keywords` string[]: Keywords associated with the content of this video
    - `media_type` string, required: Media type of this video, should always be "video"
    - `models` object[]: List of models in this video
      - `id` string, required: ID of the model
    - `releases` object[]: List of all releases of this video
      - `id` string: ID of the model or property release
    - `url` string: Link to video information page; included only for certain accounts
  - `message` string: Server-generated message, if any
  - `page` integer: Current page that is returned
  - `per_page` integer: Number of results per page
  - `total_count` integer, required: Total count of all results across all pages
  - `search_id` string, required: Unique identifier for the search request

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-14** `b43cab3aaaaa`: 2 info
  - added the optional property `data/items/asset_collection` to the response with the `200` status
  - added the optional property `data/items/contributor/name` to the response with the `200` status
- **2026-07-13** `d2e03e7f655d`: 2 breaking, 19 info
  - for the `query` request parameter `license`, default value was changed from `commercial` to `commercial`
  - for the `query` request parameter `per_page`, the max was decreased from `500.00` to `200.00`
  - added the new enum value `ar` to the `query` request parameter `language`
  - added the new enum value `bg` to the `query` request parameter `language`
  - …17 more

[Operation history](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/changes/v2/cv/similar/videos/get.md)

---

[API](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer.md) - [All operations](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/shutterstock/apis/shutterstock-api-explorer/revisions/b43cab3aaaaa?raw)