Vimeo Video Search API
Find videos by term, then sort by relevance, date, plays, likes, comments, duration or title. Licence and trending filters included.
GET /v1/vimeo/videos/search1 credit Failed requests are free
About this endpoint
GET /v1/vimeo/videos/search?query=cats returns data.videos and data.total, with each row a full video record. query is required unless trending=true, and accepts up to 200 characters. sort takes relevant, date, alphabetical, plays, likes, comments or duration. license filters to CC or CC-BY. trending=true returns the trending list instead of a query match: query and sort are ignored, and it cannot be combined with license.
Video search pages accept page up to 400, limit up to 100 and a cursor. The search routes stop at 10,000 rows. There is no lookupStatus on search: an empty videos array with hasMore: false is a real result.
Vimeo Video Search API FAQ
Which sort values can I use?
relevant, date, alphabetical, plays, likes, comments or duration. The default order is Vimeo's relevance order.
How does the trending filter work?
Set trending=true to return the trending videos without a query. query and sort are ignored, and it cannot be combined with license.
How deep can I page?
page accepts up to 400, limit up to 100, and a cursor continues from a previous page. The search routes stop at 10,000 rows, so a page past that cap is empty.
How many credits does a search page cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Vimeo endpoints
- VideoGET /v1/vimeo/videos/{videoId}
- EmbedGET /v1/vimeo/videos/{videoId}/embed
- CaptionsGET /v1/vimeo/videos/{videoId}/captions
- BrowseGET /v1/vimeo/videos/browse
- CommentsGET /v1/vimeo/videos/{videoId}/comments
- CreditsGET /v1/vimeo/videos/{videoId}/credits
- LikesGET /v1/vimeo/videos/{videoId}/likes
- UserGET /v1/vimeo/users/{user}