threads/
search

按关键词或话题标签搜索 Threads,获取 App 里展示的热门帖子,每次约 20 条,附正文、作者、点赞数、回复数、转发数、图片视频和发布时间。

Threads Search API

关键词或话题标签查询
按 Threads 排序的热门帖子
点赞、回复与转发数
每条结果 0.6 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

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

提交一个查询,任务完成后读取热门帖子。

  1. 向 /v1/threads/search 发送 {"query": "basketball"},保存返回的 task_id。
  2. 轮询 GET /v1/tasks/{task_id},直到状态为 succeeded。
  3. 从 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。

除了 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 采集账号最近发布的公开回复,返回回复正文、互动数据、图片视频和链接。

探索其他平台

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

Threads Search API — 常见问题

Threads Search API 是一个用于按关键词或话题标签搜索公开 Threads 帖子的 API。它返回该查询下的热门帖子,包含正文、作者、点赞数、回复数、转发数、图片视频和发布时间。

把话题标签像关键词一样填进 query,就会返回 Threads 在这个标签下排序靠前的帖子。

约 20 条,顺序与 Threads 对该查询的热门结果排序一致。需要最新的排在前面时,可自行按 published_at 排序。

每返回一条帖子计 0.6 积分,一次约 20 条的完整搜索大约 12 积分。