Vimeo hub

Vimeo Credits API

Who worked on a video: credited name, role and the linked Vimeo profile, with a flag that says whether the list is complete.

GET /v1/vimeo/videos/{videoId}/credits

1 credit Failed requests are free

About this endpoint

GET /v1/vimeo/videos/{videoId}/credits returns data.credits. Each credit has id, name, role and user; user is the owner shape with id, name, handle, URL and avatar, and is null when the credit is a name only. data.total is the number Vimeo reports, and data.creditsComplete says whether every credit it reports was returned.

Credits are a single page, not a cursor list. A video that is gone or private reads lookupStatus: not_found with an empty list. Use this route to build cast and crew lists, credit a collaborator, or join a video to a person's profile.

Vimeo Credits API FAQ

What does each credit include?

id, name, role and user. user has id, name, handle, url and avatar, and is null when the credit is a plain name. total is the count Vimeo reports.

What does creditsComplete mean?

true means every credit Vimeo reports was returned. false means the response stopped before the full list, so treat the array as a partial cast and try again later if you need all of it.

Is this a paged list?

No. Credits come back in one array. A missing or private video reads lookupStatus not_found with an empty array.

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