Vimeo

List Vimeo channel subscribers

List the subscribers of a Vimeo channel.

GET/v1/vimeo/channels/{channel}/subscribers
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
channelstringrequiredpath

Vimeo channel slug or numeric id, e.g. `staffpicks` or `927`.

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

pageintegeroptionalquery

Page number, 1-20000. Default: 1. Use `page.nextCursor` to continue; a page past the last is an empty page.

≥ 1 · ≤ 20000

limitintegeroptionalquery

Rows per page, 1-100. Default: 25.

≥ 1 · ≤ 100

cursorstringoptionalquery

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
60

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

datachannel
string

The requested channel.

Subscribers of the channel.

datausers[]id
integer

Vimeo user id.

≥ 0

datausers[]name
stringnullable

Display name.

datausers[]handle
stringnullable

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

datausers[]url
stringnullable

Profile page URL.

datausers[]bio
stringnullable

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

datausers[]shortBio
stringnullable

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

datausers[]location
stringnullable

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

datausers[]website
stringnullable

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

Links the user lists, when available.

datausers[]links[]name
stringnullable

Link label.

datausers[]links[]url
string

Link URL.

datausers[]links[]type
stringnullable

Link type, as Vimeo labels it.

datausers[]verified
booleannullable

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

datausers[]hasPublicVideos
booleannullable

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

datausers[]createdAt
stringnullable

When the account was created, in UTC.

Account flags.

datausers[]accountplus
booleannullable

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

datausers[]accountpro
booleannullable

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

datausers[]accounttype
stringnullable

Membership type, when known.

Counts for the user.

datausers[]countsvideos
integernullable

Videos uploaded.

≥ 0

datausers[]countsvideosOnProfile
integernullable

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

≥ 0

datausers[]countsappearances
integernullable

Videos the user appears in.

≥ 0

datausers[]countslikes
integernullable

Videos the user liked.

≥ 0

datausers[]countscontacts
integernullable

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

≥ 0

datausers[]countsshowcases
integernullable

Showcases (albums).

≥ 0

datausers[]countschannels
integernullable

Channels.

≥ 0

datausers[]countsgroups
integernullable

Groups.

≥ 0

datausers[]countsfollowers
integernullable

Followers.

≥ 0

datausers[]countsfollowing
integernullable

Accounts the user follows.

≥ 0

datausers[]countsportfolios
integernullable

Portfolios.

≥ 0

Profile pictures in the sizes Vimeo offers.

datausers[]avatarsmall
stringnullable

Square avatar, 30 pixels.

datausers[]avatarmedium
stringnullable

Square avatar, 75 pixels.

datausers[]avatarlarge
stringnullable

Square avatar, 100 pixels.

datausers[]avatarhuge
stringnullable

Square avatar, 300 pixels.

datausers[]avatarbase
stringnullable

The avatar without a size suffix.

datausers[]avatarportrait360
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.

datausers[]profileavailable
booleannullable

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

datausers[]profileisPrivate
booleannullable

Whether the user hides their profile.

datausers[]profileupdatedAt
stringnullable

When the profile was last changed.

Public links the profile lists.

datausers[]profilesocialLinks[]
stringoptional
datausers[]profileportraitLarge
stringnullable

Profile-page portrait, 360 pixels.

Pagination state for the current page. A short page is not the end: hasMore says whether another page exists.

datapagepage
integer

Current page number (1-based).

≥ 0

datapageperPage
integernullable

Rows per page, when fixed; otherwise null.

≥ 0

datapagetotal
integernullable

How many rows match; null when no total is available. Vimeo's totals drift between pages.

≥ 0

datapagehasMore
boolean

Whether another page is available. A page can be shorter than `perPage` when a row is unavailable.

datapagenextCursor
stringnullable

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

datapagetruncated
booleanoptional

True when Vimeo stops this list before its end, so more rows exist beyond 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/channels/staffpicks/subscribers?limit=25" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of subscribers.