kwai/
profile

通过 username 或受支持的主页 URL 获取一个公开 Kwai 主页,返回标准化身份、主页图片、账号标记、可见计数和采集上下文。

Kwai Profile API

Username 或主页 URL
标准化主页身份
每任务固定 0.19 积分
每次请求 0.19 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

Kwai Profile

Kwai 主页是包含 username、显示名称、简介、主页图片、网站、账号标记以及可见粉丝数、关注数和帖子数的公开账号页面。这些身份资料和时间点信号可用于补全主页记录、比较账号和持续监测公开快照。

Kwai Profile API 主要特性

  • 两种受支持的标识可通过有效 username、kwai.com 或 kwai-video.com 的主页 URL,或在同一任务中同时提供两种标识来解析一个公开主页。
  • 标准化公开身份在一致的账号记录中返回主页 ID、来源 URL、username、显示名称、简介文本、头像、封面图和网站。
  • 带观察时间的账号信号将可用认证与隐私标记、可见粉丝数、关注数、帖子数和 collected_at 一同保存为时间点主页快照。

Kwai Profile API 参数

参数必填描述
username必填(至少一项)username 与 url 至少填写一个。username 可带一个前导 @,随后使用 1 至 64 个 ASCII 字母、数字、点、下划线或连字符。
url必填(至少一项)url 与 username 至少填写一个。非空地址解析后的 hostname 必须为 kwai.com、kwai-video.com 或两者的子域名;包含 authority 和 hostname 时可使用任意 scheme,也接受协议相对地址。

如何使用 Kwai Profile API

提交一种受支持的标识,跟踪异步任务,并从已存储结果页读取标准化主页记录。

  1. 准备有效 username,或解析后 hostname 为 kwai.com、kwai-video.com 或两者子域名的 Kwai 主页地址。
  2. 向 /v1/kwai/profile 提交 username、url 或两者,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或返回失败。
  4. 从 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 Profile API 最佳使用场景

  • 主页记录补全: 为关联到已知 Kwai 账号的记录补充标准化公开身份、主页图片、网站、账号标记和来源 URL。
  • 可见账号比较: 比较选定主页的可用粉丝数、关注数和帖子数,不把这些值视为实时总数。
  • 主页快照监测: 把多次结果与 collected_at 一同保存,用于跟踪公开身份字段、账号标记和可见计数随时间的变化。

Kwai Profile API 使用建议

  • 至少提供一种标识;同时提供 username 和 url 时,backend 会同时转发两者,而不是代替调用方选择其中一个。
  • 提交前使用 ^@?[A-Za-z0-9._-]{1,64}$ 校验 username,并要求地址解析后的 hostname 为 kwai.com、kwai-video.com 或两者的子域名。
  • 允许简介、头像、封面图、网站、账号标记和单项指标为空,因为公开主页可能只暴露部分字段。
  • 优先使用 id 对结果去重,必要时以 url 作为备用键,并将 collected_at 与每组时间点指标一同保存。

除了 Kwai Profile API,需要其他类型的 Kwai 公开数据时,可以使用以下 API。

  • Kwai User Posts API — 按用户名或受支持的主页 URL 采集一页公开 Kwai 帖子,并返回标准化正文、作者、媒体、时间、话题、提及和可见互动指标。
  • Kwai Post API — 将一个已知的公开 Kwai 帖子 URL 解析为标准化内容、作者、媒体、时间、实体和可见互动字段。

探索其他平台

还可以将 Kwai 数据与其他已支持社交平台的公开数据结合使用。

Kwai Profile API — 常见问题

Kwai Profile API 是通过受支持的 username 或主页 URL 获取一个公开 Kwai 主页的程序化接口。结果会在可用时返回标准化身份、主页图片、账号标记、可见计数和采集上下文。

可以提交 username、url 或两者。username 可带一个前导 @,随后使用 1 至 64 个 ASCII 字母、数字、点、下划线或连字符。地址解析后的 hostname 必须为 kwai.com、kwai-video.com 或其子域名;包含 authority 和 hostname 时可使用任意 scheme,也接受协议相对地址。

结果可包含 ID、来源 URL、username、显示名称、简介文本、头像、封面图、网站、认证与隐私标记、可见粉丝数、关注数、帖子数和采集时间。

不支持。每个任务解析一个主页,请求没有 results_limit;已存储结果读取仍按通用异步结果契约提供 items、next_cursor 和 has_more。

每个成功的 Kwai Profile 任务固定消耗 0.19 个 SocQ credits。费用不会随字段数量或结果项数量变化。