Skip to main content
POST
Telegram Channel Info API

Telegram Channel Info

Look up public Telegram channels by their t.me link and get back the name, description, avatar, verification badge and subscriber count. It suits channel vetting before a sponsorship, keeping a watchlist of crypto or news channels up to date, or enriching a list of channel links collected elsewhere. The raw result file also carries the number of photos, videos and links each channel has shared.
Provide up to 50 public Telegram channel links in urls (t.me/name or t.me/s/name). Each channel found returns one row and costs 0.5 credits; links to channels that are not public are skipped, and 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 public Telegram channel links in urls. Each channel that exists returns one row with its title, description, avatar, verification and subscriber, photo, video and link counts.

urls
string[]
required

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

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

Response

Task accepted

code
integer
data
object