truth-social/
user-posts

输入公开 username 或数字 user_id,获取该账号当前可访问的一批帖子,并返回标准化正文、作者、媒体、时间和互动数据。

Truth Social User Posts API

username 或 user_id
账号公开帖子
0.19 积分/任务
每次请求 0.19 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Truth Social User Posts

Truth Social User Posts 用于获取已知公开账号的帖子列表。每个任务通过 username 或数字 user_id 定位账号,执行一次采集,并将返回内容整理为统一的帖子记录。

Truth Social User Posts API 主要特性

  • 两种账号标识可以使用公开 username 或纯数字 user_id,至少提供其中一个。
  • 一次任务获取一批帖子每个任务执行一次账号帖子采集,返回当次可访问的公开帖子,不自动请求后续来源页面。
  • 标准化帖子内容统一返回帖子 ID、URL、正文、作者、发布时间、采集时间、媒体、话题和提及。
  • 可见互动数据在来源可用时保留点赞、评论、分享和浏览数量,缺失数据保持为空。

Truth Social User Posts API 参数

参数必填描述
username必填(至少一项)公开 username,可包含一个前导 @,其后为 1–64 个 ASCII 字母、数字、句点、下划线或连字符。不得包含首尾空格,也不接受主页 URL。
user_id必填(至少一项)纯数字账号 ID。可以代替 username,也可以与匹配的 username 一起提交。
trim可选可选布尔参数。需要明确设置该选项时提交 true 或 false;不需要传递时可省略。

如何使用 Truth Social User Posts API

提供 username 或 user_id,保存任务 ID,并在任务成功后读取帖子列表。

  1. 填写公开 username 或纯数字 user_id,通常只需提供其中一个。
  2. 将参数 POST 到 /v1/truth-social/user-posts,并保存响应中的 data.task_id。
  3. 轮询 GET /v1/tasks/{task_id},直到任务成功或失败。
  4. 任务成功后读取 data.results.items;仅在 has_more 为 true 时使用 next_cursor 继续读取已保存结果。
curl -X POST "https://api.socq.ai/v1/truth-social/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"realDonaldTrump"}'

# 轮询 GET /v1/tasks/{task_id}
# 成功后读取 data.results.items

Truth Social User Posts API 最佳使用场景

  • 账号内容快照: 保存公开账号当前可获取的一批帖子,用于归档、审核或定期比较。
  • 内容分析: 基于统一的正文、作者、媒体和时间字段进行分类、检索和下游处理。
  • 互动观察: 比较帖子公开可见的点赞、评论、分享和浏览数量,并结合 collected_at 记录观察时间。

Truth Social User Posts API 使用建议

  • 优先使用已验证的 username;已有数字 author.id 时也可以直接作为 user_id。
  • 不要把主页 URL 填入 username 或 user_id。
  • username 和 user_id 同时提交时应指向同一账号,避免产生不确定结果。
  • 该接口不接受 results_limit 或来源 cursor,每个任务只采集一次。
  • next_cursor 只用于继续读取任务已保存的结果,不会继续采集更多来源帖子。

除了 Truth Social User Posts API,需要其他类型的 Truth Social 公开数据时,可以使用以下 API。

  • Truth Social Post API — 将一个已知 Truth Social 帖子 URL 解析为标准化内容、作者上下文、媒体、时间和可获得的可见互动字段。
  • Truth Social Profile API — 通过 username 获取一个公开 Truth Social 主页,返回标准化身份、简介、资料图片、账号标记、地点、可见计数和采集上下文。

探索其他平台

还可以将 Truth Social 数据与其他已支持社交平台的公开数据结合使用。

Truth Social User Posts API — 常见问题

Truth Social User Posts API 是一个通过公开 username 或数字 user_id 获取账号公开帖子的接口,返回标准化正文、作者、媒体、时间和可见互动数据。

至少提供一个。一般使用 username;如果已有账号返回的数字 ID,也可以使用 user_id。

可以,但两者都会被传入采集请求,因此应确保它们指向同一个账号。

trim 是可选布尔参数。只有需要明确控制该选项时才设置 true 或 false,否则可以省略。

不会。每个任务只执行一次来源采集,next_cursor 仅用于分页读取已经保存的结果。

每个成功任务固定消耗 0.19 个积分,不随当次返回的帖子数量变化。