Video Comments

Path Parameters

string

required

The YouTube video id (e.g. dQw4w9WgXcQ).

Query Parameters

string

default:"top"

Comment sort order.

Value	Description
`top`	Top comments (default)
`newest`	Newest first

string

Continuation token from a previous response to fetch the next page of comments.

Response

string

The video the comments belong to.

array

Array of top-level comments.

Show Comment object

string

Unique comment id.

string

Comment text (nullable).

string

Relative publish time, e.g. 2 weeks ago (nullable).

number

Unix publish timestamp (nullable).

string

Author display name (nullable).

string

Author channel id (nullable).

string

Author channel URL (nullable).

string

Author avatar URL (nullable).

boolean

Whether the author is verified (nullable).

boolean

Whether the author is an official artist (nullable).

boolean

Whether the author is the video’s uploader (nullable).

array

Author badges (e.g. member badges).

integer

Number of likes (nullable).

integer

Number of replies (nullable).

boolean

Whether the creator hearted the comment (nullable).

boolean

Whether the comment is pinned (nullable).

boolean

Whether the comment is a reply (nullable).

string

Parent comment id, if a reply (nullable).

string

Token to fetch this comment’s replies (nullable).

string

Super Thanks purchase amount, if any (nullable).

string

The video id the comment belongs to (nullable).

integer

Total comment count on the video (nullable).

array

Sort options with title and token (e.g. top, newest).

string

Token to fetch the next page (nullable when no more pages).

Example Response

{
  "video_id": "dQw4w9WgXcQ",
  "comments": [
    {
      "comment_id": "UgxKREWxIgDrw8w2e_Z4AaABAg",
      "text": "Who's still listening in 2026?",
      "published_time_text": "3 days ago",
      "author": "@musiclover",
      "author_channel_id": "UCabc123",
      "author_is_verified": false,
      "like_count": 1820,
      "reply_count": 42,
      "is_pinned": false,
      "is_reply": false,
      "replies_continuation": "Eg0SC2RRdzR3OVdnWGNR..."
    }
  ],
  "comment_count": 2400000,
  "sorting_tokens": [
    { "title": "Top comments", "token": "..." },
    { "title": "Newest first", "token": "..." }
  ],
  "continuation": "Eg0SC2RRdzR3OVdnWGNRGAYyJg..."
}

Replies

To fetch replies to a specific comment, call:

curl "https://scrapebadger.com/v1/youtube/videos/dQw4w9WgXcQ/comments/UgxKREWxIgDrw8w2e_Z4AaABAg/replies" \
  -H "X-API-Key: YOUR_API_KEY"

This returns a RepliesResponse with comment_id, a replies array (same Comment shape), and a continuation token. You can also pass the replies_continuation value from a comment directly as the continuation query parameter.

Each comments page and each replies page costs 5 credits. Failed requests are not charged.

Overview

Search & Discovery

Videos & Shorts

Channels

Playlists & Community

Path Parameters

Query Parameters

Response

Example Response

Replies

​Path Parameters

​Query Parameters

​Response

​Example Response

​Replies

Path Parameters

Query Parameters

Response

Example Response

Replies