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.
| Capability | SocQ | Telegram API |
|---|---|---|
| Access | SocQ API key | Telegram app ID with a signed-in account, or a bot token |
| Starting input | Public t.me channel and post links | Telegram object identifiers resolved inside a client session |
| Output | Normalized JSON records with whole-number counts | Native Telegram objects |
| Workflow | Asynchronous tasks with stored, paged results | Live calls from your own client |
How the Telegram APIs work
All six endpoints use the same asynchronous submit, poll and read lifecycle.
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. Poll the task
Use the returned task_id with /v1/tasks/{task_id} until processing succeeds or fails.
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.
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.
Combine data across platforms for more complete business insights
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.
Link in Bio API
Turn the single link in a creator's Instagram, TikTok or YouTube bio into structured data: display name, bio, avatar, contact email when listed, linked social profiles, and every button on the page with its title and destination.
Creator API
Start from one Instagram, TikTok, YouTube, X, Facebook or Threads profile and find the creator's public business emails, their accounts on other networks, or an age and gender estimate from the profile photo.
Google Hotels API
Search hotels by destination, open any hotel's full Google Hotels profile and pull its nightly price calendar, all linked by one hotel ID.
Brand Monitoring API
Find the web pages that mention a brand, product or topic, score each one for sentiment and emotion, and summarize how the whole web talks about it.
AI Search API
Track how AI Overviews, ChatGPT and Google AI Mode answer the questions in your market: the answers that name your brand, how visible you are, and the domains and pages they cite.
Instagram API
Look up or find public profiles and collect follower-list records, following relationships, authored posts, profile-tagged posts, hashtag results, Reels, transcripts, comments, account counts, engagement metrics and media metadata through one asynchronous workflow.





