List comments

List viewer comments on a video, newest first.

GET https://cotlet.dev/api/v1/vimeo/videos/{video_id}/comments

read

Returns public viewer comments with author, text, date and replies. Collaborator comments from review links are separate and are not included. If comments are turned off on the video, the list is empty.

Parameters

Parameters: list_comments
NameTypeDescription
video_id string required string Video ID from search_videos, the number in vimeo.com/{id}.
cursor string string Next page cursor from the previous call.

Request

cURL
curl https://cotlet.dev/api/v1/vimeo/videos/video_8c41d2/comments \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("vimeo", "list_comments", {"video_id":"video_8c41d2"})
Node.js
const result = await cotlet.call('vimeo', 'list_comments', {"video_id":"video_8c41d2"});
CLI
cotlet call vimeo list_comments --data '{"video_id":"video_8c41d2"}'

Example response

JSON

{
  "video_id": "912345601",
  "comments": [
    {
      "comment_id": "c-7781",
      "author": "Sam Rivera",
      "text": "Great walkthrough, thank you.",
      "created_at": "2026-10-15T10:12:00Z",
      "replies": 0
    },
    {
      "comment_id": "c-7790",
      "author": "promo_seller",
      "text": "Cheap followers at example.net",
      "created_at": "2026-10-16T22:40:00Z",
      "replies": 0
    }
  ],
  "next_cursor": null
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.