videos

List similar videos

Changed on Oct 14, 2026

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

get/v2/videos/{id}/similar

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/videos/:id/similar/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring asset-id required

The ID of a video for which similar videos should be returned

Query parameters

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 path request parameter id, the format changed from no format to asset-id
- info
  api operation id getSimilarVideos removed and replaced with findSimilarVideos
- 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