---
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.

---

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