Social Fetch
Start for freeStart free
Vimeo hub

Vimeo Appearances API

Videos a profile appears in but did not upload, as full video records. Useful for cast, crew and collaboration research.

GET /v1/vimeo/users/{user}/appearances

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/vimeo/users/{user}/appearances returns data.videos, the videos in which the user appears. Each row is the video record used across the API, so you get the title, description, dates, tags, thumbnails, owner, privacy, embed permission and stats for every appearance.

This is different from users/{user}/videos, which lists the user's own uploads. A person can upload few videos and appear in many, so the two lists answer different questions. The list is deep: page accepts 1 to 20,000 and limit accepts 1 to 100 (default 25). Continue with page.nextCursor. A missing or private user reads lookupStatus: not_found.

Vimeo Appearances API FAQ

How is this different from a user's videos?

users/{user}/videos lists uploads the user owns. users/{user}/appearances lists videos where the user appears, which may be owned by someone else. Both return full video records.

How many pages are available?

Deep paging: page accepts 1 to 20,000 and limit accepts 1 to 100 (default 25). Continue with page.nextCursor while page.hasMore is true.

What if the user does not exist?

lookupStatus is not_found and videos is empty. A found user with no appearances returns found with an empty array.

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