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.
| 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
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
get_youtube_commentsfor what viewers said.search_webto find the video in the first place.
This page as Markdown: /docs/tools/get_youtube.md. Something wrong or missing: hello@parel.si.