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

# get_youtube

> One YouTube video or Short: title, channel, views, likes, comments, duration, chapters, caption tracks. ₹0.28 per video.

## What it does

One YouTube video or Short from its `url` (watch, youtu.be and Shorts URLs all work): `title`, `description`, `channel` (`id`, `handle`, `title`, `url`), `viewCountInt`, `likeCountInt`, `commentCountInt`, `publishDate`, `durationMs`, `chapters[]`, `keywords[]`, `captionTracks[]` (the languages available, not the transcript), `isPaidPromotion` and more, in `data`. Use it to size up a video or a creator's reach; for the comments use [`get_youtube_comments`](https://parel.si/docs/tools/get_youtube_comments.md). It does not search YouTube and does not download media.

India: any public video; Hindi and regional caption tracks appear when the uploader provided them.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `url` | string | yes | YouTube video or short URL. e.g. "https://www.youtube.com/watch?v=dQw4w9WgXcQ" |

## What drives the cost

Nothing: flat per call.

## Price today

| | |
|---|---|
| Price today | **₹0.28** per video (`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"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_youtube"` |
| 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","input":{"url":"https://www.youtube.com/watch?v=dQw4w9WgXcQ"}}'
```

## What comes back

`data`, the video object. A real answer recorded during the live check of 2026-10-28, trimmed (long text cut, lists to two items):

```json
{
  "success": true,
  "type": "video",
  "id": "dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick’s ‘Never’ playlist ❤️ #RickAstleyNever\nhttps://linktr.ee/rickastleynever\n\n“Never Gonna Give You Up” was a global smash on its release in July 1987, topping the charts in 25 countries including Rick’s na…",
  "descriptionLinks": [
    "https://www.youtube.com/hashtag/rickastleynever",
    "https://linktr.ee/rickastleynever",
    "… 14 more item(s) truncated"
  ],
  "commentCountText": "2.4M",
  "commentCountInt": 2400000,
  "likeCountText": "19491626",
  "likeCountInt": 19491626,
  "viewCountText": "1,831,253,026",
  "viewCountInt": 1831253026,
  "publishDateText": "Oct 24, 2009",
  "collaborators": [],
  "channel": {
    "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "url": "https://www.youtube.com/@RickAstleyYT",
    "handle": "RickAstleyYT",
    "title": "Rick Astley",
    "thumbnail": "https://yt3.ggpht.com/_ShEGOdg-t5YGJse14Ooq6FYBZqX_QSlhaTNjG06miYusm5lWm1UroLyVxnYtahADfRTVLtuVQ=s48-c-k-c0x00ffffff-no-rj"
  },
  "chapters": [],
  "watchNextVideos": [
    {
      "id": "tuCAyK1Elgo",
      "title": "🍂 Warm Autumn Jazz (NO MID-ROLL ADS) – Cozy Piano Music for Golden Fall Days",
      "thumbnail": "https://i.ytimg.com/vi/tuCAyK1Elgo/hqdefault.jpg",
      "channel": {
        "title": "Chill Jazz Station",
        "url": "https://www.youtube.com/channel/UCa8uIf1mePRF34SyGPejoAg",
        "handle": "channel/UCa8uIf1mePRF34SyGPejoAg",
        "id": "UCa8uIf1mePRF34SyGPejoAg"
      },
      "publishedTimeText": "2mo ago",
      "publishedTime": null,
      "publishDateText": "2mo ago",
      "publishDate": null,
      "viewCountText": "110K",
      "viewCountInt": 110000,
      "lengthText": "6:09:09",
      "lengthInSeconds": 22149,
      "videoUrl": "https://www.youtube.com/watch?v=tuCAyK1Elgo"
    },
    {
      "id": "aYLd9LRLHSg",
      "title": "Dance Through the Ultimate 80s Flashback Hits – Michael Jackson, Madonna, Lionel Richie, Toto",
      "thumbnail": "https://i.ytimg.com/vi/aYLd9LRLHSg/hqdefault.jpg",
      "channel": {
        "title": "LA LA DISCO",
        "url": "https://www.youtube.com/@LALADISCOMUSIC",
        "handle": "LALADISCOMUSIC",
        "id": "UCWfsY5Czam2cR-rZR-Uq-Bg"
      },
      "publishedTimeText": "5mo ago",
      "publishedTime": null,
      "publishDateText": "5mo ago",
      "publishDate": null,
      "viewCountText": "766K",
      "viewCountInt": 766000,
      "lengthText": "2:35:04",
      "lengthInSeconds": 9304,
      "videoUrl": "https://www.youtube.com/watch?v=aYLd9LRLHSg"
    },
    "… 10 more item(s) truncated"
  ],
  "thumbnail": "https://img.youtube.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
  "publishDate": "2009-10-24T23:57:33-07:00",
  "keywords": [
    "rick astley",
    "Never Gonna Give You Up",
    "… 25 more item(s) truncated"
  ],
  "genre": "Music",
  "durationMs": 214000,
  "durationFormatted": "00:03:34",
  "captionTracks": [
    {
      "baseUrl": "https://www.youtube.com/api/timedtext",
      "name": {
        "simpleText": "English"
      },
      "vssId": ".en",
      "languageCode": "en",
      "isTranslatable": true,
      "trackName": ""
    },
    {
      "baseUrl": "https://www.youtube.com/api/timedtext",
      "name": {
        "simpleText": "English (auto-generated)"
      },
      "vssId": "a.en",
      "languageCode": "en",
      "kind": "asr",
      "isTranslatable": true,
      "trackName": ""
    },
    "… 4 more item(s) truncated"
  ],
  "audioTracks": [],
  "downloadOptions": {
    "expiresInSeconds": "21540",
    "hlsManifestUrl": null,
    "dashManifestUrl": null,
    "formats": [
      {
        "itag": 18,
        "url": null,
        "cdnUrl": "https://rr3---sn-5uaeznss.googlevideo.com/videoplayback?expire=1793208308&ei=lNvhaqaxFfKFut0Pv62HkQc&ip=172.0.243.149&id=o-AIpxWIDed-2QHmcfXa8FfbRonVpaZRnxsOYm2YWgizs_&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1793186708%2C&mh=7c&mm=18%2C29&mn=sn-5uaeznss%2Csn-5uaeznly&ms=aub%2Crdu&mv=m&mvi=3&pl=20&rms=aub%2Caub&initcwndbps=1311625&bui=A…",
        "expiresAt": "2026-10-28T17:25:08.000Z",
        "mimeType": "video/mp4; codecs=\"avc1.42001E, mp4a.40.2\"",
        "codecs": "avc1.42001E, mp4a.40.2",
        "bitrate": 444226,
        "width": 640,
        "height": 360,
        "quality": "medium",
        "qualityLabel": "360p",
        "fps": 25,
        "audioQuality": "AUDIO_QUALITY_LOW",
        "audioSampleRate": "44100",
        "audioChannels": 2,
        "approxDurationMs": "213089",
        "projectionType": "RECTANGULAR",
        "hasVideo": true,
        "hasAudio": true,
        "requiresSignatureDecipher": true,
        "signatureCipher": {
          "url": "https://rr3---sn-5uaeznss.googlevideo.com/videoplayback?expire=1793208308&ei=lNvhaqaxFfKFut0Pv62HkQc&ip=172.0.243.149&id=o-AIpxWIDed-2QHmcfXa8FfbRonVpaZRnxsOYm2YWgizs_&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1793186708%2C&mh=7c&mm=18%2C29&mn=sn-5uaeznss%2Csn-5uaeznly&ms=aub%2Crdu&mv=m&mvi=3&pl=20&rms=aub%2Caub&initcwndbps=1311625&bui=A…",
          "signature": "AEAE0s2JYwRAIgUphSUqWnWg4bM6HnliMvXEvMj6Surad4xrOR0zlJvjMCIEShFwHT-jJ5B2MUByPibqBoSHpKsokcFigsuGIf4eUjeUCUC",
          "signatureParameter": "sig",
          "expiresAt": "2026-10-28T17:25:08.000Z"
        }
      }
    ],
    "note": "These are YouTube's muxed audio+video formats when exposed. Links can expire, and some videos may only expose signature-ciphered URLs."
  },
  "most_replayed": {
    "markers": [
      {
        "startMillis": 0,
        "durationMillis": 2140,
        "intensityScoreNormalized": 1
      },
      {
        "startMillis": 2140,
        "durationMillis": 2140,
        "intensityScoreNormalized": 0.4230315549340408
      },
      "… 98 more item(s) truncated"
    ],
    "ranges": [
      {
        "visibleTimeRangeStartMillis": 0,
        "visibleTimeRangeEndMillis": 6420,
        "decorationTimeMillis": 2140,
        "label": "Most replayed"
      }
    ]
  },
  "isPaidPromotion": false,
  "descriptionCards": [
    {
      "section": "Music",
      "title": "Never Gonna Give You Up (7\" Mix)",
      "subtitle": "Rick Astley",
      "secondarySubtitle": "Whenever You Need Somebody",
      "image": "https://yt3.googleusercontent.com/eC9DfRcYSk4FE-fvDCJSu_4xsKdVMKxwmFTYFZwP8OqB7R4TKxAjKoR-Kp1lXeRi2WddPFYulSte4eW-",
      "videoId": null,
      "channelId": null,
      "playlistId": null,
      "musicCredits": {
        "song": "Never Gonna Give You Up (7\" Mix)",
        "artist": "Rick Astley",
        "album": "Whenever You Need Somebody",
        "writers": "Pete Waterman, Mike Stock, Matt Aitken",
        "licensedToYouTubeBy": null,
        "rawText": "Song: Never Gonna Give You Up (7\" Mix)\n\nArtist: Rick Astley\n\nAlbum: Whenever You Need Somebody\n\nWriters: Pete Waterman, Mike Stock, Matt Aitken"
      }
    }
  ],
  "isMadeWithAI": false,
  "aiDisclosure": null,
  "ownerByline": {
    "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "name": "Rick Astley",
    "url": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
    "subscriberCountText": "4.55M subscribers",
    "badges": [
      {
        "style": "BADGE_STYLE_TYPE_VERIFIED_ARTIST",
        "label": "Official Artist Channel"
      }
    ]
  },
  "uploader": {
    "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
    "author": "Rick Astley",
    "url": "http://www.youtube.com/@RickAstleyYT"
  }
}
```

## Notes

- Accepts watch, youtu.be and Shorts URLs.
- Captions are listed as tracks; the transcript text is not included.

## Siblings

- [`get_youtube_comments`](https://parel.si/docs/tools/get_youtube_comments.md) for what viewers said.
- [`search_web`](https://parel.si/docs/tools/search_web.md) to find the video in the first place.
