telegram/
channel-info

Use the Telegram Channel Info API to look up public Telegram channels from up to 50 t.me links, returning each channel's title, description, avatar, verification badge and subscriber count in one batch.

Telegram Channel Info API

Up to 50 channels per request
Subscriber count as a number
Verification badge
t.me and t.me/s links
0.5 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

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

ParametersRequiredDescription
urlsRequiredUp 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.

  1. POST {"urls": ["https://t.me/durov", "https://t.me/tginfo"]} to /v1/telegram/channel-info.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. 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.

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.

Explore other platforms

Combine Telegram data with public data from other supported social platforms.

Telegram Channel Info API — FAQ

Telegram Channel Info API is a programmatic interface for looking up public Telegram channels from their links, up to 50 per request. It returns each channel's username, title, description, avatar, verification badge and subscriber count.

Channel links in the form t.me/name or t.me/s/name, plus telegram.me and telegram.dog links. The channel username starts with a letter and is 5 to 32 characters long.

Private or deleted channels are skipped and not charged, and the rest of the batch returns normally. If none of the links can be read, the task fails and the credits are refunded.

Telegram often displays subscriber counts in a short form such as 9.95M, which is converted to the matching whole number. When Telegram publishes the exact figure, the exact number is returned.

The Telegram Channel Info API charges 0.5 credits for each channel returned, so a request with 50 readable links costs 25 credits. Skipped links cost nothing.