List Vimeo user videos
List a Vimeo user's videos in the requested order.
Headers
Get your API keyAPI key (`sfk_...`)
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}$
Order of the videos. One of: date, alphabetical, plays, likes, duration, modified_time.
one of: date, alphabetical, plays, likes, duration, modified_time
Direction of the sort: `desc` or `asc`. Default: `asc` for `sort=alphabetical`, otherwise `desc`; also applied when `sort` is omitted.
one of: desc, asc
Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page.
≥ 1 · ≤ 20000
Rows per page, 1-100. Default: 25.
≥ 1 · ≤ 100
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
Endpoint-specific response payload.
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 requested user.
The user's videos in the requested order.
Video id.
≥ 0
Video page URL.
Title.
Description as plain text; null when empty.
Description as Vimeo formats it, line breaks included; null when it is empty.
When the video was uploaded, converted to UTC from Vimeo's US Eastern time.
When the record was last changed.
When the owner says the video was released.
Length in whole seconds.
≥ 0
Source width in pixels.
≥ 0
Source height in pixels.
≥ 0
Derived from width and height.
one of: landscape, portrait, square, null
Tags, without the leading separator.
Vimeo category names.
Language code the owner set.
Licence the owner set.
Vimeo content-rating labels.
The video's privacy settings.
Who may watch: `anybody`, `ptv` and similar.
Embedding permission: `public`, `private` or `whitelist`.
Who may comment: `anybody` and similar.
Where the video may be embedded.
one of: anywhere, approved, nowhere, null
Thumbnails in the sizes Vimeo offers.
Thumbnail, 100x75.
Thumbnail, 200x150.
Thumbnail, 640 pixels wide.
Thumbnail without a size suffix.
The user a record belongs to.
Vimeo user id.
≥ 0
Display name.
Vanity handle, or the `user<id>` form.
Profile page URL.
Avatars when the row carries them; null when the list row does not.
Square avatar, 30 pixels.
Square avatar, 75 pixels.
Square avatar, 100 pixels.
Square avatar, 300 pixels.
The avatar without a size suffix.
Profile-page portrait, 360 pixels.
Counts. Hidden counts are null, not zero.
Plays, or null when the uploader hides stats.
≥ 0
Likes, or null when the uploader hides stats.
≥ 0
Comments, or null when the uploader hides stats.
≥ 0
Pagination state for the current page. A short page is not the end: hasMore says whether another page exists.
Current page number (1-based).
≥ 0
Rows per page, when fixed; otherwise null.
≥ 0
How many rows match; null when no total is available. Vimeo's totals drift between pages.
≥ 0
Whether another page is available. A page can be shorter than `perPage` when a row is unavailable.
Opaque cursor for the next request; null on the last page or an empty page.
True when Vimeo stops this list before its end, so more rows exist beyond the last page.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
curl "https://api.socialfetch.dev/v1/vimeo/users/staff/videos" \
-H "x-api-key: YOUR_API_KEY"Responses
A page of a user's videos.