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

# get_telegram_channel

> A public Telegram channel's profile: title, description, subscriber count and picture. ₹0.20 per channel; a result that finds nothing is ₹0.

## What it does

The public profile of one Telegram channel from its username (without the @): data with the title, description, subscriber count and picture.

Use it to size a channel before reading it with [`get_telegram_channel_posts`](https://parel.si/docs/tools/get_telegram_channel_posts.md) or searching it with [`search_telegram_channel`](https://parel.si/docs/tools/search_telegram_channel.md); for a YouTube channel use [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md), for an Instagram account [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md). Flat price per call; an unknown or private channel answers nothing, which is free. Under two seconds.

India: any public channel.

## Inputs

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

| Field | Type | Required | Description |
|---|---|---|---|
| `channel` | string | yes | The channel's public username ("durov"), without the @. |

## What drives the cost

Flat per call; an unknown or private channel is free. A result that finds nothing is `class: "ok_free"`, ₹0. The timeout is 30 seconds.

## Price today

| | |
|---|---|
| Price today | **₹0.20** per channel (`cost_paise: 20`) at ₹93.93 per US dollar on 17 November 2026 |
| Hold before the call | ₹0.38 (`hold_paise: 38`); 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_telegram_channel"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "get_telegram_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_telegram_channel","input":{"channel":"durov"}}'
```

## What comes back

`data`, as the live check of 2026-11-05 recorded it, trimmed:

```json
{
  "username": "durov",
  "title": "Pavel Durov",
  "verified": true,
  "description": "Founder of Telegram.",
  "photo": "https://cdn4.telesco.pe/file/AM3EaKY4OWoCIpqIJGL2G4hcjBupbm4OuzSyAnEGF2gBOPJJIYOcnXbjDpqmilOWXXjheFFey4oGODL1BybYTdbTaJHo9qb3KEAIw9y3VvSrrKwoRdfBHWovcRqFmFEu5EeKeGrOZPTVcZEHBP6rbBp5qM4WbNdvEbGQLAnCPle0ArPYn70dJpY8D3zpJWbhZ2V1bnF2k0VXfyWUnok…",
  "subscribers": "10.1M",
  "counters": {
    "subscribers": "10.1M",
    "photos": "102",
    "videos": "47",
    "links": "200"
  }
}
```

## Notes

- Flat per call; an unknown or private channel is free.
- The subscriber count is Telegram's own figure at the time of the call.
- Pairs with get_telegram_channel_posts for the posts and search_telegram_channel for a keyword.

## Siblings

- [`get_telegram_channel_posts`](https://parel.si/docs/tools/get_telegram_channel_posts.md)
- [`search_telegram_channel`](https://parel.si/docs/tools/search_telegram_channel.md)
- [`get_youtube_channel`](https://parel.si/docs/tools/get_youtube_channel.md)
- [`get_instagram_profile`](https://parel.si/docs/tools/get_instagram_profile.md)
