vimeo-api

name	vimeo-api
description	Vimeo API skill. Use when working with Vimeo for root, categories, channels. Covers 328 endpoints.
version	1.0.0
generator	lapsh

Vimeo API

API version: 3.4

Auth

Bearer bearer | OAuth2

Base URL

https://api.vimeo.com

Setup

1. Set Authorization header with your Bearer token
2. GET / -- verify access
3. POST /channels -- create first channels

Endpoints

328 endpoints across 15 groups. See references/api-spec.lap for full details.

root

Method	Path	Description
GET	/	Get an API specification

categories

Method	Path	Description
GET	/categories	Get all categories
GET	/categories/{category}	Get a specific category
GET	/categories/{category}/channels	Get all the channels in a category
GET	/categories/{category}/groups	Get all the groups in a category
GET	/categories/{category}/videos	Get all the videos in a category
GET	/categories/{category}/videos/{video_id}	Check for a video in a category

channels

Method	Path	Description
GET	/channels	Get all channels
POST	/channels	Create a channel
DELETE	/channels/{channel_id}	Delete a channel
GET	/channels/{channel_id}	Get a specific channel
PATCH	/channels/{channel_id}	Edit a channel
GET	/channels/{channel_id}/categories	Get all the categories in a channel
PUT	/channels/{channel_id}/categories	Add a list of categories to a channel
DELETE	/channels/{channel_id}/categories/{category}	Remove a category from a channel
PUT	/channels/{channel_id}/categories/{category}	Categorize a channel
DELETE	/channels/{channel_id}/moderators	Remove a list of channel moderators
GET	/channels/{channel_id}/moderators	Get all the moderators in a channel
PATCH	/channels/{channel_id}/moderators	Replace the moderators of a channel
PUT	/channels/{channel_id}/moderators	Add a list of channel moderators
GET	/channels/{channel_id}/moderators/{user_id}	Get a specific channel moderator
DELETE	/channels/{channel_id}/moderators/{user_id}	Remove a specific channel moderator
PUT	/channels/{channel_id}/moderators/{user_id}	Add a specific channel moderator
GET	/channels/{channel_id}/privacy/users	Get all the users who can view a private channel
PUT	/channels/{channel_id}/privacy/users	Permit a list of users to view a private channel
DELETE	/channels/{channel_id}/privacy/users/{user_id}	Restrict a user from viewing a private channel
PUT	/channels/{channel_id}/privacy/users/{user_id}	Permit a specific user to view a private channel
GET	/channels/{channel_id}/tags	Get all the tags that have been added to a channel

contentratings

Method	Path	Description
GET	/contentratings	Get all content ratings

creativecommons

Method	Path	Description
GET	/creativecommons	Get all Creative Commons licenses

groups

Method	Path	Description
GET	/groups	Get all groups
POST	/groups	Create a group
DELETE	/groups/{group_id}	Delete a group
GET	/groups/{group_id}	Get a specific group
GET	/groups/{group_id}/users	Get all the members of a group
GET	/groups/{group_id}/videos	Get all the videos in a group
DELETE	/groups/{group_id}/videos/{video_id}	Remove a video from a group
GET	/groups/{group_id}/videos/{video_id}	Get a specific video in a group
PUT	/groups/{group_id}/videos/{video_id}	Add a video to a group

languages

Method	Path	Description
GET	/languages	Get all languages

me

Method	Path	Description
GET	/me	Get a user
PATCH	/me	Edit a user
GET	/me/albums	Get all the albums that belong to a user
POST	/me/albums	Create an album
DELETE	/me/albums/{album_id}	Delete an album
GET	/me/albums/{album_id}	Get a specific album
PATCH	/me/albums/{album_id}	Edit an album
GET	/me/albums/{album_id}/videos	Get all the videos in an album
PUT	/me/albums/{album_id}/videos	Replace all the videos in an album
DELETE	/me/albums/{album_id}/videos/{video_id}	Remove a video from an album
GET	/me/albums/{album_id}/videos/{video_id}	Get a specific video in an album
PUT	/me/albums/{album_id}/videos/{video_id}	Add a specific video to an album
POST	/me/albums/{album_id}/videos/{video_id}/set_album_thumbnail	Set a video as the album thumbnail
GET	/me/appearances	Get all the videos in which a user appears
GET	/me/categories	Get all the categories that a user follows
DELETE	/me/categories/{category}	Unsubscribe a user from a category
GET	/me/categories/{category}	Check if a user follows a category
PUT	/me/categories/{category}	Subscribe a user to a single category
GET	/me/channels	Get all the channels to which a user subscribes
DELETE	/me/channels/{channel_id}	Unsubscribe a user from a specific channel
GET	/me/channels/{channel_id}	Check if a user follows a channel
PUT	/me/channels/{channel_id}	Subscribe a user to a specific channel
GET	/me/customlogos

oauth

Method	Path	Description
POST	/oauth/access_token	Exchange an authorization code for an access token
POST	/oauth/authorize/client	Authorize a client with OAuth
POST	/oauth/authorize/vimeo_oauth1	Convert OAuth 1 access tokens to OAuth 2 access tokens
GET	/oauth/verify	Verify an OAuth 2 token

ondemand

Method	Path	Description
GET	/ondemand/genres	Get all On Demand genres
GET	/ondemand/genres/{genre_id}	Get a specific On Demand genre
GET	/ondemand/genres/{genre_id}/pages	Get all the On Demand pages in a genre
GET	/ondemand/genres/{genre_id}/pages/{ondemand_id}	Get a specific On Demand page in a genre
DELETE	/ondemand/pages/{ondemand_id}	Delete a draft of an On Demand page
GET	/ondemand/pages/{ondemand_id}	Get a specific On Demand page
PATCH	/ondemand/pages/{ondemand_id}	Edit an On Demand page
GET	/ondemand/pages/{ondemand_id}/backgrounds	Get all the backgrounds of an On Demand page
POST	/ondemand/pages/{ondemand_id}/backgrounds	Add a background to an On Demand page
DELETE	/ondemand/pages/{ondemand_id}/backgrounds/{background_id}	Remove a background from an On Demand page
GET	/ondemand/pages/{ondemand_id}/backgrounds/{background_id}	Get a specific background of an On Demand page
PATCH	/ondemand/pages/{ondemand_id}/backgrounds/{background_id}	Edit a background of an On Demand page
GET	/ondemand/pages/{ondemand_id}/genres	Get all the genres of an On Demand page
DELETE	/ondemand/pages/{ondemand_id}/genres/{genre_id}	Remove a genre from an On Demand page
GET	/ondemand/pages/{ondemand_id}/genres/{genre_id}	Check whether an On Demand page belongs to a genre
PUT	/ondemand/pages/{ondemand_id}/genres/{genre_id}	Add a genre to an On Demand page
GET	/ondemand/pages/{ondemand_id}/likes	Get all the users who have liked a video on an On Demand page
GET	/ondemand/pages/{ondemand_id}/pictures	Get all the posters of an On Demand page
POST	/ondemand/pages/{ondemand_id}/pictures	Add a poster to an On Demand page
GET

tags

Method	Path	Description
GET	/tags/{word}	Get a specific tag
GET	/tags/{word}/videos	Get all the videos with a specific tag

tokens

Method	Path	Description
DELETE	/tokens	Revoke the current access token

tutorial

Method	Path	Description
GET	/tutorial	Get started with the Vimeo API

users

Method	Path	Description
GET	/users	Search for users
GET	/users/{user_id}	Get a user
PATCH	/users/{user_id}	Edit a user
GET	/users/{user_id}/albums	Get all the albums that belong to a user
POST	/users/{user_id}/albums	Create an album
DELETE	/users/{user_id}/albums/{album_id}	Delete an album
GET	/users/{user_id}/albums/{album_id}	Get a specific album
PATCH	/users/{user_id}/albums/{album_id}	Edit an album
GET	/users/{user_id}/albums/{album_id}/custom_thumbnails	Get all the custom upload thumbnails of an album
POST	/users/{user_id}/albums/{album_id}/custom_thumbnails	Add a custom uploaded thumbnail
DELETE	/users/{user_id}/albums/{album_id}/custom_thumbnails/{thumbnail_id}	Remove a custom uploaded album thumbnail
GET	/users/{user_id}/albums/{album_id}/custom_thumbnails/{thumbnail_id}	Get a specific custom uploaded album thumbnail
PATCH	/users/{user_id}/albums/{album_id}/custom_thumbnails/{thumbnail_id}	Replace a custom uploaded album thumbnail
GET	/users/{user_id}/albums/{album_id}/logos	Get all the custom logos of an album
POST	/users/{user_id}/albums/{album_id}/logos	Add a custom album logo
DELETE	/users/{user_id}/albums/{album_id}/logos/{logo_id}	Remove a custom album logo
GET	/users/{user_id}/albums/{album_id}/logos/{logo_id}	Get a specific custom album logo
PATCH	/users/{user_id}/albums/{album_id}/logos/{logo_id}	Replace a custom album logo
GET	/users/{user_id}/albums/{album_id}/videos	Get all the videos in an album
PUT	/users/{user_id}/albums/{album_id}/videos	Replace all the videos in an album
DELETE	/users/{user_id}/albums/{album_id}/videos/{video_id}

videos

Method	Path	Description
GET	/videos	Search for videos
DELETE	/videos/{video_id}	Delete a video
GET	/videos/{video_id}	Get a specific video
PATCH	/videos/{video_id}	Edit a video
GET	/videos/{video_id}/available_albums	Get all the albums to which a user can add or remove a specific video
GET	/videos/{video_id}/available_channels	Get all the channels to which a user can add or remove a specific video
GET	/videos/{video_id}/categories	Get all the categories to which a video belongs
PUT	/videos/{video_id}/categories	Suggest categories for a video
GET	/videos/{video_id}/comments	Get all the comments on a video
POST	/videos/{video_id}/comments	Add a comment to a video
DELETE	/videos/{video_id}/comments/{comment_id}	Delete a video comment
GET	/videos/{video_id}/comments/{comment_id}	Get a specific video comment
PATCH	/videos/{video_id}/comments/{comment_id}	Edit a video comment
GET	/videos/{video_id}/comments/{comment_id}/replies	Get all the replies to a video comment
POST	/videos/{video_id}/comments/{comment_id}/replies	Add a reply to a video comment
GET	/videos/{video_id}/credits	Get all the credited users in a video
POST	/videos/{video_id}/credits	Credit a user in a video
DELETE	/videos/{video_id}/credits/{credit_id}	Delete the credit for a user in a video
GET	/videos/{video_id}/credits/{credit_id}	Get a specific credited user in a video
PATCH	/videos/{video_id}/credits/{credit_id}	Edit the credit for a user in a video
GET	/videos/{video_id}/likes	Get all the users who have liked a video

Common Questions

Match user requests to endpoints in references/api-spec.lap. Key patterns:

• "List all categories?" -> GET /categories
• "Get category details?" -> GET /categories/{category}
• "Search channels?" -> GET /categories/{category}/channels
• "Search groups?" -> GET /categories/{category}/groups
• "Search videos?" -> GET /categories/{category}/videos
• "Get video details?" -> GET /categories/{category}/videos/{video_id}
• "Search channels?" -> GET /channels
• "Create a channel?" -> POST /channels
• "Delete a channel?" -> DELETE /channels/{channel_id}
• "Get channel details?" -> GET /channels/{channel_id}
• "Partially update a channel?" -> PATCH /channels/{channel_id}
• "List all categories?" -> GET /channels/{channel_id}/categories
• "Delete a category?" -> DELETE /channels/{channel_id}/categories/{category}
• "Update a category?" -> PUT /channels/{channel_id}/categories/{category}
• "Search moderators?" -> GET /channels/{channel_id}/moderators
• "Get moderator details?" -> GET /channels/{channel_id}/moderators/{user_id}
• "Delete a moderator?" -> DELETE /channels/{channel_id}/moderators/{user_id}
• "Update a moderator?" -> PUT /channels/{channel_id}/moderators/{user_id}
• "List all users?" -> GET /channels/{channel_id}/privacy/users
• "Delete a user?" -> DELETE /channels/{channel_id}/privacy/users/{user_id}
• "Update a user?" -> PUT /channels/{channel_id}/privacy/users/{user_id}
• "List all tags?" -> GET /channels/{channel_id}/tags
• "Delete a tag?" -> DELETE /channels/{channel_id}/tags/{word}
• "Get tag details?" -> GET /channels/{channel_id}/tags/{word}
• "Update a tag?" -> PUT /channels/{channel_id}/tags/{word}
• "Search users?" -> GET /channels/{channel_id}/users
• "Search videos?" -> GET /channels/{channel_id}/videos
• "Delete a video?" -> DELETE /channels/{channel_id}/videos/{video_id}
• "Get video details?" -> GET /channels/{channel_id}/videos/{video_id}
• "Update a video?" -> PUT /channels/{channel_id}/videos/{video_id}
• "List all comments?" -> GET /channels/{channel_id}/videos/{video_id}/comments
• "Create a comment?" -> POST /channels/{channel_id}/videos/{video_id}/comments
• "Search credits?" -> GET /channels/{channel_id}/videos/{video_id}/credits
• "Create a credit?" -> POST /channels/{channel_id}/videos/{video_id}/credits
• "List all likes?" -> GET /channels/{channel_id}/videos/{video_id}/likes
• "List all pictures?" -> GET /channels/{channel_id}/videos/{video_id}/pictures
• "Create a picture?" -> POST /channels/{channel_id}/videos/{video_id}/pictures

Response Tips

• Check response schemas in references/api-spec.lap for field details
• List endpoints may support pagination; check for limit, offset, or cursor params
• Create/update endpoints typically return the created/updated object

References

• Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas

Generated from the official API spec by LAP