SHshutterstock
videos

Search for videos

Changed on

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

Request

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

duration_frominteger

Show videos with the specified duration or longer in seconds

duration_tointeger

Show videos with the specified duration or shorter in seconds

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

exact_matchboolean

Require exact keyword matching and disable enhanced search behavior

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

Show videos with the specified resolution

safeboolean

Enable or disable safe search

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

Sort by one of these categories

view'minimal' | 'full'

Amount of detail to render in the response

librarystring[]

Search within different Shutterstock owned libraries. Defaults to shutterstock.

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"
}

Changes

  • b43cab3aaaaaRevision changes
    • info

      added the new optional query request parameter exact_match

    • info

      added the new optional query request parameter library

    • info

      added the new enum value oldest to the query request parameter sort

    • info

      deleted the query request parameter duration with deprecation

    • info

      deleted the query request parameter fps with deprecation

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status

  • d2e03e7f655dRevision changes
    • info

      added the new optional query request parameter orientation

    • info

      added the new enum value ar to the query request parameter language

    • info

      added the new enum value bg to the query request parameter language

    • info

      added the new enum value bn to the query request parameter language

    • info

      added the new enum value gu to the query request parameter language

    • info

      added the new enum value he to the query request parameter language

    • info

      added the new enum value hi to the query request parameter language

    • info

      added the new enum value hr to the query request parameter language

    • info

      added the new enum value kn to the query request parameter language

    • info

      added the new enum value ml to the query request parameter language

    • info

      added the new enum value mr to the query request parameter language

    • info

      added the new enum value or to the query request parameter language

    • info

      added the new enum value sk to the query request parameter language

    • info

      added the new enum value sl to the query request parameter language

    • info

      added the new enum value ta to the query request parameter language

    • info

      added the new enum value te to the query request parameter language

    • info

      added the new enum value uk to the query request parameter language

    • info

      added the new enum value ur to the query request parameter language

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status