videos

Get details about videos

Changed on Oct 14, 2026

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

get/v2/videos/{id}

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

Path parameters

idstring asset-id required

Video ID

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

view'minimal' | 'full'

Amount of detail to render in the response

search_idstring

The ID of the search that is related to this request

Response

added_datestring date

Date this video was added to the Shutterstock library

affiliate_urlstring uri

Affiliate referral link; appears only for registered affiliate partners

aspectnumber

Aspect ratio of this video in decimal format, such as 0.6667

aspect_ratiostring

Aspect ratio of the video as a ratio, such as 16:9

descriptionstring

Description of this video

durationnumber

Duration of this video, in seconds

has_model_releaseboolean

Whether or not this video has been released for use by the model appearing in it

has_property_releaseboolean

Whether or not this video has received a release to show the landmark or property appearing in it

idstring required

ID of the video

is_adultboolean

Whether or not this video contains adult content

is_editorialboolean

Whether or not this video is editorial content

is_selectboolean

Whether or not this video is part of the select collection

asset_collection'' | 'Essentials' | 'Select'

Asset collection for this video

keywordsstring[]

Keywords associated with the content of this video

media_typestring required

Media type of this video, should always be "video"

urlstring

Link to video information page; included only for certain accounts

Example response

{
  "id": "1033184651",
  "added_date": "2019-07-13",
  "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_jpgs": {
      "urls": [
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/1.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/2.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/3.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/4.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/5.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/6.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/7.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/8.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/9.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/10.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/11.jpg",
        "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/12.jpg"
      ]
    },
    "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"
    },
    "sd": {
      "height": 480,
      "width": 852,
      "fps": 29.97,
      "format": "mov",
      "file_size": 4577280,
      "display_name": "Standard Definition MPEG",
      "is_licensable": true
    },
    "web": {
      "height": 240,
      "width": 426,
      "fps": 29.97,
      "format": "mov",
      "file_size": 1291264,
      "display_name": "Low Resolution MPEG",
      "is_licensable": true
    },
    "hd": {
      "height": 1080,
      "width": 1920,
      "fps": 29.97,
      "format": "avc1",
      "file_size": 110359552,
      "display_name": "Original HD",
      "is_licensable": true
    }
  },
  "categories": [
    {
      "name": "Nature",
      "id": "12"
    },
    {
      "name": "People",
      "id": "13"
    }
  ],
  "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,
  "has_property_release": false,
  "is_adult": false,
  "is_editorial": false,
  "keywords": [
    "active",
    "activity",
    "adventure",
    "arms",
    "backpacker",
    "carefree",
    "celebrating",
    "cliff",
    "climate",
    "cloud",
    "discovery",
    "escape",
    "explore",
    "extreme",
    "free",
    "freedom",
    "girl",
    "happy",
    "high",
    "hiker",
    "hiking",
    "hill",
    "independent",
    "inspiration",
    "landscape",
    "leisure",
    "lifestyle",
    "mountain",
    "mountains",
    "nature",
    "outdoor",
    "peak",
    "person",
    "rock",
    "scenic",
    "sky",
    "sport",
    "success",
    "summer",
    "summit",
    "sun",
    "sunset",
    "top",
    "tourism",
    "travel",
    "trekking",
    "vacation",
    "view",
    "winning",
    "woman"
  ],
  "media_type": "video",
  "models": [
    {
      "id": "33233810"
    },
    {
      "id": "25487168"
    }
  ]
}

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
  added the new optional query request parameter search_id
- 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