Tags

Add a tag to a video

PUT https://api.vimeo.com/videos/{video_id}/tags/{word} Playground
This method requires a token with the "edit" scope.
HTTP Status Code Explanation
204 No Content

400 Bad Request

If the tag is invalid.

400 Bad Request

If an unsupported parameter is supplied.

403 Forbidden

If the number of tags on the video would exceed 20.

Assign many tags to a video

PUT https://api.vimeo.com/videos/{video_id}/tags Playground
This method requires a token with the "edit" scope.
Name Type Required Description
page integer No

The page number to show.

per_page integer No

Number of items to show on each page. Max 100.

tag string Yes

The name of the tag to apply. See our documentation on batch requests for more information.

HTTP Status Code Explanation
201 Created

400 Bad Request

If the request body is not supplied.

400 Bad Request

If one of the parameters is invalid.

400 Bad Request

If the request body is not a JSON encoded list of tags.

403 Forbidden

If the authenticated user is not allowed to add tags to a video.

403 Forbidden

If the number of tags would exceed 20.

Check if a tag has been added to a video

GET https://api.vimeo.com/videos/{video_id}/tags/{word} Playground
HTTP Status Code Explanation
204 No Content

400 Bad Request

If one of the parameters is invalid.

400 Bad Request

If the tag is invalid.

404 Not Found

If the tag cannot be found in the video.

Delete a tag from a video

DELETE https://api.vimeo.com/videos/{video_id}/tags/{word} Playground
This method requires a token with the "edit" scope.
HTTP Status Code Explanation
204 No Content

400 Bad Request

If one of the parameters is invalid.

400 Bad Request

If the tag is invalid.

Get a tag

GET https://api.vimeo.com/tags/{word} Playground
HTTP Status Code Explanation
200 OK

Get all videos tagged with a specific word

GET https://api.vimeo.com/tags/{word}/videos 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.

sort string
  • created_time
  • duration
  • name
No

Technique used to sort the results.

HTTP Status Code Explanation
200 OK

404 Not Found

If the tag cannot be found.

List a videos' tags

GET https://api.vimeo.com/videos/{video_id}/tags Playground
HTTP Status Code Explanation
200 OK

Send Feedback