TelegramTelegram ChannelsChannel ScraperAPI Guide

Telegram Channel API: Channel Info, Posts, Comments and Search

Six new SocQ Telegram endpoints for public channels: channel info, the post feed, single posts, discussion comments, similar channels and in-channel search, with requests and per-result prices.

SocQUpdated November 19, 20267 min read

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 with Authorization: Bearer $SOCQ_API_KEY. Save the returned task_id, poll GET /v1/tasks/{task_id} until status is succeeded, and read the records in data.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

EndpointWhat it returnsInputPrice
Channel InfoTitle, description, avatar, verification badge, subscriber countUp to 50 channel links0.5 credits ($0.0025) per channel
Channel ScraperPosts newest first with text, time, views, reaction totals, photos and videosOne channel link0.3 credits ($0.0015) per post
Post DetailSpecific posts with full text, time, views, reactions and mediaUp to 50 post links0.5 credits ($0.0025) per post
CommentsUp to 100 comments from the linked discussion group, with author, text, time, reactions and reply targetOne post link0.3 credits ($0.0015) per comment
Similar ChannelsChannels Telegram recommends next to a channel, with username, title, badge and subscribersOne channel link0.5 credits ($0.0025) per channel
Channel SearchPosts in one channel's full history that match a word or phraseOne channel link + query0.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