Threads User Replies
Threads 用户回复是一个账号在别人帖子下面留下的回应,每条都有自己的正文、发布时间、附带的图片视频、链接,以及收到的点赞、回复和转发数量。回复比正式发帖更随手、更少修饰,最能看出账号的语气、专业程度和对话方式,考察创作者、跟踪发言人或研究客户服务时都用得上。
Threads User Replies API 主要特性
- 拿到的是回复,不是发帖提交 https://www.threads.com/@reuters 这样的主页链接,返回该账号回复别人的内容,即最近的公开回复,最多约 25 条。
- 每条回复的正文、图片视频和链接text 是回复内容,media 是附带的图片或视频,url 可以在 Threads 上打开这条回复所在的讨论。
- 每条回复的反响metrics.likes_count、metrics.comments_count 和 metrics.shares_count 分别是这条回复收到的点赞、后续回复和转发数量。
Threads User Replies API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | Threads 主页链接,格式为 /@{username},threads.com 和 threads.net 均可,例如 https://www.threads.com/@reuters。 |
如何使用 Threads User Replies API
提交主页链接,读取每个账号最近的回复。
- 向 POST /v1/threads/user-replies 发送 {"urls": ["https://www.threads.com/@reuters"]},保存 task_id。
- 轮询 GET /v1/tasks/{task_id},直到任务成功。
- 从 results.items 读取回复;has_more 为 true 时,用 results.next_cursor 加载下一页。
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@reuters"]}'
# 0.5 credits per reply returned.Threads User Replies API 最佳使用场景
- 合作前考察创作者: 阅读创作者最近的回复正文,在精修过的帖子之外判断其语气、专业度和对待粉丝的方式。
- 跟踪发言人的公开回复: 定期采集高管或发言人的回复,按 published_at 记录新增内容,不漏掉在对话里说出的表态。
- 研究品牌怎样处理用户对话: 分析品牌账号的回复,按 published_at 看回复频率,再看哪些回复获得点赞,了解其客服和社区团队在公开场合如何回应。
Threads User Replies API 使用建议
- 请提交主页链接而不是帖子链接;想看别人在某条帖子下的回复,请改用 Threads Post Replies API。
- 每次只覆盖最近的回复,每个账号最多约 25 条,想保留更长的记录就定期采集,并按 id 去重。
- metrics.comments_count 表示这条回复本身又收到了多少回复,可以借此找出演变成长讨论的对话。
- 想知道一条回复是在回应什么,打开它的 url 即可,链接会把回复放在原讨论里展示。
相关 API
除了 Threads User Replies API,需要其他类型的 Threads 公开数据时,可以使用以下 API。
- Threads Posts API — 从受支持的 Threads 帖子 URL 采集公开正文、作者信息、媒体、时间和可见互动指标。
- Threads Profiles API — 从受支持的 Threads 主页 URL 采集公开身份、简介、图片、网站、可见账号数量和采集上下文。
- Threads User Posts API — 通过 Threads 主页 URL 和每个主页的结果上限发现公开帖子,返回标准化正文、作者、媒体、时间、可见互动指标和来源上下文。
- Threads Post Replies API — 通过帖子 URL 采集 Threads 帖子下的回复,返回回复正文、作者、点赞数和回复数、图片视频,以及所回复帖子的 ID。
- Threads Search API — 按关键词或话题标签搜索 Threads 热门帖子,返回正文、作者、点赞数、回复数、转发数、图片视频和发布时间。
- Threads User Reposts API — 通过 Threads 主页 URL 采集账号最近转发的帖子,每条以原帖形式返回原作者、正文、互动数据和图片视频。