Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

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

GET

https://api.tikhub.io/api/v1/telegram/web/fetch_channel_search

Telegram-Web-API

Last modified:2026-07-02 07:41:26

OperationId:fetch_channel_search_api_v1_telegram_web_fetch_channel_search_get

[中文]

用途:

在某频道里按关键词搜索消息（大小写不敏感）。

后端 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"

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.tikhub.io/api/v1/telegram/web/fetch_channel_search?channel=durov&query=TON&limit=20' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "string",
    "time_stamp": 0,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "cache_message": "string",
    "cache_message_zh": "string",
    "cache_url": "string",
    "router": "",
    "params": {},
    "data": null
}

Modified at 2026-07-02 07:41:26

帖子评论/讨论/Post comments

获取用户资料/Get user profile

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

[中文]#

用途:#

参数:#

[English]#

Purpose:#

Parameters:#

[示例/Example]#