Video Comments

GET/v1/youtube/video/comments1 credit

Returns a video's top-level comments with author, text, publish time, like and reply counts.

01Query parameters

Name	Type	Description
urlrequired	string	YouTube video URL: a watch, youtu.be, Shorts, live or embed link.
continuationTokenoptional	string	The `continuationToken` from the previous page.
orderoptional	string	Sort order.Default: `top`Accepted values:`topnewest`

02Request

curl "https://api.scrapesocial.ai/v1/youtube/video/comments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
  -H "x-api-key: $SCRAPESOCIAL_KEY"

03Responses

Real answers from the API. Lists are shortened to 2 items.

GET /v1/youtube/video/comments?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 1,
  "comments": [
    {
      "id": "UgzKYksqeQ5gA3t0g0F4AaABAg",
      "content": "I Rick rolled my entire French class because we had to study a city in France and make a quiz about it as well as a presentation, I decided to make a Kahoot quiz because it’s very easy. I put a link in to this saying it’s the kahoot link. The teacher needless to say got very very mad. As well as my classmates asking who rick rolls in 2019",
      "publishedTimeText": "6 years ago (edited)",
      "publishedTime": "2020-10-25T17:07:00.812Z",
      "replyLevel": 0,
      "author": {
        "name": "@grustache4569",
        "channelId": "UCKrzgYonJnMd0Dk7zQXjYXw",
        "isVerified": false,
        "isCreator": false,
        "avatarUrl": "https://yt3.ggpht.com/ytc/AIdro_kDD-FhIbth2qcBbI9VGxR41dJa0kE3kN9iVlGzNgRU_g=s88-c-k-c0x00ffffff-no-rj",
        "channelUrl": "https://youtube.com/@grustache4569"
      },
      "engagement": {
        "likes": 105000,
        "replies": 641
      },
      "repliesContinuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd6S1lrc3FlUTVnQTN0MGcwRjRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pLWWtzcWVRNWdBM3QwZzBGNEFhQUJBZw%3D%3D"
    },
    {
      "id": "UgwxEqSh_78DU_MOKpt4AaABAg",
      "content": "Never thought the video was taken down, not even for a second. I just wanted to hear my boy Rick Astley again.",
      "publishedTimeText": "2 months ago",
      "publishedTime": "2026-08-25T17:07:00.812Z",
      "replyLevel": 0,
      "author": {
        "name": "@Hushoo",
        "channelId": "UCTfgDEMJhUnGz24yinDMenQ",
        "isVerified": false,
        "isCreator": false,
        "avatarUrl": "https://yt3.ggpht.com/P9RPosH04c98bezAE4mu4YdgOHEtBOnDTfrrP1jWMyor_75pjbDedjPhrnos2JrFS3cSsCcv=s88-c-k-c0x00ffffff-no-rj",
        "channelUrl": "https://youtube.com/@Hushoo"
      },
      "engagement": {
        "likes": 8800,
        "replies": 57
      },
      "repliesContinuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd3eEVxU2hfNzhEVV9NT0twdDRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3d4RXFTaF83OERVX01PS3B0NEFhQUJBZw%3D%3D"
    }
  ],
  "continuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYylQMK2AJnZXRfcmFua2VkX3N0cmVhbXMtLUNxY0JDSUFFRlJlMzBUZ2FuQUVLbHdFSTJGOFFnQVFZQnlLTUFac1FjdzNlU3NZcFhYMmhfX1pZVVprRXBJTVVLQUlxdEVwV1JBQmpleTZ0WTRoUDhxRHFTcmQ1VE9HRlhzNVJpSmdSakUyaEtoY3RaTzU2My00cEM4cnNNT0tXWW94WE9NU2lSTkNQY3lrc3RyQURWUFFiZFJNaXNCSDBJekNXRU1vX1p5Vm1wbERIaE9sWHVFN0lxTHBYdjlBRmU5ZHh2UkNXOFF6bHFnalFqMVJzTDRLZkQ0OUc0R0lBRUJRU0J3aUVJQkFQR0FFU0J3aUpJQkFCR0FBU0JRaW9J…"
}

Common to every endpoint

Any route can answer these: a missing or wrong key, no credits left, the platform not answering, or a failure on our side. None of them costs credits.

GET /v1/cosmos/profile?handle=design

{
  "success": false,
  "message": "Invalid API key"
}

04Notes

20 comments per page. Pass `continuationToken` back for the next page; it is null on the last page. A comment with replies has a `repliesContinuationToken` for the Comment Replies endpoint. A video with comments turned off returns an empty `comments` list for 0 credits; an unknown video answers 404.

05Errors & credits

Every error has success: false, a real HTTP status and costs no credits.

400missing_parameter
A required parameter is missing or invalid.
403private_account
The account is private or age-restricted.
404not_found
No such account.
503upstream_error
The platform did not answer; retry shortly.