Search videos

GET https://api.shutterstock.com/v2/videos/search
Parameters
Name Type Description
added_date string Restrict to videos added on a given date.
added_date_start string Restrict to videos added on or after a given date.
added_date_end string Restrict to videos added before a given date.
aspect_ratio string Restrict by aspect ratio. Supports: 4_3, 16_9, nonstandard.
category string Restrict by category name or ID.
contributor string[] Restrict results by artist name or ID. Range: 1 - 100.
duration integer Restrict by duration (sec).
duration_from integer Restrict results to a certain duration or longer (sec).
duration_to integer Restrict results to a certain duration or shorter (sec).
language string Set query and result language (uses Accept-Language header if not set). Supports: cs, da, de, en, es, fi, fr, hu, it, ja, ko, nb, nl, pl, pt, ru, sv, th, tr, zh.
license string[] Restrict to videos with a certain license. Supports: commercial, editorial. Default: commercial.
model string[] Restrict video results by model. Range: 1 - 100.
page integer Page number. Minimum: 1. Default: 1.
per_page integer Number of results per page. Range: 0 - 500. Default: 20.
people_age string Restrict results to videos that feature people of a specified age range. Supports: infants, children, teenagers, 20s, 30s, 40s, 50s, 60s, older.
people_ethnicity string Restrict results by ethnicity. Supports: african, african_american, black, brazilian, chinese, caucasian, east_asian, hispanic, japanese, middle_eastern, native_american, pacific_islander, south_asian, southeast_asian, other.
people_gender string Restrict results by gender. Supports: male, female, both.
people_number integer Restrict results to videos with a specified number of people. Range: 0 - 4.
people_model_released boolean Restrict to videos of people with a signed model release.
query string Search term.
resolution string Restrict results to a certain resolution. Supports: 4k, standard_definition, high_definition.
safe boolean Enable or disable safe search. Default: true.
sort string Sort order. Supports: newest, popular, relevance, random. Default: popular.
view string Render view. Supports: minimal, full. Default: minimal.
Response Codes
  • 200 OK
  • 400 Bad Request
  • 404 Not found
Required Scopes
  • contributor: (no scope)
  • customer: (no scope)
Example Request
GET https://api.shutterstock.com/v2/videos/search?per_page=1&query=drum&view=full
Example Response
{
  "page": 1,
  "per_page": 1,
  "total_count": 6466,
  "search_id": "nBOOUiEQOhwLFHuV2N3gyQ",
  "data": [
    {
      "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[]),
page (integer, optional),
per_page (integer, optional),
total_count (integer),
search_id (string),
message (string, 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)
}
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)
}