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 urlparameter must be a valid YouTube video URL
- Comments are returned in the specified sort order (topornewest)
- The continuationTokenfrom the response can be used to fetch additional comments
- replyLevelindicates 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