Back to APIs
Telegram public channel data

Telegram Public Data API

Read public Telegram channels from their t.me links: channel profiles with subscriber counts, posts with views and reactions, single posts, discussion comments, similar channels and full-history search.

Available Telegram APIs

Channel Info, Channel Scraper, Similar Channels and Channel Search start from a channel link; Post Detail and Comments start from a post link, and every result carries links you can pass to the next endpoint.

What Telegram data can you retrieve?

Each endpoint returns stable SocQ records built from what a public channel shows to any visitor.

Channel profiles

Username, title, description, avatar, verification badge and subscriber count as a whole number, for up to 50 channels per request.

Posts and media

Text, publish time, views, reaction totals including paid Star reactions, and photo and video links, either up to 1,000 posts newest first or up to 50 posts by link.

Discussion comments

Author name, text, time and reactions for up to 100 comments per post, with parent_id and post_id to rebuild reply threads.

Similar channels

The channels Telegram recommends next to a channel, usually around ten, in Telegram's order and with exact subscriber counts.

In-channel search

Up to 100 posts that match a word or phrase anywhere in one channel's history, each with views and reactions.

SocQ and the Telegram API

Telegram's own API is built for creating Telegram apps and bots. SocQ returns public channel data as normalized records you can store, compare and combine.

CapabilitySocQTelegram API
AccessSocQ API keyTelegram app ID with a signed-in account, or a bot token
Starting inputPublic t.me channel and post linksTelegram object identifiers resolved inside a client session
OutputNormalized JSON records with whole-number countsNative Telegram objects
WorkflowAsynchronous tasks with stored, paged resultsLive calls from your own client

How the Telegram APIs work

All six endpoints use the same asynchronous submit, poll and read lifecycle.

  1. 1. Start from a link

    Send a channel link to Channel Info, Channel Scraper, Similar Channels or Channel Search, or a post link to Post Detail or Comments.

  2. 2. Poll the task

    Use the returned task_id with /v1/tasks/{task_id} until processing succeeds or fails.

  3. 3. Chain the results

    Pass post urls from Channel Scraper or Channel Search to Comments or Post Detail, and channel urls from Similar Channels to Channel Info.

Start with one API request

Authenticate with a SocQ API key. Channel Scraper returns 20 posts by default and accepts up to 1,000.

curl -X POST "https://api.socq.ai/v1/telegram/channel-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://t.me/durov","results_limit":20}'

# Then read the comments under one post:
# POST /v1/telegram/post-comments
# {"url":"https://t.me/tginfo/4455"}
# Poll GET /v1/tasks/{task_id}

Common Telegram API use cases

Sponsorship vetting

Check a channel's subscriber count and verification with Channel Info, then read recent views on its posts with Channel Scraper before paying for a placement.

Channel digests and alerts

Collect the latest posts from news, market or project channels on a schedule and route new text and links into summaries or alerts.

Community feedback

Pull the comments under announcements and group them by theme to see how readers responded and which questions repeat.

Niche mapping

Walk outward from seed channels with Similar Channels to build a list of related channels with their audience sizes.

Mention research

Search influential channels for a brand, token or product name and measure how much attention each mention received.

Scope of the data

Results reflect what public Telegram channels show to any visitor at the moment of collection.

  • Every endpoint reads public channels, identified by a channel username or by a post number within a channel.
  • Comments come from the discussion group a channel links to its posts, up to 100 per post in one task.
  • Similar Channels returns the recommendations Telegram shows for a channel, which are usually around ten.
  • Channel Search looks inside one channel per request, across its whole history, and returns up to 100 matches.
  • Counts are snapshots taken at collected_at, and photo and video file links are temporary, so download any files you want to keep.

Telegram API frequently asked questions

What is the Telegram API?

The Telegram API is a set of SocQ endpoints that read public Telegram channels from their links and return channel profiles, posts, discussion comments, similar channels and in-channel search results as normalized JSON records.

Which Telegram APIs are available?

Telegram Channel Info API, Telegram Channel Scraper API, Telegram Post Detail API, Telegram Comments API, Telegram Similar Channels API and Telegram Channel Search API.

Do I need a Telegram account or a bot token?

No. Requests use your SocQ API key and a public channel or post link.

Which link formats are accepted?

Channel links such as t.me/durov or t.me/s/durov, their telegram.me and telegram.dog variants, and post links such as t.me/durov/510 for Post Detail and Comments.

How are subscriber and view counts returned?

As whole numbers. Telegram's short labels such as 9.95M or 661K are converted to integers, and Similar Channels returns exact subscriber counts.

How are the endpoints priced?

Channel Info, Post Detail, Similar Channels and Channel Search cost 0.5 credits per result returned, and Channel Scraper and Comments cost 0.3 credits per post or comment. Links that cannot be read are skipped or refunded, and empty comment threads and searches without matches cost nothing.

Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.