Vimeo

List Vimeo user showcases

List a Vimeo user's showcases.

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

API key (`sfk_...`)

Parameters
4
userstringrequiredpath

Vimeo user: a vanity handle (`staff`), a numeric id (`152184`), or `user<id>` (`user185091330`).

pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

pageintegeroptionalquery

Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page.

≥ 1 · ≤ 20000

limitintegeroptionalquery

Rows per page, 1-100. Default: 25.

≥ 1 · ≤ 100

cursorstringoptionalquery

Opaque cursor, 1 to 512 characters. Pass `page.nextCursor` from the previous response to get the next page; omit it to start at the first page. It is tied to the other filters.

min 1 chars · max 512 chars

Response fields
40

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

datauser
string

The requested user.

The user's showcases.

datashowcases[]id
integer

Showcase (album) id.

≥ 0

datashowcases[]title
stringnullable

Showcase title.

datashowcases[]description
stringnullable

Description as plain text.

datashowcases[]url
stringnullable

Showcase page URL.

datashowcases[]createdAt
stringnullable

When the showcase was created, in UTC.

datashowcases[]updatedAt
stringnullable

When the showcase was last changed, in UTC.

Thumbnails in the sizes Vimeo offers.

datashowcases[]thumbnailssmall
stringnullable

Thumbnail, 100x75.

datashowcases[]thumbnailsmedium
stringnullable

Thumbnail, 200x150.

datashowcases[]thumbnailslarge
stringnullable

Thumbnail, 640 pixels wide.

datashowcases[]thumbnailsbase
stringnullable

Thumbnail without a size suffix.

Counts for the showcase.

datashowcases[]countsvideos
integernullable

Videos in the showcase.

≥ 0

The user a record belongs to.

datashowcases[]ownerid
integernullable

Vimeo user id.

≥ 0

datashowcases[]ownername
stringnullable

Display name.

datashowcases[]ownerhandle
stringnullable

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

datashowcases[]ownerurl
stringnullable

Profile page URL.

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

datashowcases[]owneravatarsmall
stringnullable

Square avatar, 30 pixels.

datashowcases[]owneravatarmedium
stringnullable

Square avatar, 75 pixels.

datashowcases[]owneravatarlarge
stringnullable

Square avatar, 100 pixels.

datashowcases[]owneravatarhuge
stringnullable

Square avatar, 300 pixels.

datashowcases[]owneravatarbase
stringnullable

The avatar without a size suffix.

datashowcases[]owneravatarportrait360
stringnullable

Profile-page portrait, 360 pixels.

Pagination state for the current page. A short page is not the end: hasMore says whether another page exists.

datapagepage
integer

Current page number (1-based).

≥ 0

datapageperPage
integernullable

Rows per page, when fixed; otherwise null.

≥ 0

datapagetotal
integernullable

How many rows match; null when no total is available. Vimeo's totals drift between pages.

≥ 0

datapagehasMore
boolean

Whether another page is available. A page can be shorter than `perPage` when a row is unavailable.

datapagenextCursor
stringnullable

Opaque cursor for the next request; null on the last page or an empty page.

datapagetruncated
booleanoptional

True when Vimeo stops this list before its end, so more rows exist beyond the last page.

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/users/staff/showcases" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of showcases.