Search for videos

GET {{baseUrl}}/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.

Request Params

Key	Datatype	Description
`added_date`	string	Show videos added on the specified date
`added_date_start`	string	Show videos added on or after the specified date
`added_date_end`	string	Show videos added before the specified date
`aspect_ratio`	string	Show videos with the specified aspect ratio
`category`	string	Show videos with the specified Shutterstock-defined category; specify a category name or ID
`contributor`	string	Show videos with the specified artist names or IDs
`contributor_country`	string	Show videos from contributors in one or more specified countries
`duration`	string	(Deprecated; use duration_from and duration_to instead) Show videos with the specified duration in seconds
`duration_from`	string	Show videos with the specified duration or longer in seconds
`duration_to`	string	Show videos with the specified duration or shorter in seconds
`fps`	string	(Deprecated; use fps_from and fps_to instead) Show videos with the specified frames per second
`fps_from`	string	Show videos with the specified frames per second or more
`fps_to`	string	Show videos with the specified frames per second or fewer
`keyword_safe_search`	boolean	Hide results with potentially unsafe keywords
`language`	string	Set query and result language (uses Accept-Language header if not set)
`license`	string	Show only videos with the specified license or licenses
`model`	string	Show videos with each of the specified models
`page`	number	Page number
`per_page`	number	Number of results per page
`people_age`	string	Show videos that feature people of the specified age range
`people_ethnicity`	string	Show videos with people of the specified ethnicities
`people_gender`	string	Show videos with people with the specified gender
`people_number`	string	Show videos with the specified number of people
`people_model_released`	string	Show only videos of people with a signed model release
`query`	string	One or more search terms separated by spaces; you can use NOT to filter out videos that match a term
`resolution`	string	Show videos with the specified resolution
`safe`	boolean	Enable or disable safe search
`sort`	string	Sort by one of these categories
`view`	string	Amount of detail to render in the response

HEADERS

Key	Datatype	Required	Description
`User-Agent`	string

RESPONSES

status: OK

{&quot;page&quot;:1,&quot;per_page&quot;:1,&quot;total_count&quot;:9488747,&quot;search_id&quot;:&quot;4LseqIiX-nIW7_vx8-jhWQ&quot;,&quot;data&quot;:[{&quot;media_type&quot;:&quot;video&quot;,&quot;id&quot;:&quot;33248488&quot;,&quot;description&quot;:&quot;The Concept of: Digitalization of Information Flow Moving Through Rack Servers in Data Center. Shot on RED EPIC-W 8K Helium Cinema Camera.&quot;,&quot;aspect&quot;:1.778,&quot;duration&quot;:19,&quot;has_model_release&quot;:false,&quot;contributor&quot;:{&quot;id&quot;:&quot;178456&quot;},&quot;aspect_ratio&quot;:&quot;16:9&quot;,&quot;assets&quot;:{&quot;thumb_webm&quot;:{&quot;url&quot;:&quot;https://ak8.picdn.net/shutterstock/videos/33248488/thumb/stock-footage-the-concept-of-digitalization-of-information-flow-moving-through-rack-servers-in-data-center-shot.webm&quot;},&quot;thumb_mp4&quot;:{&quot;url&quot;:&quot;https://ak8.picdn.net/shutterstock/videos/33248488/thumb/stock-footage-the-concept-of-digitalization-of-information-flow-moving-through-rack-servers-in-data-center-shot.mp4&quot;},&quot;preview_webm&quot;:{&quot;url&quot;:&quot;https://ak8.picdn.net/shutterstock/videos/33248488/preview/stock-footage-the-concept-of-digitalization-of-information-flow-moving-through-rack-servers-in-data-center-shot.webm&quot;},&quot;preview_mp4&quot;:{&quot;url&quot;:&quot;https://ak8.picdn.net/shutterstock/videos/33248488/preview/stock-footage-the-concept-of-digitalization-of-information-flow-moving-through-rack-servers-in-data-center-shot.mp4&quot;},&quot;thumb_jpg&quot;:{&quot;url&quot;:&quot;https://ak8.picdn.net/shutterstock/videos/33248488/thumb/12.jpg&quot;},&quot;preview_jpg&quot;:{&quot;url&quot;:&quot;https://ak8.picdn.net/shutterstock/videos/33248488/thumb/12.jpg&quot;}},&quot;url&quot;:&quot;https://www.shutterstock.com/video/clip-33248488&quot;}]}