Sign in

v1

latestOpenAPI 3.0.02026-07-131091452.6 MB
videos

Search for videos

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.

get/v2/videos/search

Query parameters

added_datestring date

Show videos added on the specified date

added_date_startstring date

Show videos added on or after the specified date

added_date_endstring date

Show videos added before the specified date

aspect_ratio'4_3' | '16_9' | 'nonstandard'

Show videos with the specified aspect ratio

categorystring

Show videos with the specified Shutterstock-defined category; specify a category name or ID

contributorstring[]

Show videos with the specified artist names or IDs

contributor_countrystring[]

Show videos from contributors in one or more specified countries

durationinteger

(Deprecated; use duration_from and duration_to instead) Show videos with the specified duration in seconds

duration_frominteger

Show videos with the specified duration or longer in seconds

duration_tointeger

Show videos with the specified duration or shorter in seconds

fpsnumber

(Deprecated; use fps_from and fps_to instead) Show videos with the specified frames per second

fps_fromnumber

Show videos with the specified frames per second or more

fps_tonumber

Show videos with the specified frames per second or fewer

keyword_safe_searchboolean

Hide results with potentially unsafe keywords

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

Example:cs

Set query and result language (uses Accept-Language header if not set)

licensestring[]

Show only videos with the specified license or licenses

modelstring[]

Show videos with each of the specified models

orientation'vertical' | 'horizontal'

Search for videos in a specific orientation

pageinteger

Page number

per_pageinteger

Number of results per page

people_age'infants' | 'children' | 'teenagers' | '20s' | '30s' | '40s' | '50s' | '60s' | 'older'

Show videos that feature people of the specified age range

people_ethnicitystring[]

Show videos with people of the specified ethnicities

people_gender'male' | 'female' | 'both'

Show videos with people with the specified gender

people_numberinteger

Show videos with the specified number of people

people_model_releasedboolean

Show only videos of people with a signed model release

querystring

One or more search terms separated by spaces; you can use NOT to filter out videos that match a term

resolution'4k' | 'standard_definition' | 'high_definition'

Show videos with the specified resolution

safeboolean

Enable or disable safe search

sort'newest' | 'popular' | 'relevance' | 'random'

Sort by one of these categories

view'minimal' | 'full'

Amount of detail to render in the response

Response

OK

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

total_countinteger required

Total count of all results across all pages

search_idstring required

Unique identifier for the search request

Example response

{
  "data": [
    {
      "id": "1033184651",
      "aspect": 1.778,
      "aspect_ratio": "16:9",
      "assets": {
        "thumb_webm": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.webm"
        },
        "thumb_mp4": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.mp4"
        },
        "preview_webm": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/preview/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.webm"
        },
        "preview_mp4": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/preview/stock-footage-camera-follows-hipster-millennial-young-woman-in-orange-jacket-running-up-on-top-of-mountain-summit.mp4"
        },
        "thumb_jpg": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/12.jpg"
        },
        "preview_jpg": {
          "url": "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/12.jpg"
        }
      },
      "contributor": {
        "id": "4411978"
      },
      "description": "Camera follows hipster millennial young woman in orange jacket running up on top of mountain summit at sunset, jumps on top of rocks, raises arms into air, happy and drunk on life, youth and happiness",
      "duration": 14.081,
      "has_model_release": true,
      "media_type": "video"
    }
  ],
  "page": 1,
  "per_page": 5,
  "total_count": 123,
  "search_id": "749090bb-2967-4a20-b22e-c800dc845e10"
}