truth-social/
post

输入一个公开 Truth Social 帖子 URL,获取标准化帖子正文、作者、媒体、发布时间和可见互动数据。

Truth Social Post API

帖子 URL
单条帖子详情
0.19 积分/任务
每次请求 0.19 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Truth Social Post

Truth Social Post 用于解析一条已知的公开帖子。提交帖子 URL 后,异步任务最多返回一条标准化记录,适合链接补全、内容审核和定期互动快照。

Truth Social Post API 主要特性

  • 按 URL 精确查询每次提交一个 truthsocial.com 公开帖子 URL,不进行关键词搜索。
  • 完整帖子内容返回帖子 ID、公开 URL、正文、发布时间和采集时间。
  • 作者与媒体在公开可用时保留作者身份、头像、账号状态、媒体、话题和提及。
  • 互动数据快照记录采集时可见的点赞、评论、分享和浏览数量,缺失数据保持为空。

Truth Social Post API 参数

参数必填描述
url必填必填。完整的 Truth Social 公开帖子 URL,解析后的主机名必须为 truthsocial.com 或其子域。请包含 http 或 https,并提交真实帖子路径。

如何使用 Truth Social Post API

提交一个真实公开帖子 URL,保存任务 ID,并在任务完成后读取帖子详情。

  1. 使用默认公开帖子 URL,或替换为需要查询的完整 Truth Social 帖子链接。
  2. 将 url POST 到 /v1/truth-social/post,并保存响应中的 data.task_id。
  3. 轮询 GET /v1/tasks/{task_id},直到任务成功或失败。
  4. 任务成功后,从 data.results.items 读取标准化帖子记录。
curl -X POST "https://api.socq.ai/v1/truth-social/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://truthsocial.com/@realDonaldTrump/117091934703272898"}'

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

Truth Social Post API 最佳使用场景

  • 帖子链接补全: 将已有帖子链接转换为可检索的正文、作者、时间和来源字段。
  • 指定内容审核: 获取选定公开帖子的正文、作者和附件,供人工或自动流程检查。
  • 互动变化跟踪: 按计划重复查询同一帖子,结合 collected_at 比较公开互动数据。

Truth Social Post API 使用建议

  • 提交完整的真实帖子 URL,而不是主页、搜索页或其它 Truth Social 页面。
  • URL 必须包含 http 或 https,主机名必须为 truthsocial.com 或其子域。
  • 格式通过校验不代表帖子一定存在或仍然公开可访问。
  • 作者、媒体、话题、提及和互动数据都可能为空,使用时应保留空值。
  • 该接口不接受 results_limit 或来源 cursor,每个任务最多返回一条帖子记录。

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

  • Truth Social Profile API — 通过 username 获取一个公开 Truth Social 主页,返回标准化身份、简介、资料图片、账号标记、地点、可见计数和采集上下文。
  • Truth Social User Posts API — 通过 username 或纯数字账号 ID 采集一个源站页面的公开 Truth Social 帖子,返回标准化内容、作者、媒体、时间和可见互动。

探索其他平台

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

Truth Social Post API — 常见问题

Truth Social Post API 是一个通过公开帖子 URL 获取标准化帖子详情的接口,返回正文、作者、媒体、发布时间和可见互动数据。

提交包含 http 或 https 的完整公开帖子链接,主机名必须为 truthsocial.com 或其子域。

不建议。接口用于解析具体帖子,应提交真实帖子路径;其它同域页面即使通过主机校验,也可能无法返回结果。

最多一条。每个任务只解析输入 URL 对应的帖子详情。

作者资料、媒体、话题、提及或互动计数可能未公开或来源没有返回,接口会保留为空。

每个成功任务固定消耗 0.19 个积分,不随返回字段数量变化。