Vimeo User Likes API
A profile's liked videos, newest first, with the full video record for each one.
GET /v1/vimeo/users/{user}/likes1 credit Failed requests are free
About this endpoint
GET /v1/vimeo/users/{user}/likes returns data.videos with the videos a user liked. Each row is the usual video record. page.total counts the liked videos this route can list; it can be lower than user.counts.likes when some liked videos are no longer available. That makes the route useful for taste signals, recommendations and feed building without a second lookup per video.
The list is deep: page accepts 1 to 20,000 and limit accepts 1 to 100 (default 25). Continue with page.nextCursor while page.hasMore is true. A missing or private user reads lookupStatus: not_found; a user who has liked nothing reads found with an empty array.
Vimeo User Likes API FAQ
Why is page.total lower than the profile's like count?
page.total counts the liked videos this route can list. Some liked videos may no longer be available, so the profile's counts.likes can be higher.
How many pages are available?
Deep paging: page accepts 1 to 20,000 and limit accepts 1 to 100 (default 25).
Is this the same as the video likes route?
No. users/{user}/likes lists videos a user liked. videos/{videoId}/likes lists users who liked a video. Use both to connect the two directions.
How many credits does a 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}