---
title: "List editorial videos details by ID list"
method: GET
path: "/v2/editorial/videos"
tags: ["editorial_video"]
---

# List editorial videos details by ID list

`GET /v2/editorial/videos`

This endpoint lists the details of editorial videos by ID list.

## Query parameters

- `id` string[], required
- `country` string, country-code-3, required
- `search_id` string

## Response `200`

OK

- object — List of editorial videos
  - `data` object[]
    - `aspect` number
    - `assets` object — Asset information, including size and thumbnail URLs
      - `original` 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_mp4` object — Video preview information
        - `url` string, required — Direct URL to the image
      - `preview_webm` object — Video preview information
        - `url` string, required — Direct URL to the image
      - `thumb_jpg` object — Video preview information
        - `url` string, required — Direct URL to the image
    - `byline` string
    - `caption` string
    - `categories` object[] — List of categories
      - `name` string
    - `date_taken` string, date
    - `description` string
    - `id` string, required
    - `keywords` string[]
    - `title` string
  - `search_id` string
  - `total_count` integer

## 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/revisions/d2e03e7f655d/schema)