> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/vimeo/showcases-showcaseid>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/vimeo/showcases-showcaseid.mdx>

---

# Vimeo Showcase API

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

`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.

## Request

- **Endpoint:** `GET /v1/vimeo/showcases/{showcaseId}`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by showcase id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/vimeo/showcases/showcaseid/get)
- **Platform page:** [/platforms/vimeo](https://www.socialfetch.dev/platforms/vimeo)

## 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.