v1

latestOpenAPI 3.0.02026-07-131091452.6 MB

editorial_video

Search editorial video content

This endpoint searches for editorial videos. If you specify more than one search parameter, the API uses an AND condition. For example, if you set the category parameter to "Alone,Performing" and also specify a query parameter, the results include only videos that match the query and are in both the Alone and Performing categories. You can also filter search terms out in the query parameter by prefixing the term with NOT.

get/v2/editorial/videos/search

Query parameters

querystring

One or more search terms separated by spaces

sort'relevant' | 'newest' | 'oldest'

Sort by

categorystring

Show editorial content with each of the specified editorial categories; specify category names in a comma-separated list

countrystring country-code-3 required

Show only editorial video content that is available for distribution in a certain country

supplier_codestring[]

Show only editorial video content from certain suppliers

date_startstring date

Show only editorial video content generated on or after a specific date

date_endstring date

Show only editorial video content generated on or before a specific date

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

Show only editorial video content with specific resolution

fpsnumber

Show only editorial video content generated with specific frames per second

per_pageinteger

Number of results per page

cursorstring

The cursor of the page with which to start fetching results; this cursor is returned from previous requests

Response

messagestring

Optional error message

nextstring

Cursor value that represents the next page of results

pageinteger

Current page of the response

per_pageinteger

Number of results per page

prevstring

Cursor value that represents the previous page of results

search_idstring

Unique identifier for the search request

total_countinteger required

Total count of all results

Example response

{
  "data": [
    {
      "id": "10679854a",
      "title": "Peeps the Goose Has a Blast on a Jet Ski, Prior Lake, Minnesota, USA - 13 Nov 2020",
      "caption": "",
      "description": "Info from Licensor: \"Peeps the Canadian Goose has been raised with our family since a gosling. Peeps has made appearances on our local news channels, TV shows, and local newspapers. He has been trained to fly next to four wheelers, jet ski's, and boats. He has brought joy to many people during the pandemic including those with cancer.\"",
      "byline": "ViralHog/Shutterstock",
      "keywords": [
        "2020",
        "adorable",
        "birds",
        "bizarre",
        "canadian goose",
        "cute",
        "domesticated animals",
        "entertainment",
        "feel good",
        "flew",
        "flies",
        "fly",
        "flying",
        "fun",
        "goose",
        "jet skis",
        "nature",
        "odd",
        "pets",
        "played",
        "playing",
        "plays",
        "prior lake",
        "sports",
        "strange",
        "sweet",
        "usa",
        "viralhog",
        "virals",
        "water sports",
        "weird"
      ],
      "date_taken": "2020-11-13",
      "categories": [],
      "aspect": 1,
      "assets": {
        "preview_mp4": {
          "url": "https://editorial-cdn.shuttercorp.net/wm-preview-mp4/10679854a/M0T7A13aNej2g82bMTI4NjY=/Shutterstock_10679854a.mp4"
        },
        "preview_webm": {
          "url": "https://editorial-cdn.shuttercorp.net/wm-preview-webm/10679854a/M4T6A63fN2j5g929MTI4NjY=/Shutterstock_10679854a.webm"
        },
        "thumb_jpg": {
          "url": "https://editorial-cdn.shuttercorp.net/thumb-1/10679854a/M5TcAf30Ncjcge2eMTI4NjY=/Shutterstock_10679854a.jpg"
        },
        "original": {
          "height": 1080,
          "width": 1080,
          "fps": 30,
          "format": "avc1",
          "file_size": 82233387,
          "display_name": "HD",
          "is_licensable": true
        }
      }
    }
  ],
  "per_page": 1,
  "total_count": 331,
  "search_id": "zhmz9zLmpQehdTPvg8cacQ",
  "next": "eyJ2IjoyLCJzIjoyMCwicCI6WzBdfQ==",
  "prev": ""
}