Skip to main content
GET
/
v1
/
scrape
/
youtube
/
video
/
comments
Comments
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/youtube/video/comments \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "success": true,
    "comments": {
      "0": {
        "id": "Ugz02PQAsHBQfJ_PIxR4AaABAg",
        "content": "Beste!",
        "publishedTimeText": "3 months ago",
        "publishedTime": "2025-11-08T23:18:52.207Z",
        "replyLevel": 0,
        "author": {
          "name": "@non-speakingandfabulouswit6095",
          "channelId": "UCvFT6_Z1fpHOmj6T-vxHTdg",
          "isVerified": false,
          "isCreator": false,
          "avatarUrl": "https://yt3.ggpht.com/krdXzb3IB_M33rRAZ0PqcjLV0pXVQdxUQtjbUHQsRvrQPIImi3IP0zcQeFFrHOJrlaR75y-kOA=s88-c-k-c0x00ffffff-no-rj",
          "channelUrl": "https://youtube.com/@non-speakingandfabulouswit6095"
        },
        "engagement": {
          "likes": 3,
          "replies": 0
        }
      }
    },
    "continuationToken": "Eg0SCzRPbUlfY0xZVEpRGAYy2QIKrwJnZXRfcmFua2VkX3N0cmVhbXMtLUNxVUJDSUFFRlJlMzBUZ2FtZ0VLbFFFSTJGOFFnQVFZQnlLS0FYdVk0SUtpdVJxMHlobENQaEpmdGg2VHdWcFFuMG1qTl9GS1RGSk4xdEJXX3ltZ3BRcUpOWHR0ZUNTejBETkpORHpLdFNqX1UxMUxXTWViYTZlVXlWdk5FbGNRckFZeFZnbF9XbDdfUlZsa1dHZHFHQ0laWGhsaW1FSDRnVERxVVJvVWVndk5WTEF5VHBsZklGSl9RT0lLUjFaaDBmYjZEcE5uWGdnVmxSNWRLZEdUaXkyMlFYclJmQkFVRWdVSWlTQVlBQklGQ0tnZ0dBQVNCUWlJSUJnQUVnVUloeUFZQUJJSENJVWdFQlFZQVJJRkNMc2dHQUEiESILNE9tSV9jTFlUSlEwAHgBKBRCEGNvbW1lbnRzLXNlY3Rpb24%3D"
  },
  "credits_used": 1,
  "endpoint": "youtube/video/comments"
}

Documentation Index

Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt

Use this file to discover all available pages before exploring further.

💳 1 credit per request — returns ~20 comments per page. Use continuationToken to paginate.

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

​
url
string
required

YouTube video URL

Example:

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

​
continuationToken
string

Continuation token to get more comments. Get 'continuationToken' from previous response.

Example:

"4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB"

​
order
enum<string>

Order of comments

Available options:
top,
newest
Example:

"top"

Response

Successful response

Key Response Fields:

  • data.comments[0].id: Unique comment ID
  • data.comments[0].content: Comment text content
  • data.comments[0].publishedTime: ISO timestamp of when the comment was posted
  • data.comments[0].author.name: Commenter's channel name
  • data.comments[0].author.channelId: Commenter's YouTube channel ID
  • data.comments[0].author.avatarUrl: Commenter's avatar image URL
  • data.comments[0].author.isVerified: Whether the commenter is a verified account
  • data.comments[0].engagement.likes: Number of likes on the comment
  • data.comments[0].engagement.replies: Number of replies to the comment
  • data.continuationToken: Pagination cursor — pass as continuationToken to get the next page