Vimeo

List Vimeo user or tag videos

List videos from a Vimeo user or tag with sorting and deep paging.

GET/v1/vimeo/videos/browse
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
tagstringquery

Browse videos carrying this tag.

min 1 chars · max 100 chars

userstringquery

Browse a user's videos (handle, numeric id or `user<id>`).

pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$

sortstringquery

Order of the list. Default: date.

one of: date, alphabetical, duration, plays, likes

pageintegerquery

Page number, 1-based. Default: 1.

≥ 1 · ≤ 20000

cursorstringquery

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

Response fields
16

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

Videos, in order.

datavideos[]id
integer

Video id.

≥ 0

datavideos[]title
stringnullable

Title.

datavideos[]url
stringnullable

Video page URL.

datavideos[]thumbnail
stringnullable

Thumbnail, 295x166.

datavideos[]uploadedAt
stringnullable

When the video was uploaded.

Pagination state for the browse list.

datapagepage
integer

Current page number (1-based).

≥ 0

datapagehasMore
boolean

Whether another page is available. A page can be short when a row is unavailable.

datapagenextCursor
stringnullable

Opaque cursor for the next request; null on the last page.

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/videos/browse?tag=cats" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of a user's or tag's videos.