Vimeo

Get Vimeo user

Get a Vimeo user: profile, bio, links, account flags, counts, followers and last-changed time.

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

API key (`sfk_...`)

Parameters
1
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}$

Response fields
52

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 user when found; otherwise null.

datauserid
integer

Vimeo user id.

≥ 0

datausername
stringnullable

Display name.

datauserhandle
stringnullable

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

datauserurl
stringnullable

Profile page URL.

datauserbio
stringnullable

Biography; null when the list row does not include it.

datausershortBio
stringnullable

Short biography; null when the list row does not include it.

datauserlocation
stringnullable

Location the user set; null when the list row does not include it.

datauserwebsite
stringnullable

Website the user lists; null when the list row does not include it.

Links the user lists, when available.

datauserlinks[]name
stringnullable

Link label.

datauserlinks[]url
string

Link URL.

datauserlinks[]type
stringnullable

Link type, as Vimeo labels it.

datauserverified
booleannullable

Whether the user is verified; null when the list row does not include it.

datauserhasPublicVideos
booleannullable

Whether the profile says the user has public videos; null on list rows that do not include it.

datausercreatedAt
stringnullable

When the account was created, in UTC.

Account flags.

datauseraccountplus
booleannullable

Whether the account is Plus; null on list rows that do not include account flags.

datauseraccountpro
booleannullable

Whether the account is Pro; null on list rows that do not include account flags.

datauseraccounttype
stringnullable

Membership type, when known.

Counts for the user.

datausercountsvideos
integernullable

Videos uploaded.

≥ 0

datausercountsvideosOnProfile
integernullable

Videos the profile lists; it can differ from `videos`, and is null on list rows that do not include it.

≥ 0

datausercountsappearances
integernullable

Videos the user appears in.

≥ 0

datausercountslikes
integernullable

Videos the user liked.

≥ 0

datausercountscontacts
integernullable

Contacts; null on list rows that do not include them.

≥ 0

datausercountsshowcases
integernullable

Showcases (albums).

≥ 0

datausercountschannels
integernullable

Channels.

≥ 0

datausercountsgroups
integernullable

Groups.

≥ 0

datausercountsfollowers
integernullable

Followers.

≥ 0

datausercountsfollowing
integernullable

Accounts the user follows.

≥ 0

datausercountsportfolios
integernullable

Portfolios.

≥ 0

Profile pictures in the sizes Vimeo offers.

datauseravatarsmall
stringnullable

Square avatar, 30 pixels.

datauseravatarmedium
stringnullable

Square avatar, 75 pixels.

datauseravatarlarge
stringnullable

Square avatar, 100 pixels.

datauseravatarhuge
stringnullable

Square avatar, 300 pixels.

datauseravatarbase
stringnullable

The avatar without a size suffix.

datauseravatarportrait360
stringnullable

Profile-page portrait, 360 pixels.

Optional public profile fields. `available` is null when they are not included and false when they are unavailable. List rows that do not carry profile data leave these fields null.

datauserprofileavailable
booleannullable

Whether the optional profile fields were available; null when they are not included, as on list rows.

datauserprofileisPrivate
booleannullable

Whether the user hides their profile.

datauserprofileupdatedAt
stringnullable

When the profile was last changed.

Public links the profile lists.

datauserprofilesocialLinks[]
stringoptional
datauserprofileportraitLarge
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/users/staff" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A Vimeo user.