--- title: "Search for videos" method: GET path: "/v2/videos/search" tags: ["videos"] --- # Search for videos `GET /v2/videos/search` This endpoint searches for videos. If you specify more than one search parameter, the API uses an AND condition. Array parameters can be specified multiple times; in this case, the API uses an AND or an OR condition with those values, depending on the parameter. You can also filter search terms out in the `query` parameter by prefixing the term with NOT. ## Query parameters - `added_date` string, date - `added_date_start` string, date - `added_date_end` string, date - `aspect_ratio` '4_3' | '16_9' | 'nonstandard' - `category` string - `contributor` string[] - `contributor_country` string[] - `duration` integer - `duration_from` integer - `duration_to` integer - `fps` number - `fps_from` number - `fps_to` number - `keyword_safe_search` boolean - `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 - `license` string[] - `model` string[] - `orientation` 'vertical' | 'horizontal' - `page` integer - `per_page` integer - `people_age` 'infants' | 'children' | 'teenagers' | '20s' | '30s' | '40s' | '50s' | '60s' | 'older' - `people_ethnicity` string[] - `people_gender` 'male' | 'female' | 'both' - `people_number` integer - `people_model_released` boolean - `query` string - `resolution` '4k' | 'standard_definition' | 'high_definition' - `safe` boolean - `sort` 'newest' | 'popular' | 'relevance' | 'random' - `view` 'minimal' | 'full' ## Response `200` OK - object — Video search results - `data` object[], required — List of videos - `added_date` string, date — Date this video was added to the Shutterstock library - `affiliate_url` string, uri — Affiliate referral link; appears only for registered affiliate partners - `aspect` number — Aspect ratio of this video in decimal format, such as 0.6667 - `aspect_ratio` string — Aspect ratio of the video as a ratio, such as 16:9 - `assets` object — Video asset information - `4k` object — Video asset information - `display_name` string — Display name of this video size - `file_size` integer — File size (in bytes) of this video size - `format` string — Format of this video size - `fps` number — Frames per second of this video size - `height` integer — Height of this video size - `is_licensable` boolean — Whether or not videos can be licensed in this video size - `width` integer — Width of this video size - `hd` object — Video asset information - `display_name` string — Display name of this video size - `file_size` integer — File size (in bytes) of this video size - `format` string — Format of this video size - `fps` number — Frames per second of this video size - `height` integer — Height of this video size - `is_licensable` boolean — Whether or not videos can be licensed in this video size - `width` integer — Width of this video size - `preview_jpg` object — URL object - `url` string, required — URL that can be used to download the unwatermarked, licensed asset - `preview_mp4` object — URL object - `url` string, required — URL that can be used to download the unwatermarked, licensed asset - `preview_webm` object — URL object - `url` string, required — URL that can be used to download the unwatermarked, licensed asset - `sd` object — Video asset information - `display_name` string — Display name of this video size - `file_size` integer — File size (in bytes) of this video size - `format` string — Format of this video size - `fps` number — Frames per second of this video size - `height` integer — Height of this video size - `is_licensable` boolean — Whether or not videos can be licensed in this video size - `width` integer — Width of this video size - `thumb_jpg` object — URL object - `url` string, required — URL that can be used to download the unwatermarked, licensed asset - `thumb_jpgs` object — List of URLs - `urls` string[], required — URLs - `thumb_mp4` object — URL object - `url` string, required — URL that can be used to download the unwatermarked, licensed asset - `thumb_webm` object — URL object - `url` string, required — URL that can be used to download the unwatermarked, licensed asset - `web` object — Video asset information - `display_name` string — Display name of this video size - `file_size` integer — File size (in bytes) of this video size - `format` string — Format of this video size - `fps` number — Frames per second of this video size - `height` integer — Height of this video size - `is_licensable` boolean — Whether or not videos can be licensed in this video size - `width` integer — Width of this video size - `categories` object[] — List of categories - `id` string — Category ID - `name` string — Category name - `contributor` object, required — Information about a contributor - `id` string, required — ID of the contributor - `description` string — Description of this video - `duration` number — Duration of this video, in seconds - `has_model_release` boolean — Whether or not this video has been released for use by the model appearing in it - `has_property_release` boolean — Whether or not this video has received a release to show the landmark or property appearing in it - `id` string, required — ID of the video - `is_adult` boolean — Whether or not this video contains adult content - `is_editorial` boolean — Whether or not this video is editorial content - `is_select` boolean — Whether or not this video is part of the select collection - `keywords` string[] — Keywords associated with the content of this video - `media_type` string, required — Media type of this video, should always be "video" - `models` object[] — List of models in this video - `id` string, required — ID of the model - `releases` object[] — List of all releases of this video - `id` string — ID of the model or property release - `url` string — Link to video information page; included only for certain accounts - `message` string — Server-generated message, if any - `page` integer — Current page that is returned - `per_page` integer — Number of results per page - `total_count` integer, required — Total count of all results across all pages - `search_id` string, required — Unique identifier for the search request ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — Not found --- [API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/versions/d2e03e7f655d/schema)