Vimeo hub

Vimeo User Search API

Find profiles by term, sort by followers and page through user records.

GET /v1/vimeo/users/search

1 credit Failed requests are free

About this endpoint

GET /v1/vimeo/users/search?query=film returns data.users and data.total. Each row is a user record with the fields this route returns; fields it does not return are null, so load users/{user} when you need the full profile. query is required and accepts up to 200 characters; sort takes followers.

User search accepts page up to 400, limit up to 100 and a cursor, and stops at 10,000 rows. There is no lookupStatus on search: an empty users array with hasMore: false is a real result, not a missing profile.

Vimeo User Search API FAQ

What is in each search result?

A user record with id, name, handle, url and the fields this route returns. Some account and profile fields are null; get users/{user} for the full record.

How can I sort user results?

sort accepts followers. Leave it out for Vimeo's relevance order.

How deep can I page?

page accepts up to 400, limit up to 100, and a cursor continues from a previous page. User search stops at 10,000 rows.

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.