---
title: "Search editorial video content"
method: GET
path: "/v2/editorial/videos/search"
tags: ["editorial_video"]
---

# Search editorial video content

`GET /v2/editorial/videos/search`

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.

## Query parameters

- `query` string
- `sort` 'relevant' | 'newest' | 'oldest'
- `category` string
- `country` string, country-code-3, required
- `supplier_code` string[]
- `date_start` string, date
- `date_end` string, date
- `resolution` '4k' | 'high_definition' | 'standard_definition'
- `fps` number
- `per_page` integer
- `cursor` string

## Response `200`

OK

- object — Editorial search results
  - `data` object[], required — Editorial items
    - `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
  - `message` string — Optional error message
  - `next` string — Cursor value that represents the next page of results
  - `page` integer — Current page of the response
  - `per_page` integer — Number of results per page
  - `prev` string — Cursor value that represents the previous page of results
  - `search_id` string — Unique identifier for the search request
  - `total_count` integer, required — Total count of all results

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `406` — Not Acceptable

---

[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)