Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
可用的 Truth Social API
Profile 使用一个用户名，User Posts 使用用户名或数字账号 ID，Post 使用一个已知 truthsocial.com 帖子 URL。
可以获取哪些 Truth Social 数据？
结果采用稳定的账号与帖子结构，来源未提供的字段保持为空。
主页身份
读取可用用户名、显示名称、简介、资料图片、网站、账号标记、地点和公开计数。
帖子内容
获取标准化帖子标识、公开 URL、正文、作者信息、发布时间和采集时间。
媒体与互动
使用可用附件、话题、提及以及点赞、评论、分享和浏览计数。
选择 Truth Social API
每个接口都有明确的来源输入范围，并共享相同的异步任务流程。
| 接口 | 输入 | 来源范围 |
|---|---|---|
| Profile | 一个用户名 | 一个公开账号 |
| User Posts | 用户名或数字用户 ID | 一页来源响应 |
| Post | 一个 truthsocial.com URL | 最多一条公开帖子 |
Truth Social 采集流程
提交任务和读取已保存结果是两个独立阶段。
1. 选择接口
根据已知公开资源选择 Profile、User Posts 或 Post。
2. 跟踪任务
保存 task_id，并轮询 /v1/tasks/{task_id} 直到成功或失败。
3. 读取结果
成功后读取 data.results.items，仅在已保存结果还有下一页时使用 next_cursor。
提供有效的公开标识，并使用 SocQ API key 鉴权。
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"}'常见使用场景
公开账号资料补全
为已知用户名补充可用身份、简介、图片、账号标记和公开计数。
账号帖子快照
保存选定账号在已知采集时间公开的一页帖子记录。
已知帖子审核
将一条公开帖子及其可用作者、媒体、时间和可见互动标准化。
范围与限制
这些接口读取采集时可用的公开数据，不提供账号管理操作。
- Profile 必须提供一个符合可选前导 @ 格式的用户名。
- User Posts 必须提供 username 或纯数字 user_id；两者同时提供时都会转发，trim 是可选布尔值。
- Post 必须提供非空 URL，解析后的主机名为 truthsocial.com 或其子域。
- 这些请求不接受 results_limit 或来源 cursor。
- 结果 cursor 和 limit 只分页读取 SocQ 已保存记录，不会继续获取来源页面。
Truth Social API 常见问题
有哪些 Truth Social API？
Profile 获取一个公开账号，User Posts 通过用户名或数字账号 ID 采集一页帖子，Post 通过已知公开帖子 URL 获取单条帖子。
User Posts 可以同时提供 username 和 user_id 吗？
可以。至少提供一个；两者都非空时，后端会同时转发，不声明其中一个优先。
next_cursor 会继续采集来源帖子吗？
不会。它只在任务成功后继续读取已经保存的记录。
采集如何计费？
每个成功的 Truth Social 任务固定消耗 0.19 个 SocQ 积分。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。
Reddit API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。
Pinterest API
获取公开 Pinterest 账号数据、解析指定 Pin、采集选定账号的 Pin，或按关键词搜索，用于创作者、内容和视觉趋势研究。
Threads API
获取公开 Threads 账号、解析指定帖子，或采集选定账号的帖子，并返回标准化身份、内容、媒体、互动和时间字段。
Bluesky API
获取公开 Bluesky 账号、解析指定帖子 URL，或采集一页账号帖子，并返回标准化身份、内容、媒体、时间和可见互动字段。