getVideoComments
Retrieve and analyze YouTube video comments with sorting options, result limits, and reply fetching to gather audience feedback and insights.
Instructions
Retrieves comments for a YouTube video. Allows sorting, limiting results, and fetching a small number of replies per comment.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
commentDetail | No | Detail level for comment text. 'SNIPPET' (default, 200 chars) or 'FULL' (entire text). | SNIPPET |
maxReplies | No | Max replies per comment to return (0-5, default: 0). Use 0 for best performance. | |
maxResults | No | Max number of top-level comments to return (1-100, default: 20). | |
order | No | Sort order for comments. Use 'relevance' (default) for most helpful or 'time' for newest. | relevance |
videoId | Yes | The 11-character ID of the YouTube video. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"commentDetail": {
"default": "SNIPPET",
"description": "Detail level for comment text. 'SNIPPET' (default, 200 chars) or 'FULL' (entire text).",
"enum": [
"SNIPPET",
"FULL"
],
"type": "string"
},
"maxReplies": {
"default": 0,
"description": "Max replies per comment to return (0-5, default: 0). Use 0 for best performance.",
"maximum": 5,
"minimum": 0,
"type": "number"
},
"maxResults": {
"default": 20,
"description": "Max number of top-level comments to return (1-100, default: 20).",
"maximum": 100,
"minimum": 1,
"type": "number"
},
"order": {
"default": "relevance",
"description": "Sort order for comments. Use 'relevance' (default) for most helpful or 'time' for newest.",
"enum": [
"relevance",
"time"
],
"type": "string"
},
"videoId": {
"description": "The 11-character ID of the YouTube video.",
"minLength": 1,
"type": "string"
}
},
"required": [
"videoId"
],
"type": "object"
}