> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/vimeo/videos-videoid-comments>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/vimeo/videos-videoid-comments.mdx>

---

# 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` 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.

## Request

- **Endpoint:** `GET /v1/vimeo/videos/{videoId}/comments`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by video id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/vimeo/videos/videoid/comments/get)
- **Platform page:** [/platforms/vimeo](https://www.socialfetch.dev/platforms/vimeo)

## 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.