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 文档。
一个简单的研究流程
- 对产品名或话题标签运行 Search,找到大家积极互动的帖子。
- 把表现最好的帖子 URL 传给 Post Replies,阅读大家的反应。
- 用 User Search 把讨论中出现的名字解析为账号,再对这些主页调用 User Replies 和 User Reposts,看他们如何交流、为谁扩散。
- 账号自己的帖子或主页资料,请使用更早上线的 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 平台页 和 价格页。