Truthsocial API

The Truth Social API lets developers retrieve public account profiles and post feeds from Truth Social by username. Access follower counts, verification status, post content, engagement metrics, and pagination support—ideal for social listening, research, and content monitoring.

原始信息汇总

Truthsocial API 数据集概述

基本信息

• 数据集名称: Truthsocial API
• 提供平台: RapidAPI
• API 版本: 1.0.0 (current)
• 类别: Social
• API 创建者: kakoto

服务指标

• 流行度: 8.9
• 服务等级: 100%
• 延迟: 5205ms
• 测试通过率: 100%

订阅计划与定价

• BASIC: $0.00 / mo
• PRO: $15.00 / mo
• ULTRA: $49.00 / mo
• MEGA: $139.00 / mo

功能概述

该 API 允许开发者通过用户名检索 Truth Social 平台的公开账户资料和帖子动态。可获取的数据包括粉丝数、验证状态、帖子内容、互动指标，并支持分页。适用于社交监听、研究和内容监控。

响应结构

成功响应

json { "statusCode": 200, "messageCode": "OK", "data": [ /* 结果对象数组 */ ] }

所有时间戳均为 ISO 8601 格式。

错误响应

json { "statusCode": 400, "messageCode": "BAD_REQUEST", "message": "Invalid search parameters" }

常见错误码：

• 400: 请求错误 — 检查查询参数。
• 500: 内部服务器错误 — 短暂延迟后重试。

端点详情

1. GET /community — 通过用户名获取账户详情

通过用户名检索 Truth Social 账户的公开资料信息。返回账户的全面快照，包括粉丝数、帖子数、验证状态和资料媒体。

输入字段：

字段	类型	必填	描述
username	string	✅	账户用户名（不带 @ 符号，例如 realDonaldTrump）

示例请求：

GET /community?username=realDonaldTrump

账户对象关键字段说明：

字段	描述
id	唯一的数字账户标识符
username	账户句柄（不带 @）
display_name	资料页显示的完整名称
url	公开资料页面的直接链接
verified	账户是否已验证 (true/false)
premium	账户是否持有高级订阅
followers_count	粉丝总数
following_count	关注的账户数
statuses_count	发布的帖子总数
created_at	账户创建时间戳 (ISO 8601)
last_status_at	最新帖子的发布日期
avatar / avatar_static	头像图片 URL
header / header_static	横幅图片 URL
website	资料中链接的外部网站
locked	关注该账户是否需要批准
bot	账户是否被标记为机器人
note	个人简介（可能包含 HTML 标记）
accepting_messages	账户是否接受私信

2. GET /community/post — 通过用户名获取账户帖子

检索 Truth Social 账户的公开帖子动态，支持分页。每个帖子对象包含完整内容、互动指标、可见性设置以及作者的嵌入式账户快照。

输入字段：

字段	类型	必填	描述
username	string	✅	账户用户名（不带 @ 符号）
page	number	❌	分页的页码（从 1 开始）

示例请求：

GET /community/post?username=realDonaldTrump&page=1

帖子对象关键字段说明：

字段	描述
id	唯一的帖子标识符
url / uri	帖子的永久链接
content	完整的帖子正文（HTML 格式）
language	检测到的语言代码（例如 "en"）
visibility	帖子可见性（"public" 等）
created_at	帖子发布时间戳 (ISO 8601)
edited_at	编辑时间戳（如果帖子被修改过）
upvotes_count	收到的点赞数
favourites_count	收藏数（通常与点赞数一致）
reblogs_count	帖子被转发的次数
replies_count	回复数
downvotes_count	点踩数
sensitive	帖子是否被标记为敏感内容
sponsored	帖子是否为赞助/推广帖子
pinned	帖子是否在资料页置顶
reblog	如果不为 null，则表示此帖子是转发其他帖子
in_reply_to_id	父帖子的 ID（如果此帖是回复）
media_attachments	附加的图片或视频数组
mentions	提及的账户数组
tags	帖子中使用的标签数组
quote / quote_id	引用的帖子信息（如果适用）
account	嵌入式作者资料快照

注意： content 字段包含 HTML 标记。在存储或显示纯文本之前，请使用 HTML 解析器或去除标签。

使用建议

• 高效分页：使用 /community/post 端点的 page 参数。循环递增页码，当 data 返回空数组时停止。避免假设固定的页数。
• 区分转发与原创帖子：在处理帖子是否为原创内容前，检查 reblog 字段是否为 null。非 null 的 reblog 值表示转发的帖子。
• 利用 last_status_at 检查新动态：在获取账户帖子前，先通过 /community 检索资料并检查 last_status_at。如果日期自上次获取后未改变，可以跳过帖子检索以节省请求。
• 错误处理：
  • 遇到 500 错误时，实施指数退避策略并最多重试 3 次。
  • 遇到 400 错误时，请验证用户名是否不包含 @ 符号且无特殊字符。
  • 如果第 1 页的 data 返回空数组，则该账户可能没有公开帖子或不存在。

搜集汇总

背景与挑战

背景概述

Truthsocial API允许开发者通过用户名获取Truth Social平台的公开账户资料和帖子内容，包括粉丝数、认证状态、互动指标等数据，支持分页功能，适用于社交监听及研究分析。