threads/
search-users

按名称或用户名查找 Threads 账号,返回 Threads 推荐的匹配结果,通常不超过 10 个,每个都带用户名、显示名称、主页链接、头像和认证状态。

Threads User Search API

名称或用户名查询
约 10 个匹配账号
认证状态
每条结果 0.6 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Threads User Search

Threads 用户搜索给出的是 App 针对输入的名字或用户名推荐的一组账号,每个账号由用户名、显示名称、主页链接、头像和认证标识来识别。有了这些身份信息,就能把真正的个人或品牌和名字相近的账号区分开,也能把一串名字落实成确认无误的 Threads 主页。

Threads User Search API 主要特性

  • 名称和用户名都能搜query 可以填显示名称,也可以填用户名,返回 Threads 为它推荐的账号,通常不超过 10 个。
  • 身份字段可直接接着用每个结果都返回 username、name 和 url,url 是 /@username 形式的主页链接,正好是其他 Threads 接口要求的输入。
  • 认证标识和头像帮助辨认几个结果重名时,is_verified 和 avatar_url 能帮你挑出真正要找的账号。

Threads User Search API 参数

参数必填描述
query必填个人或品牌的名称,或 Threads 用户名,例如 shams。

如何使用 Threads User Search API

搜索一个名字,读取推荐的账号。

  1. 向 /v1/threads/search-users 发送 {"query": "shams"}。
  2. 用返回的 task_id 轮询 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-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"shams"}'

# 0.6 credits for each account returned.

Threads User Search API 最佳使用场景

  • 采集内容前先确认账号: 核对 username、显示名称和 is_verified,确认找对了人,再用它的 url 去拉取该账号的帖子、回复或转发。
  • 把名单转换成 Threads 主页: 逐个搜索达人或媒体名单上的名字,保留带认证标识的匹配结果的 url,整理出一列 Threads 主页链接。
  • 排查仿冒账号: 搜索一个品牌或公众人物,查看名称和头像几乎相同、却没有认证标识的结果,找出可能的冒名账号或粉丝号。

Threads User Search API 使用建议

  • 第一次没搜到想要的账号时,全名和可能的用户名都试一次,query 两种都能匹配。
  • 常见名字会返回好几个相似账号,挑选时结合 username 和 is_verified 判断,不要直接取第一行。
  • 选定的 url 可以直接交给 Threads User Posts、User Replies 或 User Reposts API,它们接受的正是这种主页链接。

除了 Threads User 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 Search API — 按关键词或话题标签搜索 Threads 热门帖子,返回正文、作者、点赞数、回复数、转发数、图片视频和发布时间。
  • Threads User Replies API — 通过 Threads 主页 URL 采集账号最近发布的公开回复,返回回复正文、互动数据、图片视频和链接。

探索其他平台

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

Threads User Search API — 常见问题

Threads User Search API 是一个用于根据名称或用户名查找 Threads 账号的 API。它返回 Threads 推荐的账号,每个都带用户名、显示名称、主页链接、头像和认证状态。

通常不超过 10 个,与 Threads 针对你输入的名称或用户名给出的推荐一致。

搜索结果主要用于识别账号。把匹配结果的 url 交给 Threads Profiles API,即可获取它的简介、网站和可见的粉丝数。

每返回一个账号计 0.6 积分,一次返回 10 个账号的搜索计 6 积分。