Likes

Check if a user has liked a video

GET https://api.vimeo.com/me/likes/{video_id} Playground
GET https://api.vimeo.com/users/{user_id}/likes/{video_id} Playground
HTTP Status Code Explanation
204 No Content

The user has liked the video.

404 Not Found

If video was not found.

Get all users who have liked this video

GET https://api.vimeo.com/videos/{video_id}/likes Playground
Name Type Required Description
direction enum
  • asc
  • desc
No

The sort direction of the results.

page integer No

The page number to show.

per_page integer No

The number of items to show on each page (maximum 100).

sort enum
  • alphabetical
  • date
No

The technique for sorting the results.

HTTP Status Code Explanation
200 OK

The users were returned.

Get all users who liked videos in an On Demand page

GET https://api.vimeo.com/ondemand/pages/{ondemand_id}/likes Playground
Name Type Required Description
direction enum
  • asc
  • desc
No

The sort direction of the results.

filter enum
  • extra
  • main
  • trailer
No

The filter to apply to the results.

page integer No

The page number to show.

per_page integer No

The number of items to show on each page (maximum 100).

sort enum
  • alphabetical
  • date
No

The technique for sorting the results.

HTTP Status Code Explanation
200 OK

The users were returned.

Get all videos a user has liked

GET https://api.vimeo.com/me/likes Playground
GET https://api.vimeo.com/users/{user_id}/likes Playground
Name Type Required Description
filter enum
  • embeddable
No

The filter to apply to the results.

filter_embeddable boolean No

Whether to filter by all embeddable videos or by all videos that are not embeddable. *Required only if filter is embeddable.

page integer No

The page number to show.

per_page integer No

The number of items to show on each page (maximum 100).

query string No

The search query.

sort enum
  • alphabetical
  • comments
  • date
  • duration
  • likes
  • plays
No

The technique for sorting the results.

HTTP Status Code Explanation
200 OK

The videos were returned.

Like a video

PUT https://api.vimeo.com/me/likes/{video_id} Playground
PUT https://api.vimeo.com/users/{user_id}/likes/{video_id} Playground
This method requires a token with the "interact" scope.
HTTP Status Code Explanation
204 No Content

The video was liked.

403 Forbidden

The authorized user cannot like videos.

400 Bad Request

The authenticated user owns the video.

Unlike a video

DELETE https://api.vimeo.com/me/likes/{video_id} Playground
DELETE https://api.vimeo.com/users/{user_id}/likes/{video_id} Playground
This method requires a token with the "interact" scope.
HTTP Status Code Explanation
204 No Content

The video was unliked.

403 Forbidden

The authenticated user cannot like videos.

Send Feedback