get_youtube_comments

A page of comments on a YouTube video: text, author, likes, replies and date, top or newest first. ₹0.28 per page; a video with comments off is ₹0.

What it does

Comments on a YouTube video from its url, in data.comments[]: content, author, publishedTimeText and publishedTime, engagement (likes, replies) and replyLevel, with order "top" (default) or "newest" and data.continuationToken for the next page. Use it to read audience reaction; for the video's own numbers use get_youtube.

India: comments come back in whatever language they were written in.

Inputs

Generated from the contract captured from staging on 2026-11-05.

FieldTypeRequiredDescription
urlstringyesYouTube video URL. e.g. "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
orderstringnoOrder of comments. e.g. "top"

What drives the cost

Nothing: flat per page (about twenty comments). A video with comments disabled, or none yet, is class: "ok_free", ₹0.

Price today

Price today₹0.28 per page (cost_paise: 28) at ₹93.93 per US dollar on 17 November 2026
Hold before the call₹0.42 (hold_paise: 42); when the call settles the real price is charged and the unused part is released
₹0 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout30 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "get_youtube_comments"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_youtube_comments"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"get_youtube_comments","input":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ","order":"top"}}'

What comes back

data.comments[] and data.continuationToken. A real answer recorded during the live check of 2026-10-28 (people's names, profile links and ids replaced by fictional ones), trimmed to two comments:

{
  "success": true,
  "comments": [
    {
      "id": "UgwPwTibxdgqCHZxktd4AaABAg",
      "content": "My algebra teacher said that this was a link to the test answers",
      "publishedTimeText": "7 years ago",
      "publishedTime": "2019-10-28T11:25:10.989Z",
      "replyLevel": 0,
      "author": {
        "name": "@a_user_65",
        "channelId": "UCdi6tGxvFvTRGe-7dAn7m7w",
        "isVerified": false,
        "isCreator": false,
        "avatarUrl": "https://yt3.ggpht.com/ytc/AIdro_kcDoQJUNDkDzTrA5kaF5ADVujN-6UcDjMP2Kydtw=s88-c-k-c0x00ffffff-no-rj",
        "channelUrl": "https://youtube.com/@bdr8823"
      },
      "engagement": {
        "likes": 70000,
        "replies": 648
      },
      "repliesContinuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd3UHdUaWJ4ZGdxQ0haeGt0ZDRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3dQd1RpYnhkZ3FDSFp4a3RkNEFhQUJBZw%3D%3D"
    },
    {
      "id": "UgyEnXfdC-umwvTt8JF4AaABAg",
      "content": "Gonna flag this for nudity so I can rick roll the YouTube staff",
      "publishedTimeText": "6 years ago",
      "publishedTime": "2020-10-28T11:25:10.989Z",
      "replyLevel": 0,
      "author": {
        "name": "@a_user_66",
        "channelId": "UCWf34D_s8K_m2vwBISIDWtg",
        "isVerified": false,
        "isCreator": false,
        "avatarUrl": "https://yt3.ggpht.com/ghenbV7T5VMOA3iqp3PThC82exqcu7iVng_iWNx1Ujak72Ti4oZZ_XzSVzIrfk9arP1XrFtnZA=s88-c-k-c0x00ffffff-no-rj",
        "channelUrl": "https://youtube.com/@Oatman69"
      },
      "engagement": {
        "likes": 569000,
        "replies": 722
      },
      "repliesContinuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIaVWd5RW5YZmRDLXVtd3ZUdDhKRjRBYUFCQWciAggAKhhVQ3VBWEZrZ3N3MUw3eGFDZm5kNUpKT3cyC2RRdzR3OVdnWGNRQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3lFblhmZEMtdW13dlR0OEpGNEFhQUJBZw%3D%3D"
    },
    "… 18 more item(s) truncated"
  ],
  "continuationToken": "Eg0SC2RRdzR3OVdnWGNRGAYy_gIK1AJnZXRfcmFua2VkX3N0cmVhbXMtLUNxWUJDSUFFRlJlMzBUZ2Ftd0VLbGdFSTJGOFFnQVFZQnlLTEFadmdQUlZ2SlJlNExGSE1oRXRfX2dhU3BVUVJvSEdJdGNvbVJ3RE1PUUVlaE43bTg1MS0ybmRkTnEwdU9RekxFTWN4bUNBZVN1VktuRXM3b2V6UUhySVFYbDNISFlJVUdpc3RVcmt0TjloaXV6YUFfb0F3YWdRMlFqQzZCRk5YVEFnNTFoaXgtRWptTkZHR0lUR2hvRm9oZkFiMkpULUhtWXM3X1JUUS0tYnNYakxLNzBLNXkzRS1xQUlRRkJJ…"
}

Notes

  • One page of comments per call.
  • Comments disabled or none yet: empty, free.

Siblings

This page as Markdown: /docs/tools/get_youtube_comments.md. Something wrong or missing: hello@parel.si.