List comments
list_commentsRetrieves public comment threads from a video or channel's videos, including text, author, likes, date, reply counts, and whether the owner replied; supports pagination.
Instructions
Public comment threads on a video or on all of a channel's videos: text, author, likes, date, reply count, first replies.
owner_replied tells whether the channel answered in the included replies, which helps find unanswered questions. Paginated via next_page_token; 1 quota unit per page. Held-for-review comments are not visible.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_comments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| order | No | time (newest first) or relevance (relevance only together with video_id). | time |
| search | No | Only threads containing this text. | |
| channel | No | Channel ID (UC...) or handle (@name). Omit for your own channel (OAuth) or the configured default. | |
| video_id | No | Comments on this video. Omit for comments on all of the channel's videos. | |
| page_token | No | next_page_token from a previous call, for the next page. | |
| max_results | No | Threads per page, 1-100. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||