Social Fetch
Start for freeStart free
Vimeo hub

Vimeo Comments API

A video's comments newest first, with the author record, text, timestamps, permalink and reply count.

GET /v1/vimeo/videos/{videoId}/comments

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/vimeo/videos/{videoId}/comments returns data.comments, newest first. Each comment has id, text, createdAt, editedAt, url, author and replyCount. author is the same owner shape used across Vimeo: id, name, handle, URL and avatar. data.total is the top-level comment count when Vimeo reports it; video.stats.comments on the video route can be higher, because it counts all comments while this list carries the top-level ones it can show. data.page carries page, perPage, total, hasMore and nextCursor.

Send limit up to 100 and follow page.nextCursor while hasMore is true. A video that is gone, private or has comments switched off reads lookupStatus: not_found with an empty list, so check the status before treating an empty answer as a quiet video.

Vimeo Comments API FAQ

What does each comment include?

id, text, createdAt, editedAt, url, author and replyCount. author has id, name, handle, url and avatar. The page block has page, perPage, total, hasMore and nextCursor.

How do I get more comments?

Set limit up to 100 and pass page.nextCursor as cursor while hasMore is true. The cursor is tied to this video; start again without it if you change the filters.

What if the video has no comments?

lookupStatus is found with an empty comments array, or not_found when the video is gone or private. The two cases are different, so check lookupStatus first.

How many credits does a comments page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Vimeo endpoints