Vimeo hub

Vimeo Channel Search API

Find channels by term, then page through channel records with subscriber and video counts.

GET /v1/vimeo/channels/search

1 credit Failed requests are free

About this endpoint

GET /v1/vimeo/channels/search?query=staff returns data.channels and data.total. Each row has the channel fields: id, name, description, logo, badge, url, dates, creator, counts and tags. The search rows are lighter than the single channel record, so use the id or slug with channels/{channel} when you need the full branding and counts.

Results follow Vimeo's relevance order; there is no sort parameter. The route accepts page up to 20,000, limit up to 100 and a cursor, and stops at 10,000 rows. There is no lookupStatus on search: an empty channels array with hasMore: false is a real result.

Vimeo Channel Search API FAQ

What does each channel result include?

id, name, description, logo, badge, url, createdAt, updatedAt, creator, counts and tags. For the complete channel record, use the single channel route with its slug or id.

Can I sort channels?

No. Results follow Vimeo's relevance order; use the channel route when you need a specific channel by slug or id.

How deep can I page?

page accepts up to 20,000, limit up to 100, and a cursor continues from a previous page. Channel 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.