Skip to main content
POST
Telegram Comments API

Telegram Comments

Channels that link a discussion group let readers comment under each post. This endpoint reads that thread for one post and returns each comment with its author name, text, time, reaction total and the comment it answers, so you can see how a community reacted to an announcement or pull feedback into a support or research workflow.
Provide one Telegram post link in url. Comments come from the discussion group linked to the channel, and you pay only for the comments returned. results_limit defaults to 100, which is also the maximum. Each comment costs 0.3 credits.

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 one Telegram post link in url. Comments are read from the discussion group linked to the channel. results_limit defaults to 100, the maximum.

url
string
required

Link to a post in a public Telegram channel, such as https://t.me/durov/510.

Minimum string length: 1
callback_url
string<uri>
results_limit
integer
default:100
Required range: 1 <= x <= 100

Response

Task accepted

code
integer
data
object