Search videos

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
Example Response
  "page": 1,
  "per_page": 1,
  "total_count": 6466,
  "search_id": "nBOOUiEQOhwLFHuV2N3gyQ",
  "data": [
      "keywords": [
        "caucasian appearance",
        "drum kit",
        "electric guitar",
        "entertainment group",
        "heavy metal",
        "microphone stand",
        "music festival",
        "musical equipment",
        "percussion instrument",
        "rock band",
        "rock music",
        "rock stars",
      "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": ""
        "thumb_mp4": {
          "url": ""
        "preview_webm": {
          "url": ""
        "preview_mp4": {
          "url": ""
        "thumb_jpgs": {
          "urls": [
        "thumb_jpg": {
          "url": ""
        "preview_jpg": {
          "url": ""
        "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)