Threads Search
Threads 搜索会列出 App 针对某个关键词或话题标签排在最前面的帖子,每条都带有正文、作者、发布时间、附带的图片或视频,以及点赞、回复和转发数量。借此可以很快看清一个话题、产品或活动眼下在怎么被讨论,又是哪些账号在主导这场讨论。
Threads Search API 主要特性
- 一个查询,拿到热门帖子在 query 里填关键词或话题标签,按 App 的排序返回 Threads 为它展示的热门帖子,约 20 条。
- 每条结果都带点赞、回复和转发metrics.likes_count 是点赞数,metrics.comments_count 是回复数,metrics.shares_count 是转发数,一眼看出哪些结果最受关注。
- 发帖账号一并返回author 包含用户名、显示名称、主页 url、头像和 is_verified,带动话题的人和他们说的话同时到手。
- 图片视频与发布时间media 列出附带的图片或视频及其尺寸,published_at 标注每条帖子的发布时间,方便判断新旧。
Threads Search API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 要搜索的关键词或话题标签,例如 basketball 或某个活动标签。每次请求一个查询。 |
如何使用 Threads Search API
提交一个查询,任务完成后读取热门帖子。
- 向 /v1/threads/search 发送 {"query": "basketball"},保存返回的 task_id。
- 轮询 GET /v1/tasks/{task_id},直到状态为 succeeded。
- 从 results.items 读取帖子;has_more 为 true 时,用 results.next_cursor 获取剩余结果。
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"basketball"}'
# 0.6 credits per post returned; a search with no matches is free.Threads Search API 最佳使用场景
- 摸清一个话题的舆论走向: 搜索某个产品、活动或议题,阅读热门帖子的正文,看哪些角度和观点占了上风。
- 找出主导讨论的账号: 按帖子获得的点赞和转发给结果里的作者排序,并留意谁带有认证标识,整理成联络或关注名单。
- 监测品牌名或话题标签: 定期用同一个查询搜索,保留新出现的帖子 id 和 published_at,就形成了一份持续更新的提及记录。
Threads Search API 使用建议
- 每次搜索约返回 20 条热门帖子,宽泛的主题可以拆成几个更具体的查询,比如产品名、不同拼写和相关话题标签。
- 多个查询结果有重叠时按 id 合并,同时出现在两次搜索里的帖子只算一次。
- 在报表里给字段命名时,把 metrics.comments_count 当作回复数、metrics.shares_count 当作转发数。
- 想看某条结果下面的讨论,把它的 url 交给 Threads Post Replies API。
相关 API
除了 Threads Search 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 User Search API — 按名称或用户名查找 Threads 账号,返回用户名、显示名称、主页 URL、头像和认证状态。
- Threads User Replies API — 通过 Threads 主页 URL 采集账号最近发布的公开回复,返回回复正文、互动数据、图片视频和链接。