Skip to main content
POST
Telegram Channel Search API

Telegram Channel Search

Find every time a channel talked about something, however far back it was posted. The search runs over the channel’s whole history and returns the matching posts with their text, date, views and reactions. Check whether a project was ever mentioned by an influential channel, or collect all of a channel’s posts about a product launch.
Provide one public Telegram channel link in url and the words to look for in query. results_limit defaults to 20 and accepts integers from 1 to 100. Each matching post costs 0.5 credits; a search with no match costs nothing. Photos in search results link to the post that shows them.

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 public Telegram channel link in url and the words to look for in query. The whole history of the channel is searched; results_limit defaults to 20 and accepts integers from 1 to 100.

query
string
required

Words to look for in the channel's posts.

Minimum string length: 1
url
string
required

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

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

Response

Task accepted

code
integer
data
object