---
title: "Search for videos"
method: GET
path: "/videos"
tags: ["Videos\\Essentials"]
---

# Search for videos

`GET /videos`

This method returns all the videos that match custom search criteria.

## Query parameters

- `direction` 'asc' | 'desc'
- `filter` 'CC' | 'CC-BY' | 'CC-BY-NC' | 'CC-BY-NC-ND' | 'CC-BY-NC-SA' | 'CC-BY-ND' | 'CC-BY-SA' | 'CC0' | 'categories' | 'duration' | 'in-progress' | 'minimum_likes' | 'trending' | 'upload_date'
- `links` string
- `page` number
- `per_page` number
- `query` string, required
- `sort` 'alphabetical' | 'comments' | 'date' | 'duration' | 'likes' | 'plays' | 'relevant'
- `uris` string

## Response `200`

The search results were returned.

## Other responses

- `400` — * Error code 2101: Either the **uris** or **links** parameter has filtering or sorting arguments. * Error code 2204: A problem occurred with the batch request.
- `503` — * Search is disabled. * Error code 7300: An internal search error occurred.

## Changes

- **2026-07-13** `ea882e0224a4` — 3 info
  - added the optional property `items/metadata/connections/versions/resource_key` to the response with the `200` status
  - added the required property `items/metadata/connections/available_albums` to the response with the `200` status
  - added the required property `items/metadata/connections/available_channels` to the response with the `200` status
- **2019-03-29** `d66f7a79837f` — 1 info
  - added the required property `items/type` to the response with the `200` status
- **2019-02-22** `0aaf609c3dbf` — 1 info
  - added the optional property `items/password` to the response with the `200` status
- **2019-01-11** `89b756668a1e` — 2 info
  - added `#/components/schemas/project` to the `items/parent_folder` response property `allOf` list for the response status `200`
  - removed `#/components/schemas/folder` from the `items/parent_folder` response property `allOf` list for the response status `200`
- **2018-12-05** `26f856a94041` — 3 breaking, 2 warning, 2 info
  - removed the required property `items/metadata/connections/available_albums` from the response with the `200` status
  - removed the required property `items/metadata/connections/available_channels` from the response with the `200` status
  - removed the required property `items/type` from the response with the `200` status
  - removed the optional property `items/metadata/connections/versions/resource_key` from the response with the `200` status
  - …3 more

[Change history](https://skmtc.dev/vimeo/apis/vimeo-api/changes/videos/get.md)

---

[API](https://skmtc.dev/vimeo/apis/vimeo-api.md) · [All operations](https://skmtc.dev/vimeo/apis/vimeo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vimeo/vimeo-api/revisions/ea882e0224a4/schema)