Vimeo User Showcases API
A profile's showcases, the curated albums behind a portfolio, with counts and thumbnails so you can choose which one to open.
GET /v1/vimeo/users/{user}/showcases1 credit Failed requests are free
About this endpoint
GET /v1/vimeo/users/{user}/showcases returns data.showcases. Each showcase has id, title, description, url, createdAt, updatedAt, thumbnails, counts.videos and owner. Use the id with showcases/{showcaseId} for the full record or showcases/{showcaseId}/videos for the videos inside.
The list is deep: page accepts 1 to 20,000 and limit accepts 1 to 100 (default 25). A missing or private user reads lookupStatus: not_found; a user with no showcases reads found with an empty array.
Vimeo User Showcases API FAQ
What does a showcase row include?
id, title, description, url, createdAt, updatedAt, thumbnails, counts.videos and owner. The counts tell you how large the album is before you fetch its videos.
How do I read the videos in a showcase?
Take the showcase id and call GET /v1/vimeo/showcases/{showcaseId}/videos. The single showcase route gives the full album record.
How many pages are available?
Deep paging: page accepts 1 to 20,000 and limit accepts 1 to 100 (default 25).
How many credits does a page cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Vimeo endpoints
- VideoGET /v1/vimeo/videos/{videoId}
- EmbedGET /v1/vimeo/videos/{videoId}/embed
- CaptionsGET /v1/vimeo/videos/{videoId}/captions
- BrowseGET /v1/vimeo/videos/browse
- CommentsGET /v1/vimeo/videos/{videoId}/comments
- CreditsGET /v1/vimeo/videos/{videoId}/credits
- LikesGET /v1/vimeo/videos/{videoId}/likes
- UserGET /v1/vimeo/users/{user}