Skip to main content
POST
Telegram Post Detail API

Telegram Post Detail

When you already know which posts matter, pass their links and get each one back in full: text, publish time, views, total reactions, photos and videos. Posts from different channels can be mixed in one request, which makes it handy for refreshing the numbers on a set of tracked announcements or campaign posts. The raw result file keeps the per-emoji reaction counts and the forwarding source.
Provide up to 50 Telegram post links in urls, in the form t.me/channel/post_id. Each post found returns one row and costs 0.5 credits. Posts that have been deleted or sit in a private channel are skipped; the task fails with a refund only when none of them can be read.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide up to 50 Telegram post links in urls. Each post that exists returns one row with its text, views, reactions, media and reply context.

urls
string[]
required

Links to posts in public Telegram channels, up to 50, such as https://t.me/durov/510.

Required array length: 1 - 50 elements
Minimum string length: 1
callback_url
string<uri>

Response

Task accepted

code
integer
data
object