On 2026-11-17 SocQ added a Telegram platform with six endpoints for public Telegram channels. Together they cover the whole research loop: vet a channel, read its feed, pull specific posts, read the discussion under a post, find related channels and search a channel's history for a word.
This guide lists what each endpoint returns, the request it takes, what it costs and when to use it. Every endpoint works from public t.me links and runs as an asynchronous SocQ task.
Quick answer: Send a public channel or post link to one of the six
POST /v1/telegram/...endpoints withAuthorization: Bearer $SOCQ_API_KEY. Save the returnedtask_id, pollGET /v1/tasks/{task_id}untilstatusissucceeded, and read the records indata.results.items. Every endpoint is billed per result: 0.3 or 0.5 credits per row, which is $0.0015 or $0.0025 at $0.005 per credit.
The Six New Telegram Endpoints
| Endpoint | What it returns | Input | Price |
|---|---|---|---|
| Channel Info | Title, description, avatar, verification badge, subscriber count | Up to 50 channel links | 0.5 credits ($0.0025) per channel |
| Channel Scraper | Posts newest first with text, time, views, reaction totals, photos and videos | One channel link | 0.3 credits ($0.0015) per post |
| Post Detail | Specific posts with full text, time, views, reactions and media | Up to 50 post links | 0.5 credits ($0.0025) per post |
| Comments | Up to 100 comments from the linked discussion group, with author, text, time, reactions and reply target | One post link | 0.3 credits ($0.0015) per comment |
| Similar Channels | Channels Telegram recommends next to a channel, with username, title, badge and subscribers | One channel link | 0.5 credits ($0.0025) per channel |
| Channel Search | Posts in one channel's full history that match a word or phrase | One channel link + query | 0.5 credits ($0.0025) per matching post |
All six bill only for rows returned, with no per-request base fee.
Telegram Channel Info: Vet Channels in Bulk
The Telegram Channel Info API looks up public channels by t.me/name or t.me/s/name link and returns one row per channel: name, description, avatar, verification badge and subscriber count (metrics.followers_count). Use it to vet a channel before a sponsorship, refresh a watchlist of news or crypto channels, or enrich channel links collected elsewhere. The raw result file also carries the number of photos, videos and links each channel has shared.
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"]
}'
Send up to 50 links per request. Links to channels that are not public are skipped; the task fails with a refund only when none of them can be read. See the Channel Info docs.
Telegram Channel Scraper: Read a Channel Feed
The Telegram Channel Scraper API reads a public channel from the latest post backwards. Each post comes with its text, publish time, view count, the total of its emoji and Star reactions, and its attached photos and videos. Pull the last few days for a daily digest, or raise the limit to back-fill a channel's history.
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
}'
results_limit defaults to 20 and accepts 1 to 1,000. A channel that cannot be read fails with a refund. See the Channel Scraper docs.
Telegram Post Detail: Refresh Known Posts
When you already know which posts matter, the Telegram Post Detail API takes their links and returns each one in full: text, publish time, views, total reactions, photos and videos. Posts from different channels can be mixed in one request, which suits refreshing the numbers on tracked announcements or campaign posts. The raw result file keeps the per-emoji reaction counts and the forwarding source.
curl -X POST "https://api.socq.ai/v1/telegram/post-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://t.me/durov/510"]
}'
Send up to 50 links in the form t.me/channel/post_id. Deleted posts and posts in private channels are skipped. See the Post Detail docs.
Telegram Comments: Read the Discussion Under a Post
Channels that link a discussion group let readers comment under each post. The Telegram Comments API reads that thread for one post and returns each comment with its author name, text, time, reaction total and the comment it answers (parent_id). Use it to see how a community reacted to an announcement or to feed comments into a support or research workflow.
curl -X POST "https://api.socq.ai/v1/telegram/post-comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/tginfo/4455",
"results_limit": 100
}'
results_limit defaults to 100, which is also the maximum. You pay only for the comments returned. See the Comments docs.
Telegram Similar Channels: Map a Niche
Telegram shows a row of related channels on every public channel. The Telegram Similar Channels API returns that list for one channel, usually around ten, in the order Telegram lists them, each with username, title, verification badge and subscriber count. Start from a competitor or a channel you already advertise on to widen a media list.
curl -X POST "https://api.socq.ai/v1/telegram/similar-channels" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov"
}'
See the Similar Channels docs.
Telegram Channel Search: Search a Channel's History
The Telegram Channel Search API runs a word or phrase over a public channel's whole history and returns the matching posts with text, date, views and reactions. Check whether an influential channel ever mentioned a project, or collect every post a channel published about a launch.
curl -X POST "https://api.socq.ai/v1/telegram/channel-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://t.me/durov",
"query": "TON",
"results_limit": 20
}'
results_limit defaults to 20 and accepts 1 to 100. A search with no match costs nothing. Photos in search results link to the post that shows them. See the Channel Search docs.
Authentication and the Async Task Flow
Every request carries your API key and a JSON content type:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Each submit call starts a background task:
submit -> task_id -> queued -> running -> succeeded
\-> failed
The submit response returns data.task_id and data.status. Poll the task with the same key:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
While the task is queued, running or failed, the response holds task metadata only; on failed, read error_message. When it is succeeded, the same response includes the first page of normalized records in data.results.items. limit defaults to 50 and goes up to 500. If has_more is true, pass results.next_cursor as cursor to read the next page. fields accepts up to 50 comma-separated fields or dot paths when you want a smaller projection.
A client-side timeout does not cancel a task, so resume with the same task_id instead of submitting and paying for a duplicate. To avoid polling, add callback_url to the submit body; SocQ sends one POST with a task summary when the task finishes, and you then read the records from the task endpoint.
What a Typical Job Costs
- Vet 50 channels with Channel Info: 50 × 0.5 = 25 credits, $0.125.
- Back-fill 1,000 posts from one channel: 1,000 × 0.3 = 300 credits, $1.50.
- Read 100 comments under an announcement: 30 credits, $0.15.
- Search one channel and get 20 matches: 10 credits, $0.05.
FAQ
Do these endpoints work with private channels or groups?
No. They read public channels by their t.me links. Channel Info and Post Detail skip links they cannot read, and Comments reads the discussion group a public channel links to its posts.
How far back can the Channel Scraper go?
It reads newest first, and results_limit accepts up to 1,000 posts per request. To find older posts on a specific subject, use Channel Search, which runs over the channel's whole history.
What does the reaction count include?
For channel posts, metrics.likes_count holds the total of emoji and Star reactions. Post Detail's raw result file keeps the per-emoji counts.
Do I pay for channels or posts that are not found?
No. Billing is per row returned, with no base fee. A Channel Search with no match costs nothing, and a task where none of the links can be read fails with a refund.
How do I find new channels to track?
Start from one channel you know and call Similar Channels, then pass the returned links to Channel Info to compare subscriber counts. See all endpoints on the Telegram platform page and current rates on the pricing page.
TELEGRAM API
Test the workflow with a public Telegram URL
Submit public inputs and receive normalized records with traceable source context.
Explore Telegram APIs