Vimeo hub

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/search

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