万有引擎
搜索⌘K
中文
登录免费开始

社交内容 · 数据 API

Telegram

Telegram API

查看 Telegram 公开频道资料和消息，按关键词找内容，并区分群组信息与可得的成员样本；保留频道来源和消息字段，便于在许可范围内核对信息。 调用 POST /api/v1/social ；返回结构化 JSON，$0.56 / 千次；失败不计费。

免费开始 看文档

5

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Telegram 能力清单

action必填参数可选参数单次条数模式单价返回字段
channel_postsusername—默认 20 · 最多 200同步$0.56 / 千次id · url · channel_username · channel_title · text · view_count · posted_at · media_type · media_url · author · is_forwarded · forwarded_from · reply_to_url · platform · link_preview_url · reactions
profileusername——同步$0.56 / 千次username · name · bio · subscriber_count · photo_count · video_count · link_count · is_verified · avatar_url · url · platform
searchkeywordsince, until默认 20 · 最多 100同步$0.56 / 千次id · url · text · posted_at · view_count · media_url · reactions · channel_username · channel_title · channel_type · channel_subscriber_count · channel_description · platform
groupusername——同步$0.56 / 千次id · type · username · url · title · name · description · member_count · online_count · created_at · is_verified · is_scam · is_fake · is_forum · is_restricted · admin_bots · platform
membersusername—默认 100 · 最多 5000同步$0.56 / 千次id · username · url · name · type · is_verified · is_premium · is_scam · is_fake · last_seen_at · platform

Telegram 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social， 切换 action 时，也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象；请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料，用于核对对象与术语，不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准，不与平台官方 API 直接等同。

怎么调用 Telegram 频道帖子 API？

channel_posts

使用 platform="telegram"、action="channel_posts" 调用“频道帖子”能力；返回列表，默认 20 条、单次最多 200 条，主要包含 id、url、channel_username、channel_title、text、view_count 等 16 个字段。

Telegram channel_posts 的参数分别是什么意思？

username必填
公开频道或群的用户名，可为 name、@name、t.me/name 或 t.me/s/name。channel_posts/profile 用于公开频道，group 读取公开实体信息，members 读取可见群成员；不支持私密邀请链接，也不承诺完整成员名单。

官方区分公开频道与需邀请加入的私有频道，并说明频道用于广播、浏览计数包含转发副本且为近似值。用于解释频道对象和 view_count，不证明本接口可读取完整历史或私有内容。官方来源：Telegram 官方：频道、公开用户名与浏览计数来源核查：

第三方客户端、机器人和 Mini App 的有限例外仅覆盖运作所必需的数据，并受条款、版权及隐私要求约束；不能把接口存在当作获得采集、转售或任意再利用许可。官方来源：Telegram 官方：读取内容仍须满足许可条件来源核查：

Telegram 特有返回字段与含义（9）
channel_username
频道用户名（@开头的公开标识）。
channel_title
频道名称。
author
消息发送者。
is_forwarded
该消息是否为转发。
forwarded_from
转发来源。追溯信息传播链用。
reply_to_url
被回复消息的链接。
media_type
媒体类型（照片/视频/文件/语音）。
media_url
媒体文件链接。
reactions
表情回应及各自数量。

怎么调用 Telegram 主页或对象详情 API？

profile

使用 platform="telegram"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 username、name、bio、subscriber_count、photo_count、video_count 等 11 个字段。

Telegram profile 的参数分别是什么意思？

username必填
公开频道或群的用户名，可为 name、@name、t.me/name 或 t.me/s/name。channel_posts/profile 用于公开频道，group 读取公开实体信息，members 读取可见群成员；不支持私密邀请链接，也不承诺完整成员名单。

官方区分公开频道与需邀请加入的私有频道，并说明频道用于广播、浏览计数包含转发副本且为近似值。用于解释频道对象和 view_count，不证明本接口可读取完整历史或私有内容。官方来源：Telegram 官方：频道、公开用户名与浏览计数来源核查：

Telegram 特有返回字段与含义（5）
subscriber_count
订阅数。
photo_count
图片数量。
video_count
视频数量。
link_count
消息中的链接数量。
is_verified
账号是否已认证。

怎么调用 Telegram 群组资料 API？

group

使用 platform="telegram"、action="group" 调用“群组资料”能力；返回单个对象，主要包含 id、type、username、url、title、name 等 17 个字段。

Telegram group 的参数分别是什么意思？

username必填
公开频道或群的用户名，可为 name、@name、t.me/name 或 t.me/s/name。channel_posts/profile 用于公开频道，group 读取公开实体信息，members 读取可见群成员；不支持私密邀请链接，也不承诺完整成员名单。

官方解释公开用户名与 t.me 链接，并说明最后上线可隐藏、可能只显示模糊状态。不能据 members 的 last_seen_at 还原精确轨迹，用户名也不等于已公开手机号。官方来源：Telegram 官方：群组、用户名和最后上线隐私来源核查：

Telegram 特有返回字段与含义（8）
is_verified
账号是否已认证。
member_count
成员数。
online_count
当前在线人数。群活跃度的直接指标。
admin_bots
频道内的管理机器人。
is_forum
是否为话题式论坛群。
is_scam
Telegram 官方标记为诈骗账号。为 true 时内容不可信。
is_fake
官方标记为冒充账号（假冒知名主体）。
is_restricted
账号是否被限制。

怎么调用 Telegram 成员列表 API？

members

使用 platform="telegram"、action="members" 调用“成员列表”能力；返回列表，默认 100 条、单次最多 5000 条，主要包含 id、username、url、name、type、is_verified 等 11 个字段。

Telegram members 的参数分别是什么意思？

username必填
公开频道或群的用户名，可为 name、@name、t.me/name 或 t.me/s/name。channel_posts/profile 用于公开频道，group 读取公开实体信息，members 读取可见群成员；不支持私密邀请链接，也不承诺完整成员名单。

官方解释公开用户名与 t.me 链接，并说明最后上线可隐藏、可能只显示模糊状态。不能据 members 的 last_seen_at 还原精确轨迹，用户名也不等于已公开手机号。官方来源：Telegram 官方：群组、用户名和最后上线隐私来源核查：

第三方客户端、机器人和 Mini App 的有限例外仅覆盖运作所必需的数据，并受条款、版权及隐私要求约束；不能把接口存在当作获得采集、转售或任意再利用许可。官方来源：Telegram 官方：读取内容仍须满足许可条件来源核查：

Telegram 特有返回字段与含义（5）
is_verified
账号是否已认证。
is_scam
Telegram 官方标记为诈骗账号。为 true 时内容不可信。
is_fake
官方标记为冒充账号（假冒知名主体）。
is_premium
发送者是否为 Telegram Premium 用户。
last_seen_at
最后在线时间。
Telegram channel_posts 调用流程一次 Telegram channel_posts 调用的全过程：向 POST /api/v1/social 发送 platform="telegram"、action="channel_posts"，以及必填参数 username;返回结构化 JSON，含 id、url、channel_username、channel_title、text 等字段；返回列表，单次最多 200 条，计费 $0.56 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "telegram"action: "channel_posts"usernameEveryInfra$0.56 / 千次2 · 响应 · 列表idurlchannel_usernamechannel_titletext
一次 Telegram channel_posts 调用的全过程：向 POST /api/v1/social 发送 platform="telegram"、action="channel_posts"，以及必填参数 username;返回结构化 JSON，含 id、url、channel_username、channel_title、text 等字段；返回列表，单次最多 200 条，计费 $0.56 / 千次，失败与空结果不计费。

Telegram 原始字段名

EveryInfra 统一字段名

左边是 Telegram 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。89 个平台复用通用字段命名，减少重复适配； 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系，不是目标的实时返回数据。

Telegram 的独有字段名（当前目录）

全站 89 个平台的当前目录中，这 15 个字段名只在 Telegram 出现。 这是字段命名的分布，不代表其他平台没有同类信息，也不保证每次响应都含这些字段；具体含义和返回条件仍需逐接口核对。

  • channel_title
  • is_forwarded
  • forwarded_from
  • reply_to_url
  • link_preview_url
  • reactions
  • link_count
  • channel_subscriber_count
  • channel_description
  • is_scam
  • is_fake
  • is_forum
  • is_restricted
  • admin_bots
  • last_seen_at

返回字段含义

通用字段采用统一命名；切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版：/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
url
该记录在原平台上的可访问链接。
channel_username
频道用户名（@开头的公开标识）。
channel_title
频道名称。
text
正文内容，已去除 HTML 标签。长文可能被截断。
view_count
浏览/播放数。null 表示不公开，不等于 0。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
media_type
媒体类型（照片/视频/文件/语音）。
media_url
媒体文件链接。
author
消息发送者。
is_forwarded
该消息是否为转发。
forwarded_from
转发来源。追溯信息传播链用。
reply_to_url
被回复消息的链接。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
reactions
表情回应及各自数量。
username
用户名（@handle）。
name
名称。用于账号/商品/商家类能力，指该对象本身的名字。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
subscriber_count
订阅数。
photo_count
图片数量。
video_count
视频数量。
link_count
消息中的链接数量。
is_verified
账号是否已认证。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
channel_type
类型（频道/群组/超级群）。
channel_subscriber_count
频道订阅数。
channel_description
频道简介。
type
记录类型，取值随能力而定（如 video / image / text）。
title
标题。平台无标题概念时（如纯文本帖）为 null。
description
简介或描述，通常比 text 短。
member_count
成员数。
online_count
当前在线人数。群活跃度的直接指标。
created_at
创建时间，格式同 posted_at。
is_scam
Telegram 官方标记为诈骗账号。为 true 时内容不可信。
is_fake
官方标记为冒充账号（假冒知名主体）。
is_forum
是否为话题式论坛群。
is_restricted
账号是否被限制。
admin_bots
频道内的管理机器人。
is_premium
发送者是否为 Telegram Premium 用户。
last_seen_at
最后在线时间。

当前目录另列出 link_preview_url，这些字段尚无逐项释义；请先核对 Telegram 对应接口的用例与实际响应，不按字段名猜测类型或含义。

请求填写示例

替换为公开频道用户名；私密邀请链接或单条消息编号不是此参数。

以下为填写格式示意，并非成功调用记录。请替换 API Key 和尖括号中的目标，确认可选筛选项后再调用；示例不保证目标当前有数据。

telegram_channel_posts.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"telegram","action":"channel_posts","params":{"username":"<PUBLIC_CHANNEL_USERNAME>"}}'

记录字段预览（非真实响应）

仅展示 channel_posts 的记录字段，不包含外层响应、计费或任务状态。null 只作展示占位，不表示字段类型或实际空值；完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "channel_username": null,
  "channel_title": null,
  "text": null,
  "view_count": null,
  "posted_at": null,
  "media_type": null,
  "media_url": null,
  "author": null,
  "is_forwarded": null,
  "forwarded_from": null,
  "reply_to_url": null,
  "platform": null,
  "link_preview_url": null,
  "reactions": null
}

常见用例

以下是基于现有接口的接入思路，不是开箱即用的分析或告警功能。字段以实际返回为准，缺失值不按零处理。

如何按 Telegram 频道读取消息，而不是把频道简介当消息？

channel_posts 用于整理指定公开频道的消息样本，频道主体和每条消息分别保留标识。

查看 channel_posts 的 username 参数 →
  • username 必填，可传纯频道名、@频道名、https://t.me/频道名 或 https://t.me/s/频道名；这里定位整个频道，传消息链接也不会变成单条消息查询。私有邀请链接和 t.me/c/ 链接不属于已确认输入。
  • id、url 标识消息，channel_username、channel_title 标识频道；media_type、media_url 是返回的媒体信息，不保证完整相册。view_count 是频道显示的浏览计数，不是去重读者数；转发副本和重复查看可能影响平台计数。
  • 默认请求 20 条、目录上限 200 条，不保证完整历史。仅在具备所需许可的范围内读取和使用内容；公开可见不等于可任意复制、聚合或用于 AI。

如何区分 Telegram 频道订阅规模与消息互动？

profile 返回频道资料对象，适合核对频道名称、简介和公开的订阅规模，不返回订阅者名单。

查看 profile 的 username 参数 →
  • username 使用频道公开用户名或 t.me 频道链接，不是机器人 token，也不是聊天数字 ID；接口不会加入私有频道。
  • name、bio、avatar_url 是频道资料；subscriber_count 是平台提供的订阅规模，photo_count、video_count、link_count 是资料中的分类计数，不能当作本次返回的消息条数或活跃人数。数值和字段是否出现以实际响应为准。

如何查 Telegram 公开频道中的关键词消息？

search 按 keyword 搜索可获取的公开频道消息，同时返回来源频道信息；它不是联系人搜索或私人聊天检索。

查看 search 的 keyword 参数 →
  • keyword 填消息主题词；可选 since、until 限定消息日期范围，不能用于筛选频道成立时间。默认请求 20 条、目录上限 100 条，不能据此声称覆盖 Telegram 的所有频道。
  • text、posted_at、view_count 描述消息；channel_title、channel_type、channel_subscriber_count、channel_description 描述来源。url 按响应提供的来源链接处理，不保证每次都是单条消息永久链接；text 最多保留 6000 字符。
  • Telegram 内容许可条款对平台数据采集及 AI 相关用途有明确限制。此处是接口契约说明，不是获得平台或内容权利人许可的证明；不能把结果直接当作已获许可的 AI 训练、评测或部署语料。

Telegram 群组资料为什么要先看 type？

group 解析公开用户名对应的实体信息；实体可能不是群组，不能把所有返回对象都按群聊统计处理。

查看 group 的 username 参数 →
  • username 可填公开短名、@短名或 t.me 链接。先核对 type、username、url，再解释群组的 title、member_count、online_count；若对象是个人或机器人，name 等字段的含义与群组标题不同。
  • online_count 只是可获取的在线人数快照，不能当长期活跃度；is_forum 表示论坛式组织信息，缺少 is_scam、is_fake 等字段不能解释为已通过安全认证。此接口不返回群消息历史，也不绕过私有群权限。

Telegram members 返回哪些成员资料，哪些不会提供？

members 返回目标公开群可获取的成员样本，不等于频道订阅者全量导出，也不提供成员手机号。

查看 members 的 username 参数 →
  • username 定位目标群的公开用户名或 t.me 链接，不是成员个人用户名列表；默认请求 100 条、目录上限 5000 条，当前不启用历史深查，不能保证覆盖全部成员或离群成员。
  • id、username、url、name 是成员身份资料；is_premium 指 Telegram Premium 状态，不是该群的付费等级。last_seen_at 可能受隐私设置限制或只表达模糊状态，缺失不等于离线，也不能用于推断精确在线轨迹。
  • 成员公开资料不构成批量联系或再分发授权；使用前须核对平台许可及个人信息处理条件，不能把该接口宣传为获准采集陌生人联系方式的工具。

Telegram API 常见问题

Telegram API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="telegram"、action 和 params。以 channel_posts 为例，必填 username，没有可选参数。替换为公开频道用户名；私密邀请链接或单条消息编号不是此参数。 Telegram 共 5 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Telegram API 怎么收费？

$0.56 / 千次，Telegram 全部 5 个能力同价。按本页最高能力单价、每次单目标估算，$1 免费额度约可用于 1,798 次 Telegram 调用。费用按所选能力与目标数量计算，多目标请求不要按单目标估算；参数错误、鉴权失败和空结果不计费。

Telegram API 一次能返回多少条数据？

Telegram 有 3 个列表接口，包括 channel_posts、search、members。其余 2 个接口返回单个对象；对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数，不能将目录数值直接当作保证返回的条数；具体限制见对应参数与用例，不保证完整历史。

Telegram API 返回哪些字段？

当前目录为 channel_posts 列出 id、url、channel_username、channel_title、text、view_count 等 16 个字段名。按全站当前目录统计，15 个字段名只在 Telegram 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

如何按 Telegram 频道读取消息，而不是把频道简介当消息？

channel_posts 用于整理指定公开频道的消息样本，频道主体和每条消息分别保留标识。 username 必填，可传纯频道名、@频道名、https://t.me/频道名 或 https://t.me/s/频道名；这里定位整个频道，传消息链接也不会变成单条消息查询。私有邀请链接和 t.me/c/ 链接不属于已确认输入。 id、url 标识消息，channel_username、channel_title 标识频道；media_type、media_url 是返回的媒体信息，不保证完整相册。view_count 是频道显示的浏览计数，不是去重读者数；转发副本和重复查看可能影响平台计数。 默认请求 20 条、目录上限 200 条，不保证完整历史。仅在具备所需许可的范围内读取和使用内容；公开可见不等于可任意复制、聚合或用于 AI。

如何区分 Telegram 频道订阅规模与消息互动？

profile 返回频道资料对象，适合核对频道名称、简介和公开的订阅规模，不返回订阅者名单。 username 使用频道公开用户名或 t.me 频道链接，不是机器人 token，也不是聊天数字 ID；接口不会加入私有频道。 name、bio、avatar_url 是频道资料；subscriber_count 是平台提供的订阅规模，photo_count、video_count、link_count 是资料中的分类计数，不能当作本次返回的消息条数或活跃人数。数值和字段是否出现以实际响应为准。

如何查 Telegram 公开频道中的关键词消息？

search 按 keyword 搜索可获取的公开频道消息，同时返回来源频道信息；它不是联系人搜索或私人聊天检索。 keyword 填消息主题词；可选 since、until 限定消息日期范围，不能用于筛选频道成立时间。默认请求 20 条、目录上限 100 条，不能据此声称覆盖 Telegram 的所有频道。 text、posted_at、view_count 描述消息；channel_title、channel_type、channel_subscriber_count、channel_description 描述来源。url 按响应提供的来源链接处理，不保证每次都是单条消息永久链接；text 最多保留 6000 字符。 Telegram 内容许可条款对平台数据采集及 AI 相关用途有明确限制。此处是接口契约说明，不是获得平台或内容权利人许可的证明；不能把结果直接当作已获许可的 AI 训练、评测或部署语料。

Telegram 群组资料为什么要先看 type？

group 解析公开用户名对应的实体信息；实体可能不是群组，不能把所有返回对象都按群聊统计处理。 username 可填公开短名、@短名或 t.me 链接。先核对 type、username、url，再解释群组的 title、member_count、online_count；若对象是个人或机器人，name 等字段的含义与群组标题不同。 online_count 只是可获取的在线人数快照，不能当长期活跃度；is_forum 表示论坛式组织信息，缺少 is_scam、is_fake 等字段不能解释为已通过安全认证。此接口不返回群消息历史，也不绕过私有群权限。

可以先免费试用 Telegram API 吗？

可以。注册免费，加微信领邀请码可得 $1 免费额度（≈720 次数据调用）。请先选择 Telegram 的目标接口，用单目标请求核对结果；实际可调用次数取决于能力价格与目标数量，不保证覆盖全部 5 个能力。无需信用卡。

更多社交内容 API

Behance APIB站 APIBluesky APIDailymotion APIDeviantArt APIDiscord API豆瓣 API抖音 API全部 89 平台 ↗

开始调用 Telegram API

加微信领 $1 免费额度，先选一个 Telegram 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始