SHshutterstock
videos

List videos

Changed on

This endpoint lists information about one or more videos, including the aspect ratio and URLs to previews.

get/v2/videos

Request

Query parameters

idstring[] required

One or more video IDs

view'minimal' | 'full'

Amount of detail to render in the response

search_idstring

The ID of the search that is related to this request

Response

OK

messagestring

Server-generated message, if any

pageinteger

Current page that is returned

per_pageinteger

Number of results per page

total_countinteger

Total count of all results across all pages

Example response

{
  "data": [
    {
      "id": "1033184651",
      "added_date": "2019-07-13",
      "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_jpgs": {
          "urls": [
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/1.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/2.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/3.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/4.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/5.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/6.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/7.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/8.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/9.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/10.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/11.jpg",
            "https://ak.picdn.net/shutterstock/videos/1033184651/thumb/12.jpg"
          ]
        },
        "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"
        },
        "sd": {
          "height": 480,
          "width": 852,
          "fps": 29.97,
          "format": "mov",
          "file_size": 4577280,
          "display_name": "Standard Definition MPEG",
          "is_licensable": true
        },
        "web": {
          "height": 240,
          "width": 426,
          "fps": 29.97,
          "format": "mov",
          "file_size": 1291264,
          "display_name": "Low Resolution MPEG",
          "is_licensable": true
        },
        "hd": {
          "height": 1080,
          "width": 1920,
          "fps": 29.97,
          "format": "avc1",
          "file_size": 110359552,
          "display_name": "Original HD",
          "is_licensable": true
        }
      },
      "categories": [
        {
          "name": "Nature",
          "id": "12"
        },
        {
          "name": "People",
          "id": "13"
        }
      ],
      "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,
      "has_property_release": false,
      "is_adult": false,
      "is_editorial": false,
      "keywords": [
        "active",
        "activity",
        "adventure",
        "arms",
        "backpacker",
        "carefree",
        "celebrating",
        "cliff",
        "climate",
        "cloud",
        "discovery",
        "escape",
        "explore",
        "extreme",
        "free",
        "freedom",
        "girl",
        "happy",
        "high",
        "hiker",
        "hiking",
        "hill",
        "independent",
        "inspiration",
        "landscape",
        "leisure",
        "lifestyle",
        "mountain",
        "mountains",
        "nature",
        "outdoor",
        "peak",
        "person",
        "rock",
        "scenic",
        "sky",
        "sport",
        "success",
        "summer",
        "summit",
        "sun",
        "sunset",
        "top",
        "tourism",
        "travel",
        "trekking",
        "vacation",
        "view",
        "winning",
        "woman"
      ],
      "media_type": "video",
      "models": [
        {
          "id": "33233810"
        },
        {
          "id": "25487168"
        }
      ]
    }
  ],
  "page": 1,
  "per_page": 5,
  "total_count": 25
}

Changes

  • b43cab3aaaaaRevision changes
    • info

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

    • info

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

    • info

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

  • d2e03e7f655dRevision changes
    • breaking

      for the query request parameter id, the minItems was increased from 0 to 1

    • breaking

      for the query request parameter id, the format of property items/ was specialized from no format to asset-id

    • info

      added the new optional query request parameter search_id

    • info

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

    • info

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