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
搜索一个名字,读取推荐的账号。
- 向 /v1/threads/search-users 发送 {"query": "shams"}。
- 用返回的 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-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,它们接受的正是这种主页链接。
相关 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 采集账号最近发布的公开回复,返回回复正文、互动数据、图片视频和链接。