---
title: "List videos"
method: GET
path: "/v2/videos"
tags: ["videos"]
---

# List videos

`GET /v2/videos`

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

## Query parameters

- `id` string[], required
- `view` 'minimal' | 'full'
- `search_id` string

## Response `200`

OK

- object — List of videos
  - `data` object[] — Videos
    - `added_date` string, date — Date this video was added to the Shutterstock library
    - `affiliate_url` string, uri — Affiliate referral link; appears only for registered affiliate partners
    - `aspect` number — Aspect ratio of this video in decimal format, such as 0.6667
    - `aspect_ratio` string — Aspect ratio of the video as a ratio, such as 16:9
    - `assets` object — Video asset information
      - `4k` object — Video asset information
        - `display_name` string — Display name of this video size
        - `file_size` integer — File size (in bytes) of this video size
        - `format` string — Format of this video size
        - `fps` number — Frames per second of this video size
        - `height` integer — Height of this video size
        - `is_licensable` boolean — Whether or not videos can be licensed in this video size
        - `width` integer — Width of this video size
      - `hd` object — Video asset information
        - `display_name` string — Display name of this video size
        - `file_size` integer — File size (in bytes) of this video size
        - `format` string — Format of this video size
        - `fps` number — Frames per second of this video size
        - `height` integer — Height of this video size
        - `is_licensable` boolean — Whether or not videos can be licensed in this video size
        - `width` integer — Width of this video size
      - `preview_jpg` object — URL object
        - `url` string, required — URL that can be used to download the unwatermarked, licensed asset
      - `preview_mp4` object — URL object
        - `url` string, required — URL that can be used to download the unwatermarked, licensed asset
      - `preview_webm` object — URL object
        - `url` string, required — URL that can be used to download the unwatermarked, licensed asset
      - `sd` object — Video asset information
        - `display_name` string — Display name of this video size
        - `file_size` integer — File size (in bytes) of this video size
        - `format` string — Format of this video size
        - `fps` number — Frames per second of this video size
        - `height` integer — Height of this video size
        - `is_licensable` boolean — Whether or not videos can be licensed in this video size
        - `width` integer — Width of this video size
      - `thumb_jpg` object — URL object
        - `url` string, required — URL that can be used to download the unwatermarked, licensed asset
      - `thumb_jpgs` object — List of URLs
        - `urls` string[], required — URLs
      - `thumb_mp4` object — URL object
        - `url` string, required — URL that can be used to download the unwatermarked, licensed asset
      - `thumb_webm` object — URL object
        - `url` string, required — URL that can be used to download the unwatermarked, licensed asset
      - `web` object — Video asset information
        - `display_name` string — Display name of this video size
        - `file_size` integer — File size (in bytes) of this video size
        - `format` string — Format of this video size
        - `fps` number — Frames per second of this video size
        - `height` integer — Height of this video size
        - `is_licensable` boolean — Whether or not videos can be licensed in this video size
        - `width` integer — Width of this video size
    - `categories` object[] — List of categories
      - `id` string — Category ID
      - `name` string — Category name
    - `contributor` object, required — Information about a contributor
      - `id` string, required — ID of the contributor
    - `description` string — Description of this video
    - `duration` number — Duration of this video, in seconds
    - `has_model_release` boolean — Whether or not this video has been released for use by the model appearing in it
    - `has_property_release` boolean — Whether or not this video has received a release to show the landmark or property appearing in it
    - `id` string, required — ID of the video
    - `is_adult` boolean — Whether or not this video contains adult content
    - `is_editorial` boolean — Whether or not this video is editorial content
    - `is_select` boolean — Whether or not this video is part of the select collection
    - `keywords` string[] — Keywords associated with the content of this video
    - `media_type` string, required — Media type of this video, should always be "video"
    - `models` object[] — List of models in this video
      - `id` string, required — ID of the model
    - `releases` object[] — List of all releases of this video
      - `id` string — ID of the model or property release
    - `url` string — Link to video information page; included only for certain accounts
  - `errors` object[] — Error list; appears only if there was an error
    - `code` string — The error code of this error
    - `data` string — Debugging information about the error
    - `items` object[] — A list of items that produced the error
    - `message` string, required — Specific details about this error
    - `path` string — Internal code reference to the source of the error
  - `message` string — Server-generated message, if any
  - `page` integer — Current page that is returned
  - `per_page` integer — Number of results per page
  - `total_count` integer — Total count of all results across all pages

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer.md) · [All operations](https://skmtc.net/shutterstock/apis/shutterstock-api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shutterstock/shutterstock-api-explorer/versions/d2e03e7f655d/schema)