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

# 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`](https://parel.si/docs/tools/search_youtube.md), for one video [`get_youtube`](https://parel.si/docs/tools/get_youtube.md).

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

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

```json
{
  "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_profile`](https://parel.si/docs/tools/get_instagram_profile.md) for the same creator on Instagram.
- [`search_youtube`](https://parel.si/docs/tools/search_youtube.md) for their videos.
