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. 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.

FieldTypeRequiredDescription
urlstringyesYouTube 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 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"
Over RESTPOST https://api.parel.si/v1/run with "tool": "get_youtube"
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","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):

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

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