Watch Later Queue

Add a video to a user's Watch Later queue

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

The video was added.

Check if a user has added a specific video to their Watch Later queue

GET https://api.vimeo.com/me/watchlater/{video_id} Playground
GET https://api.vimeo.com/users/{user_id}/watchlater/{video_id} Playground
This method requires a token with the "private" scope.
HTTP Status Code Explanation
200 OK

The user has at least the video in their Watch Later queue.

404 Not Found

If video was not found.

Get all the videos in a user's Watch Later queue

GET https://api.vimeo.com/me/watchlater Playground
GET https://api.vimeo.com/users/{user_id}/watchlater Playground
This method requires a token with the "private" scope.
Name Type Required Description
direction enum
  • asc
  • desc
No

The sort direction of the results.

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
304 Not Modified

This user has not added any videos to their Watch Later queue since the given If-Modified-Since header.

200 OK

The videos were returned.

Remove a video from a user's Watch Later queue

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

The video was deleted.

Send Feedback