Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
videos

Get details about videos

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

get/v2/videos/{id}

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

OK

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

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"
    }
  ]
}