kwai/
post

通过已知的 kwai.com 或 kwai-video.com URL 获取一条公开 Kwai 帖子,返回标准化正文、作者、媒体、时间和可见互动数据。

Kwai Post API

指定帖子 URL
帖子与作者信息
固定任务费用
每次请求 0.19 积分
等待提交
等待提交

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

README

由 SocQ 维护 · 更新于

Kwai Post

Kwai 帖子是公开内容记录,可将正文和媒体与作者身份、话题标签、提及、发布时间及可见互动联系起来。这些字段适合补全链接目录、审核选定内容,并比较不同采集时点的帖子表现。

Kwai Post API 主要特性

  • 指定 URL 单条查询解析 kwai.com、kwai-video.com 或其子域上的一个公开 URL,不额外添加未经运行时证实的路径规则。
  • 帖子与作者上下文返回帖子标识、来源 URL、正文、发布时间,以及可获得的作者 ID、username、显示名称、主页、头像和账号标记。
  • 媒体与内容实体在帖子记录中保留可获得的媒体地址、预览图、尺寸、时长、话题标签和提及。
  • 可见互动快照标准化可获得的点赞、评论、分享和观看数量,并通过 collected_at 标明记录的观察时间。

Kwai Post API 参数

参数必填描述
url必填必填的非空 URL,主机名必须能解析为 kwai.com、kwai-video.com 或受支持的子域;运行时不要求特定路径格式。

如何使用 Kwai Post API

提交一个符合规则的 Kwai URL,跟踪异步任务,并在完成后读取标准化帖子记录。

  1. 确认 URL 包含可解析的主机名,且属于 kwai.com、kwai-video.com 或受支持的子域。
  2. 向 /v1/kwai/post POST url 字符串,并保存返回的 task_id。
  3. 轮询 /v1/tasks/{task_id},直到任务成功或失败。
  4. 成功后读取 data.results.items。详情 provider 最多保存一条帖子,因此即使任务结果路由提供 next_cursor,has_more 通常也应为 false。
curl -X POST "https://api.socq.ai/v1/kwai/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.kwai.com/@ShortShortz8/photo/5235021727595785285"}'

# 轮询 GET /v1/tasks/{task_id}
# 从 data.results.items 读取标准化帖子

Kwai Post API 最佳使用场景

  • 补全指定帖子目录: 为已保存的 Kwai 链接补充标准化帖子 ID、正文、作者身份、发布时间和来源字段。
  • 审核选定帖子内容: 结合正文、媒体引用、话题标签、提及和作者上下文,检查一组已确认的单条帖子。
  • 比较互动快照: 在设定时点重复查询,并将可见的点赞、评论、分享和观看数量与 collected_at 配对进行分时比较。

Kwai Post API 使用建议

  • 为 URL 带上 scheme 以便解析主机名,并提交准确的公开帖子链接,不要使用裸账号名。
  • 每个任务只提交一个 URL;这个详情接口只有 url 字段,不接受 results_limit 或批量输入。
  • 成功任务没有返回记录时仍保留输入 URL,因为主机名有效不代表 provider 一定能解析对应资源。
  • 存储时允许作者、媒体、内容实体和互动字段为空,因为公开帖子不一定暴露全部标准字段。
  • 比较互动数据时始终结合 collected_at,不要把可见计数当作实时数据流。

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

  • Kwai Profile API — 通过 username 或受支持 URL 获取一个公开 Kwai 主页,返回标准化身份、图片、账号标记、可见计数和采集上下文。
  • Kwai User Posts API — 按用户名或受支持的主页 URL 采集一页公开 Kwai 帖子,并返回标准化正文、作者、媒体、时间、话题、提及和可见互动指标。

探索其他平台

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

Kwai Post API — 常见问题

Kwai Post API 是一个用于从受支持 Kwai 主机上的已知 URL 获取一条公开帖子的 API。它返回标准化帖子标识、正文、作者、媒体、话题标签、提及、时间和可见互动字段。

提交非空 URL,解析后的主机名必须是 kwai.com、kwai-video.com 或其子域。URL 需要包含 scheme,才能正确解析主机名。

当前运行时校验不限制路径格式。仍应使用真实公开帖子链接,因为其它资源路径即使通过主机名校验,也可能无法返回帖子记录。

记录可以包含帖子标识、URL、正文、发布时间与采集时间、作者资料、媒体、话题标签、提及,以及可见的点赞、评论、分享和观看数量。公开记录未提供时,选填字段可以为空。

请求不接受 results_limit,一次 provider 请求最多保存一条帖子。共享任务结果路由仍提供 limit、next_cursor 和 has_more,但这个详情结果通常会在第一页返回完毕。

每个成功任务固定消耗 0.19 SocQ 积分,预估费用不随结果数量变化。成功任务即使没有解析出记录,也使用固定任务费用。