Vimeo

Get Vimeo showcase

Get a Vimeo showcase: title, description, thumbnails, owner and video count.

GET/v1/vimeo/showcases/{showcaseId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
showcaseIdstringrequiredpath

Vimeo showcase (album) id, e.g. `11959649`.

pattern: ^[1-9]\d{0,18}$

Response fields
32

Endpoint-specific response payload.

datalookupStatus
string

Whether the entity was found. A removed, private, password-protected or never-existing item is `not_found`; Vimeo does not distinguish them.

one of: found, not_found

The showcase when found; otherwise null.

datashowcaseid
integer

Showcase (album) id.

≥ 0

datashowcasetitle
stringnullable

Showcase title.

datashowcasedescription
stringnullable

Description as plain text.

datashowcaseurl
stringnullable

Showcase page URL.

datashowcasecreatedAt
stringnullable

When the showcase was created, in UTC.

datashowcaseupdatedAt
stringnullable

When the showcase was last changed, in UTC.

Thumbnails in the sizes Vimeo offers.

datashowcasethumbnailssmall
stringnullable

Thumbnail, 100x75.

datashowcasethumbnailsmedium
stringnullable

Thumbnail, 200x150.

datashowcasethumbnailslarge
stringnullable

Thumbnail, 640 pixels wide.

datashowcasethumbnailsbase
stringnullable

Thumbnail without a size suffix.

Counts for the showcase.

datashowcasecountsvideos
integernullable

Videos in the showcase.

≥ 0

The user a record belongs to.

datashowcaseownerid
integernullable

Vimeo user id.

≥ 0

datashowcaseownername
stringnullable

Display name.

datashowcaseownerhandle
stringnullable

Vanity handle, or the `user<id>` form.

datashowcaseownerurl
stringnullable

Profile page URL.

Avatars when the row carries them; null when the list row does not.

datashowcaseowneravatarsmall
stringnullable

Square avatar, 30 pixels.

datashowcaseowneravatarmedium
stringnullable

Square avatar, 75 pixels.

datashowcaseowneravatarlarge
stringnullable

Square avatar, 100 pixels.

datashowcaseowneravatarhuge
stringnullable

Square avatar, 300 pixels.

datashowcaseowneravatarbase
stringnullable

The avatar without a size suffix.

datashowcaseowneravatarportrait360
stringnullable

Profile-page portrait, 360 pixels.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/vimeo/showcases/11959649" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Vimeo showcase.