Truth Social User Posts
Truth Social User Posts 用于获取已知公开账号的帖子列表。每个任务通过 username 或数字 user_id 定位账号，执行一次采集，并将返回内容整理为统一的帖子记录。
主要特性
- 两种账号标识可以使用公开 username 或纯数字 user_id，至少提供其中一个。
- 一次任务获取一批帖子每个任务执行一次账号帖子采集，返回当次可访问的公开帖子，不自动请求后续来源页面。
- 标准化帖子内容统一返回帖子 ID、URL、正文、作者、发布时间、采集时间、媒体、话题和提及。
- 可见互动数据在来源可用时保留点赞、评论、分享和浏览数量，缺失数据保持为空。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
username | 必填（至少一项） | 公开 username，可包含一个前导 @，其后为 1–64 个 ASCII 字母、数字、句点、下划线或连字符。不得包含首尾空格，也不接受主页 URL。 |
user_id | 必填（至少一项） | 纯数字账号 ID。可以代替 username，也可以与匹配的 username 一起提交。 |
trim | 可选 | 可选布尔参数。需要明确设置该选项时提交 true 或 false；不需要传递时可省略。 |
如何使用
提供 username 或 user_id，保存任务 ID，并在任务成功后读取帖子列表。
- 填写公开 username 或纯数字 user_id，通常只需提供其中一个。
- 将参数 POST 到 /v1/truth-social/user-posts，并保存响应中的 data.task_id。
- 轮询 GET /v1/tasks/{task_id}，直到任务成功或失败。
- 任务成功后读取 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最佳使用场景
- 账号内容快照： 保存公开账号当前可获取的一批帖子，用于归档、审核或定期比较。
- 内容分析： 基于统一的正文、作者、媒体和时间字段进行分类、检索和下游处理。
- 互动观察： 比较帖子公开可见的点赞、评论、分享和浏览数量，并结合 collected_at 记录观察时间。
使用建议
- 优先使用已验证的 username；已有数字 author.id 时也可以直接作为 user_id。
- 不要把主页 URL 填入 username 或 user_id。
- username 和 user_id 同时提交时应指向同一账号，避免产生不确定结果。
- 该接口不接受 results_limit 或来源 cursor，每个任务只采集一次。
- next_cursor 只用于继续读取任务已保存的结果，不会继续采集更多来源帖子。
相关 API
需要其他类型的 Truth Social 公开数据时，可以使用以下 API。
- Truth Social Post API — 将一个已知 Truth Social 帖子 URL 解析为标准化内容、作者上下文、媒体、时间和可获得的可见互动字段。
- Truth Social Profile API — 通过 username 获取一个公开 Truth Social 主页，返回标准化身份、简介、资料图片、账号标记、地点、可见计数和采集上下文。