TItikhub
Telegram-Web-API

频道内关键词搜索/Search posts in a channel

Changed on

[中文]

用途:

  • 在某频道里按关键词搜索消息（大小写不敏感）。
  • 后端 MTProto 已启用时走 Telegram 官方服务端搜索，翻遍整个频道历史， 返回 data.backend = "mtproto"；否则回退为近期历史的本地过滤，返回 data.backend = "web"。

参数:

  • channel: 频道用户名（必填）。
  • query: 关键词（必填）。
  • limit: 返回命中条数（1-100，默认 20）。

[English]

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"

get/api/v1/telegram/web/fetch_channel_search

Request

  • Base URL
    https://api.tikhub.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Query parameters

channelstring required

频道用户名/Channel username

querystring required

关键词/Keyword

limitinteger

返回条数/Number of hits

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes