YouTube video comments

Fetch top-level comments for a YouTube video with optional pagination.

← All YouTube endpoints · Capability overview

GET/v1/youtube/video-comments

https://api.vee3.io/v1/youtube/video-comments

15 tokens

Fetch top-level comments for a YouTube video with optional pagination.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_youtube_video_comments

Parameters3 fields

video_idstringRequired

YouTube video id (11 characters, not a URL).

max length 11

cursorstringOptional

Pagination cursor from a previous response cursorNext field.

max length 4096

sort_bystringOptional

Comment sort order. One of: Top comments, Newest first.

max length 128

Response21 fields

commentsarrayitems

18 fields

Top-level comments for the current page and sort order. Additional provider-specific fields may appear on each entry.

commentIdstring

Comment id.

contentstring

Comment text.

publishedTimeTextstring

Human-readable comment age.

creatorHeartboolean

Whether the video creator hearted this comment.

cursorRepliesstring

Pagination cursor for fetching replies to this comment.

authorobject

6 fields

Comment author profile summary.

channelIdstring

Comment author channel id.

titlestring

Comment author display name.

isChannelOwnerboolean

Whether the author owns the video channel.

badgesarrayitems

2 fields

Author badges (for example Verified).

textstring

Badge label.

typestring

Badge type code.

statsobject

2 fields

Engagement counts for the comment.

repliesinteger

Reply count.

votesinteger

Like/vote count.

pinnedobject

2 fields

Pinned comment status.

statusboolean

Whether the comment is pinned.

textstring

Pinned label text when present.

cursorNextstring

Cursor for the next comments page, when available.

totalCommentsCountinteger

Total number of comments on the video.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, youtube_video_not_found, youtube_video_comments_sort_not_found, youtube_not_configured, youtube_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/youtube/video-comments"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "video_id": "kJQP7kiw5Fk"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample comments page with pagination cursor.

despacito_comments.json

{
  "comments": [
    {
      "commentId": "UgwW1S95-KHLW2bUI-14AaABAg",
      "content": "2017: People came to listen song.",
      "publishedTimeText": "1 year ago",
      "creatorHeart": false,
      "cursorReplies": "Eg0SC2tKUVA3a2l3NUZr...",
      "author": {
        "channelId": "UC9Hq2JZT1aKlG8nJqd7CB-A",
        "title": "Armaan singh",
        "isChannelOwner": false
      },
      "stats": {
        "replies": 496,
        "votes": 414947
      },
      "pinned": {
        "status": false,
        "text": null
      }
    }
  ],
  "cursorNext": "Eg0SC2tKUVA3a2l3NUZr...",
  "totalCommentsCount": 4202978
}