> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/get_youtube_comments

# 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`](https://parel.si/docs/tools/get_youtube.md).

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

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `url` | string | yes | YouTube video URL. e.g. "https://www.youtube.com/watch?v=dQw4w9WgXcQ" |
| `order` | string | no | Order 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 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 30 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "get_youtube_comments"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_youtube_comments"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
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:

```json
{
  "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

- [`get_youtube`](https://parel.si/docs/tools/get_youtube.md) for the video.
- [`get_reddit`](https://parel.si/docs/tools/get_reddit.md) for the same conversation on Reddit.
