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
Value | Description |
---|---|
top | Sort by most liked comments first |
newest | Sort by most recently posted comments |
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
ornewest
) - 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 1 credit 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
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Token to fetch the next page of comments.
Available options:
top
, newest
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