Skip to main content
POST
/
v1
/
video
/
comments
Extract structured comments from a YouTube video
curl --request POST \
  --url https://api.stophy.dev/v1/video/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videoUrl": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}
'
{
  "comments": [
    {
      "id": "<string>",
      "content": "<string>",
      "publishDate": "<string>",
      "likeCount": 123,
      "isPinned": false,
      "isAuthorChannelOwner": false,
      "replyCount": 123,
      "url": "<string>",
      "author": {
        "id": "<string>",
        "name": "<string>",
        "handle": "<string>",
        "thumbnails": {
          "best": "<string>",
          "min": "<string>"
        }
      }
    }
  ],
  "filters": {
    "sortBy": "<string>"
  },
  "pagination": {
    "continuationTokenUsed": null,
    "nextContinuationToken": "<string>"
  }
}
Use this endpoint to extract structured comments from a YouTube video, with support for sorting and pagination. Designed for AI agents, the response is clean, predictable, and ready for downstream tasks like sentiment analysis, clustering, or trend detection.

Authorizations

Authorization
string
header
required

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

Body

application/json
videoUrl
string
required
Example:

"https://www.youtube.com/watch?v=dQw4w9WgXcQ"

continuationToken
string
sortBy
enum<string>
Available options:
top,
newest

Response

comments
object[] | null
filters
object
pagination
object