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}

SocialSearchResearch
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
limitintegerNo返回条数/Number of hits20
querystringYes关键词/Keyword—
channelstringYes频道用户名/Channel username—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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.