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

社交内容 · 数据 API

Truth Social

Truth Social API

区分 Truth Social 作者的帖子与其发出的回复，读取账号、单帖和热门内容样本，为主题观察保留原帖链接与互动信息。 调用 POST /api/v1/social ；返回结构化 JSON，$1.39 / 千次；失败不计费。

免费开始 看文档

5

个能力

$1.39 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

Truth Social 能力清单

action必填参数可选参数单次条数模式单价返回字段
profileusername——同步$1.39 / 千次user_id · username · display_name · bio · url · external_url · location · follower_count · following_count · post_count · is_verified · is_private · avatar_url · header_url · created_at · platform
user_postsusername—默认 20 · 最多 100同步$1.39 / 千次id · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform
repliesusername—默认 20 · 最多 100同步$1.39 / 千次id · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform
posturlid, post_url—同步$1.39 / 千次id · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform
trending——默认 20 · 最多 100同步$1.39 / 千次id · url · text · language · reply_count · repost_count · like_count · author_username · author_name · author_id · author_follower_count · author_verified · reply_to_id · reply_to_account_id · is_reply · is_repost · posted_at · media · hashtags · platform

Truth Social 每个接口分别做什么

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

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

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

profile

使用 platform="truth_social"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 user_id、username、display_name、bio、url、external_url 等 16 个字段。

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

username必填
Truth Social 用户短名，可带 @；user_posts 读取其帖子，replies 读取该作者发出的回复，不是读取别人对某帖的评论。

官方术语区分 handle/username、display name 和主页 Website 链接。这里只解释身份字段，不因用户名、认证标志或网页存在就确认主体身份或私密访问权限。官方来源：Truth Social：账号名、显示名与主页网站字段来源核查：

Truth Social 特有返回字段与含义（3）
external_url
内容中引用的外部链接。
header_url
主页头图。
is_private
账号是否设为私密。

怎么调用 Truth Social 用户内容 API？

user_posts

使用 platform="truth_social"、action="user_posts" 调用“用户内容”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、text、language、reply_count、repost_count 等 20 个字段。

Truth Social user_posts 的参数分别是什么意思？

username必填
Truth Social 用户短名，可带 @；user_posts 读取其帖子，replies 读取该作者发出的回复，不是读取别人对某帖的评论。

官方将 Truth 定义为发布内容、ReTruth 定义为转发，QuoteTruth 为附加评论的引用转发。本网关未保证独立 QuoteTruth 结构字段，不把全部返回都归为原创。官方来源：Truth 与 ReTruth 是不同的内容行为来源核查：

Truth Social 特有返回字段与含义（7）
author_verified
作者是否已认证。
is_reply
该条是否为回复。
is_repost
该条是否为转发（ReTruth）。
reply_to_id
被回复的内容 ID。
reply_to_account_id
被回复账号的 ID。
hashtags
话题标签。
media
附带的媒体内容。

怎么调用 Truth Social 回复列表 API？

replies

使用 platform="truth_social"、action="replies" 调用“回复列表”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 id、url、text、language、reply_count、repost_count 等 20 个字段。

Truth Social replies 的参数分别是什么意思？

username必填
Truth Social 用户短名，可带 @；user_posts 读取其帖子，replies 读取该作者发出的回复，不是读取别人对某帖的评论。
Truth Social 特有返回字段与含义（7）
author_verified
作者是否已认证。
is_reply
该条是否为回复。
is_repost
该条是否为转发（ReTruth）。
reply_to_id
被回复的内容 ID。
reply_to_account_id
被回复账号的 ID。
hashtags
话题标签。
media
附带的媒体内容。

怎么调用 Truth Social 单条内容 API？

post

使用 platform="truth_social"、action="post" 调用“单条内容”能力；返回单个对象，主要包含 id、url、text、language、reply_count、repost_count 等 20 个字段。

Truth Social post 的参数分别是什么意思？

url必填
post 的完整帖子链接，建议包含 @作者 路径，便于同时定位作者和帖子；不要只传无法识别作者的短链接。

官方区分发布 Truth 的内容与单帖详情下的评论。引用仅解释对象，不能据此新增评论导出、发布、删除或任意附件支持。官方来源：Truth Social：单帖、附带内容与评论入口来源核查：

id可选
帖子 ID 的兼容输入，单独使用时无法可靠推断作者；优先用完整 url，不依赖默认作者回落。
post_url可选
url 的帖子链接兼容输入，优先级低于 url，不取消公开必填字段。
Truth Social 特有返回字段与含义（7）
author_verified
作者是否已认证。
is_reply
该条是否为回复。
is_repost
该条是否为转发（ReTruth）。
reply_to_id
被回复的内容 ID。
reply_to_account_id
被回复账号的 ID。
hashtags
话题标签。
media
附带的媒体内容。
Truth Social profile 调用流程一次 Truth Social profile 调用的全过程：向 POST /api/v1/social 发送 platform="truth_social"、action="profile"，以及必填参数 username;返回结构化 JSON，含 user_id、username、display_name、bio、url 等字段；返回单个对象，计费 $1.39 / 千次，失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "truth_social"action: "profile"usernameEveryInfra$1.39 / 千次2 · 响应 · 对象user_idusernamedisplay_namebiourl
一次 Truth Social profile 调用的全过程：向 POST /api/v1/social 发送 platform="truth_social"、action="profile"，以及必填参数 username;返回结构化 JSON，含 user_id、username、display_name、bio、url 等字段；返回单个对象，计费 $1.39 / 千次，失败与空结果不计费。

Truth Social 原始字段名

EveryInfra 统一字段名

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

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

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

  • reply_to_account_id
  • media

返回字段含义

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

user_id
用户在原平台的唯一 ID。
username
用户名（@handle）。
display_name
显示名，可能与 username 不同。
bio
个人简介，账号自己填写的文本。可能含换行和 emoji。
url
该记录在原平台上的可访问链接。
external_url
内容中引用的外部链接。
location
地理位置描述，原文透传，格式随平台而异。
follower_count
粉丝数。null 表示不公开，不等于 0。
following_count
关注数。null 表示不公开，不等于 0。
post_count
发布内容总数。null 表示不公开，不等于 0。
is_verified
是否为平台认证账号（蓝V等）。null 表示无法判定。
is_private
账号是否设为私密。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接，可能有时效。
header_url
主页头图。
created_at
创建时间，格式同 posted_at。
platform
数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
id
该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
text
正文内容，已去除 HTML 标签。长文可能被截断。
language
内容语言代码（如 zh、en），由平台判定，可能不准。
reply_count
回复数，通常用于评论的子回复。null 表示不公开。
repost_count
转发数（区别于引用转发）。null 表示不公开。
like_count
点赞数。null 表示该平台或该接口不公开此数据，不等于 0。
author_username
作者用户名（@handle），通常可用于拼 URL。
author_name
作者昵称（显示名）。
author_id
作者在原平台的唯一 ID。
author_follower_count
作者粉丝数。null 表示不公开。
author_verified
作者是否已认证。
reply_to_id
被回复的内容 ID。
reply_to_account_id
被回复账号的 ID。
is_reply
该条是否为回复。
is_repost
该条是否为转发（ReTruth）。
posted_at
发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
media
附带的媒体内容。
hashtags
话题标签。

请求填写示例

请显式填目标公开用户名；不要依赖未填写时的历史默认作者。

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

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

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

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

fields.preview.json
{
  "user_id": null,
  "username": null,
  "display_name": null,
  "bio": null,
  "url": null,
  "external_url": null,
  "location": null,
  "follower_count": null,
  "following_count": null,
  "post_count": null,
  "is_verified": null,
  "is_private": null,
  "avatar_url": null,
  "header_url": null,
  "created_at": null,
  "platform": null
}

常见用例

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

核对 Truth Social 账号主页与公开身份字段

profile 用用户短名定位账号，返回主页资料，而不是搜索一个人或验证其政治身份。

查看 profile 的 username 参数 →
  • username 传短名，可带 @，不传完整主页 URL 或 display_name。username 与 display_name 分别是账号标识和显示名；url 为 Truth Social 主页，external_url 是主页填写的网站，不是某条 Truth 引用的外链。
  • bio 可能包含 HTML，展示时应作安全处理；follower_count / following_count 是方向不同的计数。is_private 与 is_verified 只是返回标记，不意味着本接口能读取私密内容或代替身份审查；部分资料来自可读帖子中的账号信息，空结果不能证明用户不存在。

读取已知 Truth Social 作者的 Truths

user_posts 用于查看指定作者的内容样本，与读取该作者发出的回复分开。

查看 user_posts 的 username 参数 →
  • username 是账号短名，不是主题词；当前接口没有 keyword 选项。返回 text、author_username、posted_at 与 url，可按 id 保存内容出处；是否为回复或 ReTruth 应看返回标记，而不能把每一行都标成原创。
  • repost_count 对应转发计数，like_count 是点赞，reply_count 是该条的回复计数，不包含评论正文。当前没有时间窗或历史游标输入，不把默认返回批次称为该作者的完整发帖档案。

单独查看 Truth Social 作者发出的回复

replies 按作者读取其回复行为，不是传入一条 Truth 后获取其他人对它的全部评论。

查看 replies 的 username 参数 →
  • username 仍为回复作者的短名。is_reply、reply_to_id 与 reply_to_account_id 用于识别该回复指向的内容和账号；author_username 则属于这条回复本身的作者，方向不能反过来。
  • text / url / posted_at 保留回复出处，但返回不包含被回复帖子正文或完整父子讨论树。官方应用能在 Truth Details 查看评论，不代表当前 EveryInfra 有按帖抓全部评论的 action；需要根帖时应另用其完整链接查询 post。

用含作者路径的 Truth 链接核对单帖

post 定位一条具体 Truth，推荐保留完整作者路径，以免短链接或裸 ID 丢失必要上下文。

查看 post 的 url 参数 →
  • url 使用形如 https://truthsocial.com/@<username>/posts/<ID> 的原帖链接；这只是格式示意，不是真调样本。post_url / id 属兼容输入，不能取消公开必填 url，也不要依赖无法识别作者时的默认回落。
  • 返回 text、author_username、posted_at、hashtags 和 media，媒体子项保留 type / url / preview_url；reply_to_id 描述该帖可能回复的对象，不是子评论列表。公开内容和媒体链接不等于转载授权，本接口不发布 Truth 或 ReTruth。

从 Truth Social 热门内容入口发现主题线索

trending 不依赖账号名或关键词，返回热门 Truth 内容样本，不是个人的 For You 或关注时间线。

查看 trending 接口说明 →
  • 此 action 当前没有专属输入，不能自行附加 keyword、地区或日期过滤。返回的对象是带 id、url、text 与作者字段的 Truth，而不是关键词榜或用户排名。
  • 用 posted_at 和互动计数记录本用例样本数据，不能从列表位置推断完整平台排名或实时热度算法。官方 Discover 同时可能提供找人、群组和话题入口，但这些不自动成为此搜索操作的额外搜索能力。

Truth Social API 常见问题

Truth Social API 怎么调用？

调用 POST /api/v1/social，请求体传 platform="truth_social"、action 和 params。以 profile 为例，必填 username，没有可选参数。请显式填目标公开用户名；不要依赖未填写时的历史默认作者。 Truth Social 共 5 个 action，鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 89 个平台。

Truth Social API 怎么收费？

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

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

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

Truth Social API 返回哪些字段？

当前目录为 profile 列出 user_id、username、display_name、bio、url、external_url 等 16 个字段名。按全站当前目录统计，2 个字段名只在 Truth Social 出现；这不表示其他平台没有同类信息。字段不保证每次齐全，嵌套位置、类型与空值须按各接口说明核对，同名字段不代表语义可互换。

「核对 Truth Social 账号主页与公开身份字段」怎样接入 Truth Social API？

profile 用用户短名定位账号，返回主页资料，而不是搜索一个人或验证其政治身份。 username 传短名，可带 @，不传完整主页 URL 或 display_name。username 与 display_name 分别是账号标识和显示名；url 为 Truth Social 主页，external_url 是主页填写的网站，不是某条 Truth 引用的外链。 bio 可能包含 HTML，展示时应作安全处理；follower_count / following_count 是方向不同的计数。is_private 与 is_verified 只是返回标记，不意味着本接口能读取私密内容或代替身份审查；部分资料来自可读帖子中的账号信息，空结果不能证明用户不存在。

「读取已知 Truth Social 作者的 Truths」怎样接入 Truth Social API？

user_posts 用于查看指定作者的内容样本，与读取该作者发出的回复分开。 username 是账号短名，不是主题词；当前接口没有 keyword 选项。返回 text、author_username、posted_at 与 url，可按 id 保存内容出处；是否为回复或 ReTruth 应看返回标记，而不能把每一行都标成原创。 repost_count 对应转发计数，like_count 是点赞，reply_count 是该条的回复计数，不包含评论正文。当前没有时间窗或历史游标输入，不把默认返回批次称为该作者的完整发帖档案。

「单独查看 Truth Social 作者发出的回复」怎样接入 Truth Social API？

replies 按作者读取其回复行为，不是传入一条 Truth 后获取其他人对它的全部评论。 username 仍为回复作者的短名。is_reply、reply_to_id 与 reply_to_account_id 用于识别该回复指向的内容和账号；author_username 则属于这条回复本身的作者，方向不能反过来。 text / url / posted_at 保留回复出处，但返回不包含被回复帖子正文或完整父子讨论树。官方应用能在 Truth Details 查看评论，不代表当前 EveryInfra 有按帖抓全部评论的 action；需要根帖时应另用其完整链接查询 post。

「用含作者路径的 Truth 链接核对单帖」怎样接入 Truth Social API？

post 定位一条具体 Truth，推荐保留完整作者路径，以免短链接或裸 ID 丢失必要上下文。 url 使用形如 https://truthsocial.com/@<username>/posts/<ID> 的原帖链接；这只是格式示意，不是真调样本。post_url / id 属兼容输入，不能取消公开必填 url，也不要依赖无法识别作者时的默认回落。 返回 text、author_username、posted_at、hashtags 和 media，媒体子项保留 type / url / preview_url；reply_to_id 描述该帖可能回复的对象，不是子评论列表。公开内容和媒体链接不等于转载授权，本接口不发布 Truth 或 ReTruth。

可以先免费试用 Truth Social API 吗？

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

更多社交内容 API

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

开始调用 Truth Social API

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

免费开始