telegram/
post-detail

The Telegram Post Detail API fetches specific Telegram posts from their links, up to 50 per task and from any mix of public channels, each with full text, publish time, views, total reactions and media.

Telegram Post Detail API

Up to 50 posts per request
Mixed channels
Views and reactions
Photos and videos
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 Post Detail

Telegram Post Detail is the full record of a single channel post, including its text, publish time, view count, reaction total and attached photos or videos. Reading those values for posts you already know about lets you refresh campaign numbers, confirm what an announcement said and attach reach figures to links in your own records.

Telegram Post Detail API Features

  • Posts from many channels at onceurls takes up to 50 post links in the form t.me/channel/post_id, and they can come from different channels in the same request.
  • Current views and reactionsmetrics.views_count and metrics.likes_count give the post's view count and reaction total at collection time as integers.
  • Full text and mediatext holds the whole post body, and media lists every photo or video with its type and file URL.
  • Missing posts skipped without chargeDeleted posts and posts in private channels are left out and cost nothing; the task fails with a refund only when none of the links can be read.

Telegram Post Detail API Parameters

ParametersRequiredDescription
urlsRequiredUp to 50 Telegram post links in the form https://t.me/channel/post_id, such as https://t.me/durov/510. Links from different public channels can be mixed.

How to Use the Telegram Post Detail API

Send the post links you want to the Telegram Post Detail API and read one full record per post found.

  1. POST {"urls": ["https://t.me/durov/510"]} to /v1/telegram/post-detail.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the posts 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/post-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://t.me/durov/510"]}'

Telegram Post Detail API Use Cases

  • Refreshing campaign post numbers: Keep the links of sponsored or announcement posts and re-collect them with the Telegram Post Detail API on a schedule to track views and reactions over time.
  • Recording what a post said: Store the exact text and publish time of a post cited in a report, a dispute or a news story, together with collected_at.
  • Enriching shared post links: Turn post links gathered from chats, articles or spreadsheets into full records with the source channel, reach and media.

Telegram Post Detail API Pro Tips

  • Group links from many channels into one Telegram Post Detail API request of up to 50 instead of sending them one at a time.
  • author.username names the channel each post belongs to, which makes it easy to group a mixed batch by channel.
  • To collect a channel's latest posts without knowing their links, use Telegram Channel Scraper API; Post Detail suits posts you can already point to.

Beyond the Telegram Post Detail API, use these APIs when you need a different type of public Telegram data.

  • Telegram Channel Info API — Look up up to 50 public Telegram channels by link for title, description, avatar, verification badge and subscriber count as a whole number.
  • 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 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 Post Detail API — FAQ

Telegram Post Detail API is a programmatic interface for fetching specific posts from public Telegram channels by link, up to 50 per request. Each post comes back with its text, publish time, view count, reaction total and media.

Each link names a channel and a post number, such as https://t.me/durov/510. The t.me/s/, telegram.me and telegram.dog forms of the same link are accepted as well.

Yes. Up to 50 links can be mixed freely, and the author fields on each row show which channel the post came from.

They are skipped and not charged, and the remaining posts return normally. If none of the links can be read, the task fails and the credits are refunded.

The Telegram Post Detail API charges 0.5 credits for each post returned, so a full batch of 50 readable posts costs 25 credits.