Video Comments

Path Parameters

video_id

string

required

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

Query Parameters

sort_by

string

default:"top"

Comment sort order.

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

continuation

string

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

Response

video_id

string

The video the comments belong to.

comments

array

Array of top-level comments.

Show Comment object

comment_id

string

Unique comment id.

text

string

Comment text (nullable).

published_time_text

string

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

published_utc

number

Unix publish timestamp (nullable).

author

string

Author display name (nullable).

author_channel_id

string

Author channel id (nullable).

author_channel_url

string

Author channel URL (nullable).

author_thumbnail

string

Author avatar URL (nullable).

author_is_verified

boolean

Whether the author is verified (nullable).

author_is_artist

boolean

Whether the author is an official artist (nullable).

author_is_channel_owner

boolean

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

author_badges

array

Author badges (e.g. member badges).

like_count

integer

Number of likes (nullable).

reply_count

integer

Number of replies (nullable).

has_creator_heart

boolean

Whether the creator hearted the comment (nullable).

is_pinned

boolean

Whether the comment is pinned (nullable).

is_reply

boolean

Whether the comment is a reply (nullable).

reply_to_cid

string

Parent comment id, if a reply (nullable).

replies_continuation

string

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

paid_comment_amount

string

Super Thanks purchase amount, if any (nullable).

video_id

string

The video id the comment belongs to (nullable).

comment_count

integer

Total comment count on the video (nullable).

sorting_tokens

array

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

continuation

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