Kwai Post
Kwai 帖子是公开内容记录，可将正文和媒体与作者身份、话题标签、提及、发布时间及可见互动联系起来。这些字段适合补全链接目录、审核选定内容，并比较不同采集时点的帖子表现。
主要特性
- 指定 URL 单条查询解析 kwai.com、kwai-video.com 或其子域上的一个公开 URL，不额外添加未经运行时证实的路径规则。
- 帖子与作者上下文返回帖子标识、来源 URL、正文、发布时间，以及可获得的作者 ID、username、显示名称、主页、头像和账号标记。
- 媒体与内容实体在帖子记录中保留可获得的媒体地址、预览图、尺寸、时长、话题标签和提及。
- 可见互动快照标准化可获得的点赞、评论、分享和观看数量，并通过 collected_at 标明记录的观察时间。
参数
| 参数 | 必填 | 描述 |
|---|---|---|
url | 必填 | 必填的非空 URL，主机名必须能解析为 kwai.com、kwai-video.com 或受支持的子域；运行时不要求特定路径格式。 |
如何使用
提交一个符合规则的 Kwai URL，跟踪异步任务，并在完成后读取标准化帖子记录。
- 确认 URL 包含可解析的主机名，且属于 kwai.com、kwai-video.com 或受支持的子域。
- 向 /v1/kwai/post POST url 字符串，并保存返回的 task_id。
- 轮询 /v1/tasks/{task_id}，直到任务成功或失败。
- 成功后读取 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 链接补充标准化帖子 ID、正文、作者身份、发布时间和来源字段。
- 审核选定帖子内容： 结合正文、媒体引用、话题标签、提及和作者上下文，检查一组已确认的单条帖子。
- 比较互动快照： 在设定时点重复查询，并将可见的点赞、评论、分享和观看数量与 collected_at 配对进行分时比较。
使用建议
- 为 URL 带上 scheme 以便解析主机名，并提交准确的公开帖子链接，不要使用裸账号名。
- 每个任务只提交一个 URL；这个详情接口只有 url 字段，不接受 results_limit 或批量输入。
- 成功任务没有返回记录时仍保留输入 URL，因为主机名有效不代表 provider 一定能解析对应资源。
- 存储时允许作者、媒体、内容实体和互动字段为空，因为公开帖子不一定暴露全部标准字段。
- 比较互动数据时始终结合 collected_at，不要把可见计数当作实时数据流。
相关 API
需要其他类型的 Kwai 公开数据时，可以使用以下 API。
- Kwai Profile API — 通过 username 或受支持 URL 获取一个公开 Kwai 主页，返回标准化身份、图片、账号标记、可见计数和采集上下文。
- Kwai User Posts API — 按用户名或受支持的主页 URL 采集一页公开 Kwai 帖子，并返回标准化正文、作者、媒体、时间、话题、提及和可见互动指标。