Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
可用的 Kwai API
Profiles 用于账号记录，User Posts 用于获取账号的一个来源页，Posts 用于解析一个已知公开帖子 URL。
可以获取哪些 Kwai 数据？
SocQ 保留所选资源提供的公开字段，不会把缺失值当作零。
主页身份
获取可用的主页身份、图片、网站和公开账号标记。
帖子内容
获取标准化正文、作者上下文、发布时间、话题和提及。
媒体与指标
保留可用媒体字段，并将账号或互动计数作为特定时间点的观察值。
Kwai API 契约概览
每个 endpoint 都有明确的来源请求范围，并使用通用异步任务结果读取器。
| Endpoint | 输入 | 来源范围 |
|---|---|---|
| Profiles | Username、受支持主页 URL 或两者 | 一个公开主页 |
| User Posts | Username、受支持主页 URL 或两者 | 首次返回的一个来源页 |
| Posts | 受支持的公开帖子 URL | 一个公开帖子 |
Kwai API 如何工作
三个 endpoint 均使用 SocQ 标准异步任务流程。
1. 提交标识
选择 Kwai endpoint，提交其支持的 username 或 URL 输入，并保存 task_id。
2. 跟踪任务
轮询 /v1/tasks/{task_id}，直到处理成功或失败。
3. 读取已存储结果
读取 data.results.items；仅当 has_more 为 true 时继续使用 next_cursor。
使用 SocQ API key 鉴权并提交受支持的公开标识。
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.itemsKwai API 常见用途
主页数据补全
为已知账号记录补充公开身份、图片、账号标记、来源 URL 和可见账号信号。
内容整理
建立范围明确的公开账号帖子快照，或补充一个已知公开帖子 URL 的数据。
公开信号监测
将重复结果与 collected_at 一同保存，比较可见公开字段随时间的变化。
限制与公开数据政策
Kwai 结果是特定时间点的公开记录，不提供发布或账号管理功能。
- Profiles 和 User Posts 要求 username 与 url 至少填写一个，也可以同时提供两者。
- 支持 kwai.com、kwai-video.com 或其子域名上的 HTTP(S) URL。
- User Posts 不跟随来源分页；任务结果 cursor 只对 SocQ 已存储记录分页。
- Posts 解析一个受支持的公开帖子 URL，不接受 results_limit。
- 每个成功任务固定消耗 0.19 credits。
Kwai API 常见问题
Kwai API 是什么？
三个 Kwai API 分别用于获取一个公开主页、一页公开账号帖子或一个已知公开帖子。
可以同时提交 username 和 URL 吗？
Profiles 和 User Posts 可以。任意一个字段即可满足要求，同时提供时两者都会被转发。
支持哪些 Kwai URL host？
可使用 kwai.com、kwai-video.com 或其子域名上的 HTTP 或 HTTPS URL。
User Posts 会跟随来源分页吗？
不会。它只保存首次返回来源页中的记录；任务结果 cursor 只读取 SocQ 已存储记录。
Kwai 采集如何计费？
每个成功的 Kwai 任务固定消耗 0.19 SocQ credits。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
Amazon API
从受支持的 Amazon 站点搜索公开商品，并采集标准化的商品详情、畅销榜、评价和卖家资料记录。
Apple App Store API
通过已知商店链接采集公开 Apple App Store 应用详情、分类榜单和评价，并返回标准化应用与评价记录。
SEO API
查询实时 Google 自然搜索结果，比较关键词需求和排名难度，扩展种子词，找出带来网站搜索可见性的关键词与页面，并识别搜索意图。所有接口共用 SocQ API Key、异步任务流程和标准化结果格式。