get_youtube_channel
A YouTube channel: name, subscribers, total views, video count, description, links, country, verification. ₹0.28 per channel; a channel that does not exist is ₹0.
What it does
A YouTube channel from its handle (with the @), channelId or url, as one object in data: name, handle, description, subscriberCount, viewCount, videoCount, joinedDateText, country, isVerified, avatar, banner, the business email where the channel shows one, and its links (website, instagram, twitter, facebook). Use it to size a creator before a collaboration; for their videos search_youtube, for one video get_youtube.
India: any channel; country is what the creator declares.
Inputs
Generated from the contract captured from staging on 2026-11-05. This tool declares one-of sets: handle, channelId or url must be present, or it is invalid_input for ₹0.
| Field | Type | Required | Description |
|---|---|---|---|
url | string | one of | YouTube channel URL. Can pass a channelId, handle or url |
handle | string | one of | YouTube channel handle. Can pass a channelId, handle or url |
channelId | string | one of | YouTube channel ID. Can pass a channelId, handle or url. e.g. "UC-9-kyTW8ZkZNDHQJ6FgpwQ" |
One of these sets must be complete (anything else is invalid_input, ₹0): handle; channelId; url.
What drives the cost
Nothing: flat per channel. A missing channel is class: "ok_free", ₹0.
Price today
| Price today | ₹0.28 per channel (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_channel" |
| Over REST | POST https://api.parel.si/v1/run with "tool": "get_youtube_channel" |
| 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_channel","input":{"handle":"@TechnicalGuruji"}}'
What comes back
data, the channel object. A real answer recorded during the live check of 2026-10-28, trimmed, with the business email replaced:
{
"success": true,
"channelId": "UCOhHO2ICt0ti9KAh-QHvttQ",
"channel": "http://www.youtube.com/@TechnicalGuruji",
"handle": "@TechnicalGuruji",
"isVerified": true,
"name": "Technical Guruji",
"description": "नमस्कार दोस्तों, आपका बहुत बहुत स्वागत है हमारे चैनल \"Technical Guruji\" में, मैंने यह चैनल मेरे उन सभी दोस्तों के लिए बनाया है जो टेक्नोलॉजी के बारे में अपनी भाषा में जानना चाहते है, \"Technical Guruji\" चैनल में आपको रोज़ाना एक नयी वीडियो मिलेगी जहा मैं कोशिश करूँगा आपको मोबाइल और कंप्यूटर की दुनिया के बारे में कुछ जरुरी बातें बताने की| \nHello friends, Welcome…",
"subscriberCount": 23700000,
"subscriberCountText": "23.7M subscribers",
"videoCountText": "6,390 videos",
"videoCount": 6390,
"viewCountText": "4,119,816,100 views",
"viewCount": 4119816100,
"joinedDateText": "Joined Oct 18, 2015",
"tags": "Hindi Technology, Technology in Hindi, Hindi Tech Guru, Technical Guruji, Hindi Tech Tips, Tech Reviews, Mobile Tips and Tricks, Technology Explained, Hindi Tech, Hindi Tech Reviews, Tech Hindi, hindi, Technology, Mobile, tech, Reviews, TechnicalGuruji, Gaurav Chaudhary, Smartphones, Mobile Phones, Tech, latest Tech, Cool Technology, Tech News, Latest Tech N…",
"email": "name@example.com",
"country": "India",
"subscribe_here!!!": "https://youtube.com/c/TechnicalGuruji",
"twitter": "https://twitter.com/technicalguruji",
"facebook": "https://facebook.com/technicalguruji",
"instagram": "https://instagram.com/technicalguruji",
"website": "https://technicalguruji.in",
"google_plus": "https://plus.google.com/ TechnicalGuruji",
"links": [
"https://youtube.com/c/TechnicalGuruji",
"https://twitter.com/technicalguruji",
"… 4 more item(s) truncated"
],
"keywords": [
"Hindi Technology",
"Technology in Hindi",
"… 23 more item(s) truncated"
],
"isFamilySafe": true,
"facebookProfileId": "technicalguruji",
"avatar": {
"image": {
"sources": [
{
"url": "https://yt3.googleusercontent.com/ytc/AIdro_nQFOjj2baePBWQGqL0lgv7SwxZ1uXYo8pg_hViDZb6DEsX=s68-c-k-c0x00ffffff-no-rj",
"width": 68,
"height": 68
}
]
},
"avatarImageSize": "AVATAR_SIZE_M"
},
"banner": [
{
"url": "https://yt3.googleusercontent.com/rSBadrrtmz7SMFQeIAn0o5xMQ9quThNcKDxPUp2Vs4qBi55O0egEkf3ukTVbaNxDRhp6VKEBDQ=w1060-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
"width": 1060,
"height": 175
},
{
"url": "https://yt3.googleusercontent.com/rSBadrrtmz7SMFQeIAn0o5xMQ9quThNcKDxPUp2Vs4qBi55O0egEkf3ukTVbaNxDRhp6VKEBDQ=w1138-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj",
"width": 1138,
"height": 188
},
"… 4 more item(s) truncated"
]
}
Notes
- One of handle, channelId or url. The handle keeps the @.
- A missing channel is free. Usually one to three seconds.
Siblings
get_instagram_profilefor the same creator on Instagram.search_youtubefor their videos.
This page as Markdown: /docs/tools/get_youtube_channel.md. Something wrong or missing: hello@parel.si.