Truth Social Profile
Truth Social Profile 用于查询已知的公开账号。提交 username 后，异步任务会返回一条标准化账号记录，方便在资料补全、账号审核和定期快照中直接使用。
主要特性
- 按用户名精确查询每次查询一个已知公开用户名，不进行模糊搜索，也不接受个人主页 URL。
- 统一账号身份返回账号 ID、username、显示名称、公开主页、简介和采集时间等基础字段。
- 完整资料字段在公开可用时返回头像、封面、网站、地点、认证状态和私密状态。
- 可见数据快照记录采集时可见的粉丝数、关注数和帖子数，便于后续比较。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
username | 必填 | 必填。公开 username，可包含 1–64 个 ASCII 字母、数字、句点、下划线或连字符。接口校验允许一个前导 @，但建议提交不带 @ 的规范用户名；不接受主页 URL。 |
如何使用
提交一个公开用户名，保存任务 ID，并在任务完成后读取账号结果。
- 输入已知的 Truth Social username，例如 realDonaldTrump。为保证解析稳定，建议不要带前导 @。
- 将 username POST 到 /v1/truth-social/profile，并保存响应中的 data.task_id。
- 轮询 GET /v1/tasks/{task_id}，直到 data.status 变为 succeeded 或 failed。
- 任务成功后，从 data.results.items 读取标准化账号记录。
curl -X POST "https://api.socq.ai/v1/truth-social/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"realDonaldTrump"}'
# 轮询 GET /v1/tasks/{task_id}
# 成功后读取 data.results.items最佳使用场景
- 账号资料补全： 为已有 username 补充公开身份、简介、资料图片、网站和可见统计数据。
- 账号审核： 将公开账号统一为固定字段，便于内部审核、分类和人工查看。
- 资料变化跟踪： 定期保存账号快照，结合 collected_at 比较简介、图片、状态和统计数据变化。
使用建议
- 优先保存不带 @ 的规范 username，避免同一账号出现多种写法。
- 格式正确不代表账号一定存在、公开或可访问。
- 头像、封面、网站、地点、状态和统计数据都可能为空，使用时应保留空值。
- 该接口只查询账号资料，不返回账号帖子。
- 不要提交 results_limit 或来源 cursor；每个任务只执行一次账号查询。
相关 API
需要其他类型的 Truth Social 公开数据时，可以使用以下 API。
- Truth Social Post API — 将一个已知 Truth Social 帖子 URL 解析为标准化内容、作者上下文、媒体、时间和可获得的可见互动字段。
- Truth Social User Posts API — 通过 username 或纯数字账号 ID 采集一个源站页面的公开 Truth Social 帖子，返回标准化内容、作者、媒体、时间和可见互动。