Vimeo

List Vimeo video comments

List a Vimeo video's comments with their authors and reply counts.

GET/v1/vimeo/videos/{videoId}/comments
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
videoIdstringrequiredpath

Vimeo video id, e.g. `76979871`.

pattern: ^[1-9]\d{0,18}$

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
34

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

datavideoId
integer

Video id.

≥ 0

Comments, newest first.

datacomments[]id
integer

Comment id.

≥ 0

datacomments[]text
stringnullable

Comment text.

datacomments[]createdAt
stringnullable

When the comment was written.

datacomments[]editedAt
stringnullable

When the comment was last edited.

datacomments[]url
stringnullable

Comment permalink.

The user a record belongs to.

datacomments[]authorid
integernullable

Vimeo user id.

≥ 0

datacomments[]authorname
stringnullable

Display name.

datacomments[]authorhandle
stringnullable

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

datacomments[]authorurl
stringnullable

Profile page URL.

Avatars when the row carries them; null when the list row does not.

datacomments[]authoravatarsmall
stringnullable

Square avatar, 30 pixels.

datacomments[]authoravatarmedium
stringnullable

Square avatar, 75 pixels.

datacomments[]authoravatarlarge
stringnullable

Square avatar, 100 pixels.

datacomments[]authoravatarhuge
stringnullable

Square avatar, 300 pixels.

datacomments[]authoravatarbase
stringnullable

The avatar without a size suffix.

datacomments[]authoravatarportrait360
stringnullable

Profile-page portrait, 360 pixels.

datacomments[]replyCount
integernullable

Replies to the comment.

≥ 0

datatotal
integernullable

Top-level comments Vimeo reports.

≥ 0

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/videos/76979871/comments?limit=25" \
  -H "x-api-key: YOUR_API_KEY"

Responses

A page of comments.