跳到主内容

GET /v1/telegram/web/fetch_channel_search

频道内关键词搜索

stable · 2 credits / 次(成功才计)

在某频道里按关键词搜索消息(大小写不敏感)。;后端 MTProto 已启用时走 Telegram 官方服务端搜索,翻遍整个频道历史,;返回 `data.backend = "mtproto"`;否则回退为近期历史的本地过滤,返回 `data.backend = "web"`。;channel: 频道用户名(必填)。;query: 关键词(必填)。;limit: 返回命中条数(1-100,默认 20)。

注册即送 500 credits,用自己的 Key 试调。 免费注册

请求

curl
curl -s 'https://api.wellbyte.net/v1/telegram/web/fetch_channel_search?limit=20&query=TON&channel=durov' \
  -H "Authorization: Bearer dg_live_…"

响应

示例采集于 2026-09-23

data{
code:0
data{
note:"网页预览无原生搜索,此为近期历史的尽力过滤;完整搜索需启用 MTProto 后端"
query:"TON"
backend:"web"
channel:"durov"
matched:17
scanned:100
messages[ 2 items ]
}
meta{
endpoint:"telegram.web.fetch_channel_search"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

请求历史

打开完整日志

还没有调用记录。先跑通一次,再换成你的数据。

    请求参数

    参数类型位置必填说明示例
    limitintegerquery否返回条数20
    querystringquery是关键词TON
    channelstringquery是频道用户名durov

    响应字段

    字段字典待补 —— 右侧可执行区可直接看到真实结构。

    错误码

    codeHTTP含义是否计费
    40001400参数缺失或格式错误否
    40102401API Key 无效或已吊销否
    40201402余额不足,请充值否
    40402404目标资源不存在否
    42201422质量门槛未通过否
    42901429超出速率限制否
    50401504上游超时否
    50201502上游返回异常否

    计费

    成功扣 2 credits;任何失败(含返回 200 但未过质量门槛)扣 0。

    全部Telegram端点 →

    搜索

    搜索端点与文档