Skip to main content
POST
List YouTube video comments

Description

This endpoint retrieves comments from a YouTube video with support for pagination and different sorting orders. Includes comment content, author information, engagement metrics, and timestamps.

Endpoint

Headers

  • Content-Type: application/json
  • Authorization: Bearer <API_KEY> (required)

Request Body

Accepted Values for order

Responses

Success (200)

Returns an array of comments from the specified video with pagination support.
  • Content-Type: application/json
  • X-RateLimit-Limit: The rate limit for the user
  • X-RateLimit-Remaining: The remaining number of requests for the user

Bad Request (400)

Returned if the request is invalid or missing required parameters.

Bad Gateway (502)

Returned if the external service is unavailable or returns invalid data.

Internal Server Error (500)

Returned if there’s an unexpected server error.

Example Request

Example Response

Notes

  • The url parameter must be a valid YouTube video URL
  • Comments are returned in the specified sort order (top or newest)
  • The continuationToken from the response can be used to fetch additional comments
  • replyLevel indicates the nesting level of the comment (0 = top-level comment)
  • Author information includes verification status and creator badges
  • Engagement metrics show like count and reply count for each comment
  • Some videos may have comments disabled, resulting in an empty comments array
  • This endpoint uses 10 credits per request

Rate Limiting

Rate limit headers (X-RateLimit-Limit and X-RateLimit-Remaining) are included in the response to indicate the user’s current rate limit status.

Authorizations

Authorization
string
header
required

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

Body

application/json
url
string<uri>
required
continuationToken
string

Token to fetch the next page of comments.

order
enum<string>
default:top
Available options:
top,
newest
requestSource
enum<string>

Optional identifier describing where the API request originated.

Available options:
API,
WEB,
MAKE_DOT_COM,
ZAPIER,
N8N,
PLAYGROUND,
DEFAULT_AUTOMATION,
AGENT_PREVIEW,
AGENT_LIVE,
AUTOPILOT,
STUDIO

Response

Comments retrieved.

comments
object[]
continuationToken
string | null