ThreadsThreads 搜索Threads 回复API 指南

Threads 搜索 API:搜索帖子与用户,采集回复和转发

SocQ 新增 5 个 Threads 接口:按关键词和话题标签搜索帖子、搜索用户、帖子下的回复、用户的回复和用户的转发,附请求示例与按结果计费价格。

SocQ更新于 2026年11月19日阅读约 5 分钟

SocQ 最早的 Threads 接口用于读取公开主页、单条帖子和用户的帖子。2026-11-17 又上线了 5 个接口。其中两个是 搜索:按关键词或话题标签找帖子,按名称找账号。另外三个读取 对话与传播:帖子下的回复、账号在别处留下的回复,以及它转发的帖子。

本文说明每个新接口返回什么、请求怎么写、价格多少、何时使用。这些接口与 Meta 官方 Threads API 及其他服务商的对比,请参见 Threads API 替代方案。

快速回答: 带上 Authorization: Bearer $SOCQ_API_KEY,把 query 发送到 POST /v1/threads/search 或 /search-users,或把 Threads URL 放进 urls 发送到 /post-replies、/user-replies 或 /user-reposts。轮询 GET /v1/tasks/{task_id} 直到 status 为 succeeded,再读取 data.results.items。价格为每条结果 0.3 到 0.6 credits(按每 credit $0.005 计为 $0.0015 到 $0.003),没有基础费用。

5 个新的 Threads 接口

接口返回内容输入价格
Search关键词或话题标签的热门帖子,约 20 条,含正文、作者、点赞、回复、转发、媒体和时间query每条帖子 0.6 credits($0.003)
User Search匹配名称或用户名的账号,通常最多 10 个,含显示名称、头像和认证状态query每个账号 0.6 credits($0.003)
Post Replies帖子下的回复,每条帖子约 20 条,含作者、点赞、回复、媒体和时间帖子 URL每条回复 0.3 credits($0.0015)
User Replies账号最近的公开回复,最多约 25 条,含互动数据和媒体主页 URL每条回复 0.5 credits($0.0025)
User Reposts账号最近转发的帖子,最多约 25 条,每条带原作者主页 URL每条帖子 0.5 credits($0.0025)

搜索 Threads

Threads Search:按关键词或话题标签搜帖子

Threads Search API 以 App 内相同的方式搜索 Threads,返回关键词或话题标签的热门帖子。每条帖子包含正文、作者、点赞、回复、转发、媒体和发布时间。这是了解某个话题、产品或事件在 Threads 上如何被讨论、并找到推动讨论的账号的最快方式。

curl -X POST "https://api.socq.ai/v1/threads/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "basketball"
  }'

每次搜索返回 Threads 为该查询展示的热门帖子,约 20 条。互动数据位于 metrics 下:likes_count、comments_count 和 shares_count。参见 Search 文档。

Threads User Search:按名称找账号

Threads User Search API 按名称或用户名查找账号。每个匹配结果返回用户名、显示名称、主页 URL、头像和认证状态。可在拉取帖子或回复前确认正确的账号,或把一份名单转换为 Threads 主页用于网红研究。

curl -X POST "https://api.socq.ai/v1/threads/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "shams"
  }'

每次搜索返回 Threads 推荐的账号,通常最多 10 个。参见 User Search 文档。

读取对话与转发

Threads Post Replies:帖子下的对话

Threads Post Replies API 读取帖子下的对话。每条回复包含正文、作者、点赞数和回复数、附带媒体和时间,以及所回复帖子的 post_id。可用于评估公告的反响、从品牌帖子中收集客户反馈,或找出创作者受众中最活跃的人。

curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]
  }'

使用 /@{username}/post/{code} 形式的帖子 URL。每条帖子返回 Threads 在其下展示的回复,约 20 条。参见 Post Replies 文档。

Threads User Replies:账号如何与他人交流

Threads User Replies API 返回账号最近的公开回复,含正文、点赞、回复、媒体、时间以及每条回复的链接。回复比精心打磨的帖子更直接地体现语气和专业度,适合核查创作者、监测发言人,或研究品牌如何处理客户对话。

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"]
  }'

使用 https://www.threads.com/@username 形式的主页 URL。每个主页最多返回约 25 条回复。参见 User Replies 文档。

Threads User Reposts:账号在为谁扩散

Threads User Reposts API 返回账号选择转发的帖子。每一行都是原帖,含作者、正文、互动数据和媒体。转发历史是亲近关系的直接信号:它勾勒出创作者信任的声音、品牌推广的合作方,以及在社区中传播的内容。

curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.threads.com/@shams"]
  }'

每个主页最多返回约 25 条最近的转发;author 是原发布者,而不是转发的账号。参见 User Reposts 文档。

一个简单的研究流程

  1. 对产品名或话题标签运行 Search,找到大家积极互动的帖子。
  2. 把表现最好的帖子 URL 传给 Post Replies,阅读大家的反应。
  3. 用 User Search 把讨论中出现的名字解析为账号,再对这些主页调用 User Replies 和 User Reposts,看他们如何交流、为谁扩散。
  4. 账号自己的帖子或主页资料,请使用更早上线的 User Posts 和 Profiles 接口。

认证与异步任务流程

每个请求都携带 API key 和 JSON 内容类型:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

每次提交都会启动一个后台任务:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

提交响应返回 data.task_id 和 data.status。用同一个 key 轮询任务:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

任务处于 queued、running 或 failed 时,响应只包含任务元数据;failed 时读取 error_message。任务为 succeeded 时,同一响应会带上第一页标准化记录,位于 data.results.items。limit 默认 50,最大 500。若 has_more 为 true,把 results.next_cursor 作为 cursor 传入即可读取下一页。fields 最多接受 50 个以逗号分隔的字段或点路径。

客户端超时不会取消任务,因此请用同一个 task_id 继续查询,不要重新提交而为重复采集付费。也可以在提交请求中加入 callback_url,任务结束时会收到一次带任务摘要的 POST。

典型任务的费用

  • 一次关键词搜索返回 20 条帖子:20 × 0.6 = 12 credits,$0.06。
  • 10 条帖子下的回复,每条约 20 条:200 × 0.3 = 60 credits,$0.30。
  • 10 个账号的回复和转发,每项约 25 条:500 × 0.5 = 250 credits,$1.25。

常见问题

搜索结果能翻到 20 条以后吗?

Search 返回 Threads 为该查询展示的热门帖子,每次约 20 条。要扩大覆盖面,可以把相关关键词或话题标签作为单独的搜索运行。

需要 Threads 或 Instagram 登录吗?

不需要。请求中只包含你的 SocQ API key 以及查询词或公开的 Threads URL,不涉及任何 Threads 账号凭据。

User Reposts 会显示是谁转发的吗?

你是针对某一个主页发起请求的,所以每一行都是该主页转发的。每行的 author 是原发布者。

可以一次发送多个主页或帖子吗?

可以。Post Replies、User Replies 和 User Reposts 都在 urls 中接收列表,结果数量按每个 URL 计算。

在哪里查看全部 Threads 接口和价格?

见 Threads 平台页 和 价格页。

THREADS API

使用公开的 Threads 输入测试工作流

提交公开输入,获取带有可追溯来源上下文的标准化记录。

查看 Threads API