Social Fetch
Start for freeStart free
Vimeo hub

Vimeo Showcase API

One showcase with the title, owner and video count you need to list a curated collection.

GET /v1/vimeo/showcases/{showcaseId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/vimeo/showcases/{showcaseId} takes a digits-only album id such as 11959649. On found, data.showcase carries id, title, description, url, createdAt, updatedAt, thumbnails, counts.videos and owner. The owner uses the same shape as elsewhere: id, name, handle, URL and avatar.

Use the id with showcases/{showcaseId}/videos for the videos inside. A private, password-protected or unknown showcase reads lookupStatus: not_found with showcase null. Vimeo does not tell those cases apart.

Vimeo Showcase API FAQ

What does a showcase record include?

id, title, description, url, createdAt, updatedAt, thumbnails, counts.videos and owner. The video count tells you the album's size before you read its rows.

Why is a showcase not found?

The id may not exist, or the showcase may be private or password protected. All three answer not_found, so the response carries no partial record.

How do I get the showcase's videos?

Call GET /v1/vimeo/showcases/{showcaseId}/videos. It returns full video records with play counts per row where available.

How many credits does a showcase lookup 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