TikTok Search Users
通过关键词搜索公开账号可以快速发现垂直领域的创作者、品牌主页与热门话题相关的个人资料。标准化结果提供用户名、昵称、个人简介以及采集时的粉丝计数，满足红人筛选与受众分析需求。
主要特性
- 关键词账号检索提交任意查询关键词，发现相关公开 TikTok 账号、达人主页和品牌资料。
- 标准化主页数据返回统一的数据结构，包含用户名、昵称、头像图片、个人简介以及官方认证标记。
- 粉丝与发布指标提取采集时间点的公开粉丝数、关注数和已发布视频总数，便于评估账号体量。
- 灵活的结果上限支持设置最多 2,000 个账号上限，后端自动完成多页游标分页拼接。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
query | 必填 | 用于匹配公开 TikTok 创作者主页的搜索关键词或名称。 |
results_limit | 可选 | 返回创作者主页数量上限；默认为 100，支持 1 到 2,000 的整数。 |
如何使用
将搜索请求提交为异步任务，再通过任务状态轮询获取标准化创作者数据。
- 准备搜索关键词，并根据需求选填 results_limit（最高 2,000）。
- 携带 SocQ API key 发送 POST 请求至 /v1/tiktok/search-users。
- 轮询 /v1/tasks/{task_id} 直至状态为 succeeded。
- 从响应中的 data.results.items 读取标准化账号对象。
curl -X POST "https://api.socq.ai/v1/tiktok/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"taylor swift","results_limit":20}'
# 轮询 GET /v1/tasks/{task_id}，解析 data.results.items 中的达人数据。最佳使用场景
- 红人与达人初筛： 快速定位垂直赛道的达人账号，并比对可见粉丝量等指标进行商业合作评估。
- 品牌监控与仿冒识别： 检索品牌关键词，排查未经授权的同名账号、仿冒账号或非官方粉丝社区。
- 行业创作者数据库搭建： 持续为内部 CRM、数据管道或选品分析工具补充最新的达人账号基础资料。
使用建议
- 使用更精准的行业词或账号前缀有助于迅速收窄检索范围并提高匹配质量。
- 当 results_limit 较大时，接口会在后端自动处理翻页直至达到目标数量或没有更多结果。
- 可通过 is_verified 字段快速区分知名大 V 认证号与普通同名粉丝账号。
- 获取到目标达人 username 后，可继续调用 TikTok User Videos 进一步分析其近期作品表现。
相关 API
需要其他类型的 TikTok 公开数据时，可以使用以下 API。
- TikTok Profiles API — 按 username 获取公开主页身份、简介、账号标记和受众计数。
- TikTok Hashtags API — 按指定标签采集公开视频、创作者、媒体、声音和互动指标。
- TikTok Comments API — 采集公开顶级评论、作者、互动、提及和创作者互动标记。
- TikTok Videos API — 从视频 URL 获取创作者、文案、媒体、音乐、标签、提及和互动信息。
- TikTok Search API — 按关键词搜索公开视频，并支持排序和发布时间筛选。
- TikTok Comment Replies API — 使用 TikTok 视频 URL 和 comment_id 采集一条已知评论下的公开回复，返回作者、互动、时间和父评论上下文。
- TikTok Followers List API — 采集公开粉丝列表中可见的标准化资料，并保留来源上下文和支持的指标。
- TikTok Following List API — 采集 TikTok 账号公开可见的关注对象，返回标准化身份、简介、可见指标和来源账号信息。
- TikTok User Videos API — 按 username 采集公开个人资料视频，返回文案、创作者、媒体、时间、互动和来源账号上下文。
- TikTok Live Room Info API — 使用配对的直播间 ID 和主播 ID 查询一个已知直播间，返回状态、主播信息、封面和受众计数。
- TikTok Trending Feed API — 按 region 采集当前公开视频动态，返回创作者、文案、封面、时间和可见互动指标。
- TikTok Video Transcript API — 从公开视频 URL 提取可用字幕文本、语言、格式和来源上下文。
- TikTok Song API
- TikTok Song Videos API