Telegram-Web-API

获取频道消息(分页)/Get channel posts (paginated)

Changed on

[中文]

用途:

  • 抓取公开频道最近的消息列表(含文本、图片、视频、转发、回复、链接卡、表态、阅读量、时间)。

参数:

  • channel: 频道用户名(必填)。
  • limit: 返回条数(1-100,默认 20;>20 时服务端会自动向更老方向翻页累积)。
  • before: 翻页游标 —— 取「更老」的消息,回传上一页响应里的 data.pagination.before_cursor。
  • after: 翻页游标 —— 取「更新」的消息,回传上一页响应里的 data.pagination.after_cursor。

返回:

  • channel_info(结构同 fetch_channel_info)、messages 数组、pagination 游标对象。
  • 媒体直链(cdn4.telesco.pe)带签名且会过期,请尽快下载/转存。

[English]

Purpose:

  • Fetch a public channel's recent posts (text, photos, videos, forwards, replies, link previews, reactions, views, time).

Parameters:

  • channel: Channel username (required).
  • limit: Number of posts (1-100, default 20; when >20 the server automatically pages toward older posts).
  • before: Pagination cursor — fetch older posts, pass data.pagination.before_cursor from the previous page.
  • after: Pagination cursor — fetch newer posts, pass data.pagination.after_cursor from the previous page.

Return:

  • channel_info (same structure as fetch_channel_info), messages array and a pagination cursor object.
  • Media direct links (cdn4.telesco.pe) are signed and expire — download / re-host them promptly.

[示例/Example]

channel = "durov"; limit = 20

get/api/v1/telegram/web/fetch_channel_posts

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

limitinteger

返回条数/Number of posts

beforeinteger

取更老:传上页 before_cursor/Older than this id

afterinteger

取更新:传上页 after_cursor/Newer than this id

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