Social Fetch
Start for freeStart free
Vimeo hub

Vimeo Video Likers API

The users behind a video's likes, as compact records you can store and join by id.

GET /v1/vimeo/videos/{videoId}/likes

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/vimeo/videos/{videoId}/likes returns data.users, a page of the users who liked the video. Each row carries id, name, handle and url; profile fields such as bio, location, counts and avatar sizes are null on this list. Use users/{user} for the full record. data.total is the like count Vimeo reports, and data.page carries the usual page, perPage, total, hasMore and nextCursor.

Use limit up to 100 and follow page.nextCursor while hasMore is true. A video that is gone or private reads lookupStatus: not_found. The route reports likers; the like count on the video itself lives in data.video.stats.likes on the video route.

Vimeo Video Likers API FAQ

What does each liker include?

id, name, handle and url. Profile fields such as bio, location, counts and avatar sizes are null here; use users/{user} for the full record. The page block has page, perPage, total, hasMore and nextCursor.

How do I get more likers?

Set limit up to 100 and pass page.nextCursor as cursor while hasMore is true. The cursor is tied to this video and these filters.

Can I tell hidden likes from zero likes?

On the video route, stats.likes is null when the uploader hides counts, not zero. Here, total is the number Vimeo reports for the list, and an empty page with found is a real list with no rows on that page.

How many credits does a likers 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