Telegram Fetch Channel Search
2.07 credits/call
ae_telegram_fetch_channel_search
### Purpose: - Search posts in a channel by keyword (case-insensitive). - Uses Telegram's server-side search over the full channel history when the MTProto backend is enabled (`data.backend = "mtproto"`); otherwise falls back to best-effort local filtering over recent history (`data.backend = "web"`). ### Parameters: - channel: Channel username (required). - query: Keyword (required). - limit: Number of hits (1-100, default 20). # [示例/Example] channel = "durov"; query = "TON" AE input example: {"channel":"durov","query":"TON","limit":20}
2.07 credits/call
Pricing
2.07 credits/call
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
limit | integer | No | 返回条数/Number of hits | 20 |
query | string | Yes | 关键词/Keyword | — |
channel | string | Yes | 频道用户名/Channel username | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_telegram_fetch_channel_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"channel": "durov",
"limit": 20,
"query": "TON"
}
}'Response exampleresponse.json
{
"code": 200,
"data": {
"backend": "web",
"channel": "durov",
"matched": 15,
"messages": [
{
"author": "Pavel Durov",
"channel": "durov",
"date": "2026-11-15T22:48:26+00:00",
"id": 562,
"type": "photo",
"url": "https://t.me/durov/562"
}
],
"note": "Best-effort keyword filter over recent posts only; older matches may be missing.",
"query": "TON"
},
"docs": "https://api.tikhub.io/#/Telegram-Web-API/fetch_channel_search_api_v1_telegram_web_fetch_channel_search_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "1985f081-719c-40e9-beec-3a102992a413"
}This example shows part of the response. Copied content is valid JSON.






