按名称或用户名搜索 Threads 账号
查看 Threads 公开数据 API 的全部接口 →在必填的 query 中提供姓名、用户名或账号搜索关键词。响应包含 status、request_id 与 data.results，候选资料位于 data.results[].node。已观察到的字段包括 username、字符串 pk 和 id、full_name、is_verified、follower_count 与 profile_pic_url。查询完整资料或账号帖子前，应先核实并选定目标 username；显示名称相似并不能证明是同一个人或账号。 实测一个不存在的随机用户名返回成功响应与 data.results:[]。空数组表示该查询没有匹配结果，不代表服务故障，也不能单独证明某个账号已被删除。结果不是完整账号目录，接口没有开放分页参数。
API 功能
从名称找到候选用户名 只知道名称或关键词时，也能获取可能匹配的 Threads 用户名，无需预先掌握精确账号名。
用于区分同名账号的字段 选定账号前，核对 data.results[].node 中的 full_name、username、is_verified 与 profile_pic_url。
候选账号键与显示名称分离 以字符串保存每个候选的 pk 与 id，避免使用可能变化或重名的显示名称作为账号引用键。
明确呈现无匹配结果 成功搜索也可以返回空 data.results 数组，便于账号选择界面如实展示没有候选的状态。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/threads-scraper/search-users API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/threads-scraper/search-users?key=<API_KEY>&query=zuck'
curl -X GET 'https://api.opendata-api.com/api/project/threads-scraper/search-users?key=<API_KEY>&query=zuck'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 账号选择界面：按用户输入的名称搜索，展示候选用户名与认证标记，交由人工区分同名账号。
- 品牌用户名解析：将公司或发言人的名称转为候选账号名，再补充最终选中账号的公开资料。
- 创作者候选初选：通过相关词发现可能的账号，随后人工审核资料和帖子，不假设搜索覆盖所有创作者。
- 目录入库审核：将有歧义或为空的账号搜索结果交给研究人员，避免把相似显示名称自动关联到客户记录。
常见问题
不知道精确用户名时，可以用姓名搜索吗？
可以。query 接受姓名、用户名或搜索关键词。候选账号位于 data.results[].node，后续查询资料或账号帖子时使用候选返回的 username。
显示名称匹配，就能确认账号属于某个人吗？
不能。相似名称可能对应不同账号。选定候选前，应核对 username、full_name、认证标记与其他公开背景；仅凭搜索结果无法确认身份或账号归属。
data.results 为空数组是错误吗？
不一定。实测一个不存在的用户名返回 status:ok 与 data.results:[]。这是该查询的有效无匹配结果，不是服务故障的证据，也不能据此确定账号已删除。
能对用户搜索翻页，建立完整账号目录吗？
用户搜索没有开放分页输入。应将结果视为与当前查询有关的一组候选，而不是完整目录；不要传入未文档化的 cursor 或 page 参数。