Vimeo User API
One profile with the text, links, counts and public profile fields you need to qualify or display an account.
GET /v1/vimeo/users/{user}1 credit Failed requests are free
About this endpoint
GET /v1/vimeo/users/{user} takes a vanity handle (staff), a numeric id (152184) or the user<id> form. On found, data.user carries id, name, handle, url, bio, shortBio, location, website, links, verified, hasPublicVideos, createdAt, account (plus, pro, type), counts, avatar and profile.
counts covers videos, videos on the profile, appearances, likes, contacts, showcases, channels, groups, followers, following and portfolios. avatar has small, medium, large, huge, base and portrait360 sizes. profile carries available, isPrivate, updatedAt, socialLinks and portraitLarge; a null or false field means that fact was unavailable, while the rest of the user record still returns.
Vimeo User API FAQ
How do I name a user?
Use a vanity handle such as staff, a numeric id such as 152184, or user185091330. Each resolves to the same user record.
Which counts are returned?
counts.videos, videosOnProfile, appearances, likes, contacts, showcases, channels, groups, followers, following and portfolios. A hidden or unreported count is null. videosOnProfile can differ from videos because it is the count shown on the profile.
Why is user.profile null or unavailable?
profile.available is true when the optional fields were available, false when they were unavailable, and null when they are not included. Fields such as updatedAt are null when unavailable; the user record from the main lookup is still returned.
How many credits does a user 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.
Other Vimeo endpoints
- VideoGET /v1/vimeo/videos/{videoId}
- EmbedGET /v1/vimeo/videos/{videoId}/embed
- CaptionsGET /v1/vimeo/videos/{videoId}/captions
- BrowseGET /v1/vimeo/videos/browse
- CommentsGET /v1/vimeo/videos/{videoId}/comments
- CreditsGET /v1/vimeo/videos/{videoId}/credits
- LikesGET /v1/vimeo/videos/{videoId}/likes
- User videosGET /v1/vimeo/users/{user}/videos