Developer / API / Endpoints

api.vimeo.com/likes

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

404 Not Found

If the video cannot be found.

Get all users who have liked this video

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

The direction that the results are sorted.
page integer No

The page number to show.
per_page integer No

Number of items to show on each page. Max 100.
query string No

Search query.
sort string
  • alphabetical
  • date
 No

Technique used to sort the results.
HTTP Status Code Explanation
200 OK

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 string
  • asc
  • desc
 No

The direction that the results are sorted.
filter string
  • extra
  • main
  • trailer
 No

Filter to apply to the results.
page integer No

The page number to show.
per_page integer No

Number of items to show on each page. Max 100.
query string No

Search query.
sort string
  • alphabetical
  • date
 No

Technique used to sort the results.
HTTP Status Code Explanation
200 OK

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
direction string No

The direction that the results are sorted.
filter string
  • embeddable
 No

Filter to apply to the results.
filter_embeddable string
  • false
  • true
 No

Required if filter=embeddable. Choose between only videos that are embeddable, and only videos that are not embeddable.
page integer No

The page number to show.
per_page integer No

Number of items to show on each page. Max 100.
query string No

Search query.
sort string
  • alphabetical
  • comments
  • date
  • duration
  • likes
  • plays
 No

Technique used to sort the results.
HTTP Status Code Explanation
200 OK

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

403 Forbidden

If the authenticated user is not allowed to like videos.
400 Bad Request

If the video is owned by the authenticated user.

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

403 Forbidden

If the authenticated user is not allowed to like videos.
Send Feedback