v1

latestOpenAPI 3.0.22026-07-1332837755.1 KB
Videos\Essentials

Search for videos

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

get/videos

Query parameters

direction'asc' | 'desc'
Example:asc

The sort direction of the results.

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'

The attribute by which to filter the results. CC and related filters target videos with the corresponding Creative Commons licenses. For more information, see our Creative Commons page.

linksstring
Example:https://vimeo.com/122375452,https://vimeo.com/273576296

A comma-separated list of video URLs to find.

pagenumber
Example:1

The page number of the results to show.

per_pagenumber
Example:10

The number of items to show on each page of results, up to a maximum of 100.

querystring required
Example:staff picks

The search query.

sort'alphabetical' | 'comments' | 'date' | 'duration' | 'likes' | 'plays' | 'relevant'

The way to sort the results.

urisstring
Example:/videos/122375452,/videos/273576296

A comma-separated list of video URIs to find.

Response

The search results were returned.