TikTok 达人怎么查？粘 @handle，30 秒拿到完整账号画像

什么场景该用 handle 查询，而不是关键词发现

两件不同的事，用两个不同的工具。需要在某个垂类里圈一批人时， 用关键词发现。下面这些场景，用 handle 查询：

• 邮件里收到一位达人主动来谈合作，要先看看对方什么底子。
• 看到竞品的广告视频带了某位达人，想反查他的数据。
• 达人 MCN 发来一份 deck，需要做尽调验真。
• 同事在 Slack 丢来一个 TikTok 链接——「这个人值得签合同吗？」

关键词发现是横向广撒网；handle 查询是单点纵向钻深。

查询返回什么

/kols/[username] 上的「活跃度 & 发布节奏」卡片 会渲染四个核心数字：

1. 账号年龄——来自 TikTok 的 user.createTime。新 TikTok 账号（不到 6 个月） 通常还没积累起促成转化的受众信任度。多年账号 + 稳定更新节奏是最稳的选择。
2. 首条视频——抓取批次里 min(video.created_at)。 能让你看到达人真正的内容履历（vs 单纯的注册日期： 有些人注册账号后多年才开始发）。
3. 最新视频——max(video.created_at)。 如果距今超过 30 天，KOLens 用 琥珀色 高亮—— 这是「悄悄停更」信号。
4. 发布节奏——相邻两条视频间隔的天数中位数， 外加近 30 天的「视频 / 周」频率。

核心四项之外还有什么

同一次查询会带出平均 / 中位数 / 最高播放、平均点赞、播放 / 粉丝比、互动率， 以及一条 6 字段的账号概况（粉丝、主页点赞、累计 hearts 等）。 外加最近 50 条视频以可点击网格形式呈现——一眼看出账号内容调性。

如何查询一个 handle

1. 1

   登录后打开 /kols。

   查询框位于页面顶部，就在筛选面板正上方。无需另开页面—— 它和你已经积累的 KOL 数据库并列在一起。
2. 2

   任意格式粘进 handle。

   解析器接受 @mr.kwanga、mr.kwanga（无 @）、 或完整 URL 如 https://www.tiktok.com/@mr.kwanga?lang=zh-Hans。 query 参数和末尾斜杠会自动清掉。
3. 3

   选要采样多少条视频（默认 50）。

   采样越多，发布节奏估算越精确。30 条够做粗判； 200 条对一般业务场景偏 overkill。30 / 50 / 100 / 200 这几档都收 1 credit。
4. 4

   点击 Look up · 1c，约 30 秒后跳转到详情页。

   完整 profile 页展示四个核心卡片（账号年龄、首 / 末视频、发布节奏）、 联系方式条，以及最近 50 条视频的可点击网格。

查询失败的几种情况

• 404「Account may be private…」—— TikTok 没有返回这个 handle 的视频。可能原因：私密账号、已删除、区域锁定、shadowban。 KOLens 会自动退还 credit。
• 402「Not enough credits」——余额不足以支付一次查询。 在 /pricing 充值。
• 503「Could not verify credit balance」—— 后端连不上 Supabase。60 秒后重试；持续报错请查管理员诊断接口。

进阶：通过 Claude 插件调用

装了 KOLens Cowork 插件 之后，在任何 Claude 对话里说一句 「帮我在 TikTok 上查一下 @mr.kwanga」 即可。 插件调同样的接口，同样收 1 credit，profile 直接在对话里渲染出来。 非常适合写投放 brief 写到一半时随手做一次尽调。