Telegram Channel Info
Telegram Channel Info is the public profile of a broadcast channel, made up of its username, title, description, avatar, verification badge and subscriber count. Those few signals show how large a channel is, whether Telegram has verified it and what it says it publishes, which supports sponsorship vetting, watchlist upkeep and enrichment of channel lists.
Telegram Channel Info API Features
- Up to 50 channels in one taskMix t.me/name, t.me/s/name, telegram.me and telegram.dog links in urls; a channel listed twice is looked up once, and each channel found comes back as one row.
- Subscriber count as a whole numbermetrics.followers_count turns Telegram's short display such as 9.95M into an integer like 9950000, ready for sorting, filtering and thresholds.
- Identity and verification in one rowusername, name, text and avatar_url describe the channel, and is_verified shows whether it carries Telegram's verification badge.
- Unreadable links skipped without chargeA link to a private or removed channel is left out of the results and costs nothing, while the other channels in the batch return as usual.
Telegram Channel Info API Parameters
| Parameters | Required | Description |
|---|---|---|
urls | Required | Up to 50 public Telegram channel links, such as https://t.me/durov or https://t.me/s/durov. telegram.me and telegram.dog links work too, and a repeated channel is looked up once. |
How to Use the Telegram Channel Info API
Send a list of channel links to the Telegram Channel Info API and read one row for every channel found.
- POST {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} to /v1/telegram/channel-info.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- Read the channels from results.items, and while has_more is true pass results.next_cursor to load the next page.
curl -X POST "https://api.socq.ai/v1/telegram/channel-info" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://t.me/durov","https://t.me/tginfo"]}'Telegram Channel Info API Use Cases
- Vetting a channel before a sponsorship: Pull subscriber count, verification status and the channel description from the Telegram Channel Info API and check them side by side before agreeing to a paid placement.
- Keeping a channel watchlist current: Re-run the same list on a schedule and store followers_count with collected_at to chart how each crypto, news or niche channel grows.
- Enriching links gathered elsewhere: Turn a column of t.me links from a spreadsheet, a search or a partner list into titles, descriptions and audience sizes.
Telegram Channel Info API Pro Tips
- Key your records on the returned username: t.me/name and t.me/s/name point to the same channel and produce the same id, so repeated lookups merge cleanly.
- A post link such as https://t.me/durov/510 is read as its channel; to get the post itself, send it to Telegram Post Detail API.
Related APIs
Beyond the Telegram Channel Info API, use these APIs when you need a different type of public Telegram data.
- Telegram Channel Scraper API — Collect up to 1,000 posts from a public Telegram channel, newest first, with text, publish time, views, reaction totals, photos and videos.
- Telegram Post Detail API — Fetch up to 50 specific Telegram posts by link, from any mix of public channels, with full text, publish time, views, reactions and media.
- Telegram Comments API — Collect up to 100 comments under a Telegram channel post from its discussion group, with author name, text, time, reactions and reply target.
- Telegram Similar Channels API — Find the channels Telegram recommends next to a public channel, usually around ten, each with title, verification badge and exact subscriber count.
- Telegram Channel Search API — Search a public Telegram channel's full post history for a word or phrase and get up to 100 matching posts with text, date, views and reactions.