truth-social/
profile

输入一个公开 Truth Social 用户名,获取标准化账号资料,包括身份、简介、头像、封面、网站、账号状态和可见统计数据。

Truth Social Profile API

用户名查询
账号资料
0.19 积分/任务
每次请求 0.19 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Truth Social Profile

Truth Social Profile 用于查询已知的公开账号。提交 username 后,异步任务会返回一条标准化账号记录,方便在资料补全、账号审核和定期快照中直接使用。

Truth Social Profile API 主要特性

  • 按用户名精确查询每次查询一个已知公开用户名,不进行模糊搜索,也不接受个人主页 URL。
  • 统一账号身份返回账号 ID、username、显示名称、公开主页、简介和采集时间等基础字段。
  • 完整资料字段在公开可用时返回头像、封面、网站、地点、认证状态和私密状态。
  • 可见数据快照记录采集时可见的粉丝数、关注数和帖子数,便于后续比较。

Truth Social Profile API 参数

参数必填描述
username必填必填。公开 username,可包含 1–64 个 ASCII 字母、数字、句点、下划线或连字符。接口校验允许一个前导 @,但建议提交不带 @ 的规范用户名;不接受主页 URL。

如何使用 Truth Social Profile API

提交一个公开用户名,保存任务 ID,并在任务完成后读取账号结果。

  1. 输入已知的 Truth Social username,例如 realDonaldTrump。为保证解析稳定,建议不要带前导 @。
  2. 将 username POST 到 /v1/truth-social/profile,并保存响应中的 data.task_id。
  3. 轮询 GET /v1/tasks/{task_id},直到 data.status 变为 succeeded 或 failed。
  4. 任务成功后,从 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

Truth Social Profile API 最佳使用场景

  • 账号资料补全: 为已有 username 补充公开身份、简介、资料图片、网站和可见统计数据。
  • 账号审核: 将公开账号统一为固定字段,便于内部审核、分类和人工查看。
  • 资料变化跟踪: 定期保存账号快照,结合 collected_at 比较简介、图片、状态和统计数据变化。

Truth Social Profile API 使用建议

  • 优先保存不带 @ 的规范 username,避免同一账号出现多种写法。
  • 格式正确不代表账号一定存在、公开或可访问。
  • 头像、封面、网站、地点、状态和统计数据都可能为空,使用时应保留空值。
  • 该接口只查询账号资料,不返回账号帖子。
  • 不要提交 results_limit 或来源 cursor;每个任务只执行一次账号查询。

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

  • Truth Social Post API — 将一个已知 Truth Social 帖子 URL 解析为标准化内容、作者上下文、媒体、时间和可获得的可见互动字段。
  • Truth Social User Posts API — 通过 username 或纯数字账号 ID 采集一个源站页面的公开 Truth Social 帖子,返回标准化内容、作者、媒体、时间和可见互动。

探索其他平台

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

Truth Social Profile API — 常见问题

Truth Social Profile API 是一个通过公开 username 获取标准化账号资料的接口,返回身份、简介、资料图片、账号状态和可见统计数据。

建议填写不带 @ 的公开 username,例如 realDonaldTrump。支持字符为 ASCII 字母、数字、句点、下划线和连字符,长度最多 64 个字符。

可能包含账号 ID、username、显示名称、主页 URL、简介、头像、封面、网站、地点、认证与私密状态,以及粉丝数、关注数和帖子数。

参数校验只确认 username 格式,账号还可能不存在、已设为私密或暂时无法公开访问。

不会。该接口只返回账号资料,获取公开帖子请使用 Truth Social User Posts API。

每个成功任务固定消耗 0.19 个积分,失败任务按退款规则处理。