Threads Posts
Threads 帖子是公开发布的文字内容，可包含作者身份、媒体引用、发布时间以及可见的点赞、评论、转发和分享数量。将这些字段整理为帖子记录，可以支持指定内容研究、来源审阅、内容比较和分时点互动分析。
主要特性
- 按帖子 URL 精确解析将 threads.com 或 threads.net 上的公开 /@username/post/{post_id} URL 解析为对应帖子的记录，而不是扩展为主页帖子流。
- 帖子内容与作者归属返回帖子标识、来源 URL、正文，以及可用的作者 ID、username、显示名称和主页 URL，便于追溯每条记录。
- 媒体与可见互动快照为每条帖子记录保留标准化媒体引用、发布时间、采集时间以及可见的点赞、评论、转发和分享数量。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 必填的公开 Threads 帖子 URL 列表；域名使用 threads.com 或 threads.net，路径采用 /@username/post/{post_id}。 |
如何使用
提交已经掌握的公开 Threads 帖子，跟踪异步任务，并使用 cursor 分页读取标准化结果。
- 准备一个或多个 threads.com 或 threads.net 上使用 /@username/post/{post_id} 路径的公开 Threads 帖子 URL。
- 将链接作为 urls 提交到 /v1/threads/posts，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 读取 data.results.items；当 has_more 为 true 时，使用返回的 next_cursor 继续请求。
curl -X POST "https://api.socq.ai/v1/threads/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；has_more 为 true 时继续使用 next_cursor最佳使用场景
- 补全指定帖子清单： 将已知帖子 URL 转换为包含 ID、正文、作者字段、媒体、时间和来源链接的记录，形成边界明确的数据集。
- 审阅公开内容与作者归属： 结合正文、媒体引用、作者身份和原始 URL 审阅选定内容，并保留其公开来源。
- 比较分时点互动快照： 将 likes_count、comments_count、reposts_count 和 shares_count 与 collected_at 配对，比较不同采集时间的观察结果。
使用建议
- 提交前按 /@username/post/{post_id} 路径校验每个 URL，避免主页和其它 Threads 路径导致请求失败。
- 批量提交前按帖子路径去重，避免同一帖子使用不同受支持域名时产生重复任务。
- 仅在已经掌握帖子 URL 时使用此 endpoint；不要传入 results_limit，因为它不会发现主页帖子流或展开帖子回复。
- 允许正文、作者字段、媒体、发布时间和单项互动指标为空，避免公开帖子只暴露部分字段时中断结果处理。
- 将 collected_at 与可见互动字段一同保存，保留每次快照的实际观察时间。
相关 API
需要其他类型的 Threads 公开数据时，可以使用以下 API。
- Threads Profiles API — 从受支持的 Threads 主页 URL 采集公开身份、简介、图片、网站、可见账号数量和采集上下文。
- Threads User Posts API — 通过 Threads 主页 URL 和每个主页的结果上限发现公开帖子，返回标准化正文、作者、媒体、时间、可见互动指标和来源上下文。