Get comment threads

GET

commentThreads

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

videoId

string

The YouTube video ID to get comment threads for. This is a unique 11-character string.

Required string length: 11

channelId

string

The YouTube channel ID to get comment threads for. This is a unique 24-character string.

Required string length: 24

commentIds

string

The list of comment IDs to get threads for. Use this to retrieve replies to a comments.

pageToken

string

The page token to retrieve the next page of comment threads. This token is provided in the nextPageToken field of the previous response.

searchTerm

string

A search term to filter comment threads. Only threads containing this term will be returned.

order

enum<string>

The order to sort comment threads by. "time" sorts by newest first, "relevance" sorts by most relevant first.

Available options:

time,

relevance

format

enum<string>

default: html

The format to return comments in. "html" includes HTML formatting, "plainText" returns unformatted text.

Available options:

html,

plainText

Response

200 - application/json

data

object[]

required

Array of comment thread objects

data.id

string

required

Unique identifier for the comment thread

data.channelId

string

required

ID of the channel the comment thread is associated with

data.videoId

string

required

ID of the video the comment thread is associated with

data.textDisplay

string

required

The comment's text with HTML formatting

data.textOriginal

string

required

The comment's original text without formatting

data.authorDisplayName

string

required

Display name of the comment author

data.authorProfileImageUrl

string

required

URL of the author's profile image

data.authorChannelUrl

string

required

URL of the author's YouTube channel

data.authorChannelId

object

required

data.canRate

boolean

required

Whether the authenticated user can rate this comment

data.viewerRating

string

required

The rating given by the authenticated user, if any

data.likeCount

number

required

Number of likes for this comment

data.publishedAt

string

required

The date and time when this comment was published

data.updatedAt

string

required

The date and time when this comment was last updated

data.totalReplyCount

number

required

Total number of replies to this comment

data.replies

object[]

Array of reply objects, if any

nextPageToken

string

Token to retrieve the next page of results, if available

Get video captions Get comment replies

API Documentation

Search

Batch

Details

General

Files

Authorizations

Query Parameters

Response