Kwai Profile
Kwai 主页是包含 username、显示名称、简介、主页图片、网站、账号标记以及可见粉丝数、关注数和帖子数的公开账号页面。这些身份资料和时间点信号可用于补全主页记录、比较账号和持续监测公开快照。
主要特性
- 两种受支持的标识可通过有效 username、kwai.com 或 kwai-video.com 的主页 URL，或在同一任务中同时提供两种标识来解析一个公开主页。
- 标准化公开身份在一致的账号记录中返回主页 ID、来源 URL、username、显示名称、简介文本、头像、封面图和网站。
- 带观察时间的账号信号将可用认证与隐私标记、可见粉丝数、关注数、帖子数和 collected_at 一同保存为时间点主页快照。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
username | 必填（至少一项） | username 与 url 至少填写一个。username 可带一个前导 @，随后使用 1 至 64 个 ASCII 字母、数字、点、下划线或连字符。 |
url | 必填（至少一项） | url 与 username 至少填写一个。非空地址解析后的 hostname 必须为 kwai.com、kwai-video.com 或两者的子域名；包含 authority 和 hostname 时可使用任意 scheme，也接受协议相对地址。 |
如何使用
提交一种受支持的标识，跟踪异步任务，并从已存储结果页读取标准化主页记录。
- 准备有效 username，或解析后 hostname 为 kwai.com、kwai-video.com 或两者子域名的 Kwai 主页地址。
- 向 /v1/kwai/profile 提交 username、url 或两者，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或返回失败。
- 从 data.results.items 读取主页；仅当 has_more 为 true 时继续使用 next_cursor。
curl -X POST "https://api.socq.ai/v1/kwai/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.kwai.com/@ShortShortz8"}'
# 轮询 GET /v1/tasks/{task_id}
# 读取 data.results.items；仅在 has_more 为 true 时继续使用 next_cursor最佳使用场景
- 主页记录补全： 为关联到已知 Kwai 账号的记录补充标准化公开身份、主页图片、网站、账号标记和来源 URL。
- 可见账号比较： 比较选定主页的可用粉丝数、关注数和帖子数，不把这些值视为实时总数。
- 主页快照监测： 把多次结果与 collected_at 一同保存，用于跟踪公开身份字段、账号标记和可见计数随时间的变化。
使用建议
- 至少提供一种标识；同时提供 username 和 url 时，backend 会同时转发两者，而不是代替调用方选择其中一个。
- 提交前使用 ^@?[A-Za-z0-9._-]{1,64}$ 校验 username，并要求地址解析后的 hostname 为 kwai.com、kwai-video.com 或两者的子域名。
- 允许简介、头像、封面图、网站、账号标记和单项指标为空，因为公开主页可能只暴露部分字段。
- 优先使用 id 对结果去重，必要时以 url 作为备用键，并将 collected_at 与每组时间点指标一同保存。
相关 API
需要其他类型的 Kwai 公开数据时，可以使用以下 API。
- Kwai User Posts API — 按用户名或受支持的主页 URL 采集一页公开 Kwai 帖子，并返回标准化正文、作者、媒体、时间、话题、提及和可见互动指标。
- Kwai Post API — 将一个已知的公开 Kwai 帖子 URL 解析为标准化内容、作者、媒体、时间、实体和可见互动字段。