# Telegram Channel API. Send a handle or channel link. Subscribers, bio and links of channels and groups. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtelegram.channel) ## Telegram Channel API at a glance Returns a public Telegram channel, group, user or bot from its username or link, with its subscriber or member count, name, bio and photo. It also has the links in its bio, verified badge, members online in a group, a bot's monthly users, and which kind of account it is. A channel also has its creation date, numeric ID, and how many photos, videos, links and files it has posted. GET `/v1/telegram/channel` [Read the API reference](https://socialtap.dev/docs/reference/telegram/channel/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **19 typed fields** null when unknown - **`handle`** is all it needs, e.g. `durov` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 19 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `handle = durov` [Open in playground](https://socialtap.dev/playground/?endpoint=telegram.channel) cURL: ```shell curl 'https://socialtap.dev/v1/telegram/channel?handle=durov' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.telegram.channel.get({ handle: "durov" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ handle: "durov", }); const res = await fetch(`https://socialtap.dev/v1/telegram/channel?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/telegram/channel", params={"handle": "durov"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("handle", "durov") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/telegram/channel?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "approximate_fields": [], "avatar_url": "https://cdn4.telesco.pe/file/j6dxnmHRzV_4Tn0IpvsZNLgcbbdsGKZp99CxelC0VTSrxrYs-jbwXpAV5gNt8MxD5Cy9LTEM5_avh9_j_6plyq2J41XnT8fJYBI8kx7r0gHGj42RyZwJUqjd4Ikyv0qB5zFDfcIYAzokGoFuE7WTQ5Lbkfnx7HOZL-Sw5bHEMXPCQToujfyCuku9LCwiunkhLNdZ63DiBhJjl2ucypG5ki66yS0ltfdAzEQEdZoi9jEgpnGVzxHvCfkG5oX…", "banner_url": null, "bio": "Founder of Telegram.", "category": null, "country_code": null, "created_at": "2015-10-28T18:20:58Z", "display_name": "Pavel Durov", "external_links": [], "id": "durov", "is_private": false, "is_verified": true, "location": null, "metrics": { "follower_count": 10127043, "following_count": null, "post_count": null, "total_like_count": null, "total_view_count": null }, "platform": "telegram", "platform_specific": { "telegram": { "account_type": "channel", "channel_id": "1006503122", "file_count": null, "is_preview_available": true, "link_count": 200, "monthly_user_count": null, "online_count": null, "photo_count": 102, "video_count": 47 } }, "type": "unknown", "unknown_fields": [], "url": "https://t.me/durov", "username": "durov" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "telegram", "source": "page", "is_cached": false, "credits_charged": 1, "latency_ms": 701, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "profile", "id": "durov", "url": "https://t.me/durov" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 27 platforms. The [response reference](https://socialtap.dev/docs/reference/telegram/channel/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/profile/index.md). - ### Null means unknown A field Telegram doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The Telegram channel, group, user or bot: its username with or without the @, or any link to it (t.me/durov, t.me/s/durov, telegram.me/durov, durov.t.me). - ### Write one parser Telegram, TikTok, Instagram and 24 more platforms answer in these fields, so the code that reads one reads them all. - **`platform`string**: Platform ID (tiktok, youtube, …). - **`id`string**: Platform-native account ID (string; YouTube UC…, Reddit t2_…). - **`username`string**: Handle without the @; null when the account has none. - **`display_name`string**: Display name, channel title or page name; null when empty or not exposed. - **`url`string**: Canonical profile URL. - **`type`string**: Coarse account kind, as the platform labels it; unknown when it does not (TikTok labels organizations only). New values may be added; treat unknown values as unknown. - **`bio`string**: Profile bio, channel description or page about text; null when empty or not exposed. - **`avatar_url`string**: Profile picture URL (largest available). Platform CDN URLs can expire within hours. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the Telegram Channel API. - ### Track a channel's subscriber growth - ### Enrich channel lists with names, bios and links - ### Tell channels from groups, users and bots - ### Vet channels by age and size before advertising ## Good to know before you build. - metrics.follower_count is a channel's subscribers or a group's members, exact as Telegram's page shows them. When only a channel's preview answers, it is rounded and listed in approximate_fields. A user or a bot has none: a bot's monthly users are in platform_specific.telegram.monthly_user_count. - The photo, video, link and file counts are rounded from the thousands up, as Telegram shows them, and listed in approximate_fields. They, created_at and channel_id come from a channel's public preview, so a group, a user, a bot or a channel with its preview off has them null. - username is Telegram's own spelling when the channel's first message still exists. Otherwise it is the name as asked, in lower case, and so is a group's, a user's or a bot's. A channel asked by a second username answers under its main one, read from the same message. - avatar_url is null where Telegram's page draws the account's initials in place of a photo. - A name nobody holds returns not_found. Channels Telegram hides from logged-out visitors return private_or_unavailable. For some channels that depends on the country a request leaves from, and so does platform_specific.telegram.is_preview_available. ## 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/telegram/channel/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Public page `page` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the Telegram Channel API. More in the [API reference](https://socialtap.dev/docs/reference/telegram/channel/index.md). **Is the subscriber count exact?** Yes, as Telegram's page shows it. Only when a channel's preview is all that answers is it rounded, and then approximate_fields lists it. **How much does the Telegram Channel API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Profiles on 26 more platforms. - [TikTok Profile API](https://socialtap.dev/apis/tiktok/profile/index.md) (1 credit · `GET /v1/tiktok/profile`) - [Instagram Profile API](https://socialtap.dev/apis/instagram/profile/index.md) (1 credit · `GET /v1/instagram/profile`) - [Facebook Profile API](https://socialtap.dev/apis/facebook/profile/index.md) (1 credit · `GET /v1/facebook/profile`) - [YouTube Channel API](https://socialtap.dev/apis/youtube/profile/index.md) (1 credit · `GET /v1/youtube/profile`) - [Reddit Profile API](https://socialtap.dev/apis/reddit/profile/index.md) (1 credit · `GET /v1/reddit/profile`) - [Threads Profile API](https://socialtap.dev/apis/threads/profile/index.md) (1 credit · `GET /v1/threads/profile`) - [Spotify Artist API](https://socialtap.dev/apis/spotify/artist/index.md) (1 credit · `GET /v1/spotify/artist`) - [Amazon Shop API](https://socialtap.dev/apis/amazon/shop/index.md) (1 credit · `GET /v1/amazon/shop`) - [Apple Music Artist API](https://socialtap.dev/apis/applemusic/artist/index.md) (1 credit · `GET /v1/applemusic/artist`) - [Pinterest Profile API](https://socialtap.dev/apis/pinterest/profile/index.md) (1 credit · `GET /v1/pinterest/profile`) - [Rumble Channel API](https://socialtap.dev/apis/rumble/profile/index.md) (1 credit · `GET /v1/rumble/profile`) - [X (Twitter) Profile API](https://socialtap.dev/apis/x/profile/index.md) (1 credit · `GET /v1/x/profile`) - [Bluesky Profile API](https://socialtap.dev/apis/bluesky/profile/index.md) (1 credit · `GET /v1/bluesky/profile`) - [Twitch Profile API](https://socialtap.dev/apis/twitch/profile/index.md) (1 credit · `GET /v1/twitch/profile`) - [LinkedIn Profile API](https://socialtap.dev/apis/linkedin/profile/index.md) (From 1 credit · `GET /v1/linkedin/profile`) - [Kwai Profile API](https://socialtap.dev/apis/kwai/profile/index.md) (1 credit · `GET /v1/kwai/profile`) - [Snapchat Profile API](https://socialtap.dev/apis/snapchat/profile/index.md) (1 credit · `GET /v1/snapchat/profile`) - [SoundCloud Artist API](https://socialtap.dev/apis/soundcloud/artist/index.md) (1 credit · `GET /v1/soundcloud/artist`) - [Truth Social Profile API](https://socialtap.dev/apis/truthsocial/profile/index.md) (1 credit · `GET /v1/truthsocial/profile`) - [Komi Page API](https://socialtap.dev/apis/komi/page/index.md) (1 credit · `GET /v1/komi/page`) - [Lnk.Bio Profile API](https://socialtap.dev/apis/linkbio/profile/index.md) (1 credit · `GET /v1/linkbio/profile`) - [Linkme Profile API](https://socialtap.dev/apis/linkme/profile/index.md) (1 credit · `GET /v1/linkme/profile`) - [Linktree Profile API](https://socialtap.dev/apis/linktree/profile/index.md) (1 credit · `GET /v1/linktree/profile`) - [Pillar Page API](https://socialtap.dev/apis/pillar/page/index.md) (1 credit · `GET /v1/pillar/page`) - [Facebook Ad Library Advertiser Search API](https://socialtap.dev/apis/facebook/search_advertisers/index.md) (1 credit / page · `GET /v1/facebook/search_advertisers`) - [Google Ads Transparency Center Advertiser API](https://socialtap.dev/apis/google/advertiser/index.md) (1 credit · `GET /v1/google/advertiser`) More Telegram ## Telegram API. 4 endpoints, one key. - [Telegram Post API](https://socialtap.dev/apis/telegram/post/index.md) (1 credit · `GET /v1/telegram/post`) - [Telegram Channel Posts API](https://socialtap.dev/apis/telegram/channel_posts/index.md) (1 credit / page · `GET /v1/telegram/channel_posts`) - [Telegram Channel Search API](https://socialtap.dev/apis/telegram/search_channels/index.md) (From 1 credit / page · `GET /v1/telegram/search_channels`) ## Try it on an account you know. Paste its handle or link in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/telegram/channel/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)