List videos

GET https://api.shutterstock.com/v2/videos
Parameters
Name Type Description
id string[] Video IDs. Range: 1 - 500.
view string Render view. Supports: minimal, full. Default: minimal.
Response Codes
  • 200 OK
  • 400 Bad Request
Required Scopes
  • contributor: (no scope)
  • customer: (no scope)
Example Request
GET https://api.shutterstock.com/v2/videos?id=4535879&id=1934785&view=full
Example Response
{
  "data": [
    {
      "keywords": [
        "applauding",
        "arm",
        "audience",
        "band",
        "celebration",
        "cheerful",
        "cheering",
        "clapping",
        "club",
        "colors",
        "concert",
        "crowd",
        "culture",
        "dancing",
        "dark",
        "drums",
        "entertainment",
        "event",
        "fan",
        "fun",
        "group",
        "guitar",
        "hand",
        "illuminated",
        "laser",
        "lighting",
        "music",
        "night",
        "nightclub",
        "nightlife",
        "party",
        "people",
        "popular",
        "raised",
        "silhouette",
        "singer",
        "songs",
        "sounds",
        "spectator",
        "stage",
        "vibrant",
        "youth"
      ],
      "media_type": "video",
      "id": "1934785",
      "aspect": 1.778,
      "duration": 10,
      "categories": [
        {
          "name": "People",
          "id": "13"
        }
      ],
      "description": "Footage of a crowd partying at a rock concert",
      "contributor": {
        "id": "60881"
      },
      "is_adult": false,
      "aspect_ratio": "16:9",
      "added_date": "2012-02-02",
      "assets": {
        "thumb_webm": {
          "url": "https://ak.picdn.net/shutterstock/videos/1934785/thumb/stock-footage-footage-of-a-crowd-partying-at-a-rock-concert.webm"
        },
        "thumb_mp4": {
          "url": "https://ak.picdn.net/shutterstock/videos/1934785/thumb/stock-footage-footage-of-a-crowd-partying-at-a-rock-concert.mp4"
        },
        "preview_webm": {
          "url": "https://ak.picdn.net/shutterstock/videos/1934785/preview/stock-footage-footage-of-a-crowd-partying-at-a-rock-concert.webm"
        },
        "preview_mp4": {
          "url": "https://ak.picdn.net/shutterstock/videos/1934785/preview/stock-footage-footage-of-a-crowd-partying-at-a-rock-concert.mp4"
        },
        "thumb_jpgs": {
          "urls": [
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/1.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/2.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/3.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/4.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/5.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/6.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/7.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/8.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/9.jpg",
            "https://il9.picdn.net/shutterstock/videos/1934785/thumb/10.jpg"
          ]
        },
        "thumb_jpg": {
          "url": "https://il9.picdn.net/shutterstock/videos/1934785/thumb/1.jpg"
        },
        "preview_jpg": {
          "url": "https://il9.picdn.net/shutterstock/videos/1934785/thumb/1.jpg"
        },
        "hd": {
          "width": 1920,
          "file_size": 66056192,
          "height": 1080,
          "display_name": "Original HD",
          "format": "jpeg",
          "fps": 25,
          "is_licensable": true
        },
        "web": {
          "width": 426,
          "file_size": 1880064,
          "height": 240,
          "display_name": "Low Resolution MPEG",
          "format": "mov",
          "fps": 25,
          "is_licensable": true
        },
        "sd": {
          "width": 852,
          "file_size": 6237184,
          "height": 480,
          "display_name": "Standard Definition MPEG",
          "format": "mov",
          "fps": 25,
          "is_licensable": true
        }
      }
    },
    {
      "keywords": [
        "activity",
        "bass",
        "candid",
        "caucasian appearance",
        "cheerful",
        "dancing",
        "drum kit",
        "drummer",
        "electric guitar",
        "entertainment group",
        "event",
        "excitement",
        "friendship",
        "fun",
        "group",
        "guitar",
        "guitarist",
        "heavy metal",
        "individuality",
        "indoors",
        "instruments",
        "leisure",
        "men",
        "mic",
        "microphone stand",
        "motion",
        "music",
        "music festival",
        "musical equipment",
        "musician",
        "noise",
        "percussion instrument",
        "performance",
        "performer",
        "playing",
        "pop",
        "punk",
        "rehearsal",
        "rock band",
        "rock music",
        "rock stars",
        "sexy",
        "singer",
        "singing",
        "sitting",
        "smoke",
        "stage",
        "standing",
        "trendy",
        "video"
      ],
      "media_type": "video",
      "id": "4535879",
      "aspect": 1.778,
      "duration": 21,
      "categories": [
        {
          "name": "People",
          "id": "13"
        }
      ],
      "description": "Concert rock band performing on stage with singer performer, guitar, drummer.  Music video punk, heavy metal or rock group.  Slow motion instrument playing band of men.",
      "models": [
        {
          "id": "14238071"
        }
      ],
      "contributor": {
        "id": "713359"
      },
      "is_adult": false,
      "has_model_release": true,
      "aspect_ratio": "16:9",
      "added_date": "2013-08-27",
      "assets": {
        "thumb_webm": {
          "url": "https://ak5.picdn.net/shutterstock/videos/4535879/thumb/stock-footage-concert-rock-band-performing-on-stage-with-singer-performer-guitar-drummer-music-video-punk.webm"
        },
        "thumb_mp4": {
          "url": "https://ak5.picdn.net/shutterstock/videos/4535879/thumb/stock-footage-concert-rock-band-performing-on-stage-with-singer-performer-guitar-drummer-music-video-punk.mp4"
        },
        "preview_webm": {
          "url": "https://ak5.picdn.net/shutterstock/videos/4535879/preview/stock-footage-concert-rock-band-performing-on-stage-with-singer-performer-guitar-drummer-music-video-punk.webm"
        },
        "preview_mp4": {
          "url": "https://ak5.picdn.net/shutterstock/videos/4535879/preview/stock-footage-concert-rock-band-performing-on-stage-with-singer-performer-guitar-drummer-music-video-punk.mp4"
        },
        "thumb_jpgs": {
          "urls": [
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/1.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/2.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/3.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/4.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/5.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/6.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/7.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/8.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/9.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/10.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/11.jpg",
            "https://il1.picdn.net/shutterstock/videos/4535879/thumb/12.jpg"
          ]
        },
        "thumb_jpg": {
          "url": "https://il1.picdn.net/shutterstock/videos/4535879/thumb/1.jpg"
        },
        "preview_jpg": {
          "url": "https://il1.picdn.net/shutterstock/videos/4535879/thumb/1.jpg"
        },
        "hd": {
          "width": 1920,
          "file_size": 285578240,
          "height": 1080,
          "display_name": "Original HD",
          "format": "jpeg",
          "fps": 24,
          "is_licensable": true
        },
        "web": {
          "width": 426,
          "file_size": 3651584,
          "height": 240,
          "display_name": "Low Resolution MPEG",
          "format": "mov",
          "fps": 24,
          "is_licensable": true
        },
        "sd": {
          "width": 852,
          "file_size": 12555264,
          "height": 480,
          "display_name": "Standard Definition MPEG",
          "format": "mov",
          "fps": 24,
          "is_licensable": true
        }
      }
    }
  ]
}
Response {
data (Video[], optional),
page (integer, optional),
per_page (integer, optional),
total_count (integer, optional),
message (string, optional),
errors (Error[], optional)
}
Video {
id (string),
description (string, optional),
added_date (string, optional),
media_type (string),
contributor (Contributor),
aspect (number, optional),
aspect_ratio (string, optional),
is_editorial (boolean, optional),
is_adult (boolean, optional),
has_model_release (boolean, optional),
has_property_release (boolean, optional),
duration (number, optional),
categories (Category[], optional),
keywords (string[], optional),
assets (VideoAssets, optional),
models (Model[], optional)
}
Error {
code (string, optional),
data (string, optional),
message (string),
path (string, optional),
items (object[], optional)
}
Contributor {
id (string)
}
Category {
id (string, optional),
name (string, optional)
}
VideoAssets {
web (VideoSizeDetails, optional),
sd (VideoSizeDetails, optional),
hd (VideoSizeDetails, optional),
4k (VideoSizeDetails, optional),
thumb_jpgs (Urls, optional),
thumb_jpg (Url, optional),
preview_jpg (Url, optional),
thumb_webm (Url, optional),
thumb_mp4 (Url, optional),
preview_webm (Url, optional),
preview_mp4 (Url, optional)
}
Model {
id (string)
}
VideoSizeDetails {
height (integer, optional),
width (integer, optional),
file_size (integer, optional),
display_name (string, optional),
fps (number, optional),
format (string, optional),
is_licensable (boolean, optional)
}
Urls {
urls (string[])
}
Url {
url (string)
}