快手公开数据 API | SandBase
用一套 REST API 读取快手公开热榜、综合搜索、购物榜和视频数据。无需登录快手、无需 SDK——一个 SandBase 密钥,为 Agent 而生。

快手是提供创作者与电商功能的中国短视频平台——热榜、综合搜索、购物榜和视频流可以直接映射到趋势研究、电商监测和内容分析等场景。可要用程序去拿这些数据,通常意味着逆向 App、轮换 token,而且 App 一变你就得重写一遍采集器。
SandBase 的快手公开数据 API 免去了这些前置成本。它通过普通的 REST 端点读取快手公开的热榜、搜索结果、购物榜和视频——只用一个 SandBase API 密钥,不需要登录快手、也不需要 SDK。端点 API 参考是每个参数和响应信封(id/status/model/outputs[0].data)的权威来源;下面展示的业务载荷字段名只是一个示例结构、并非保证的 schema,请以一份真实响应为准核对。
这不是快手官方开放平台。 当你需要经过授权的会员操作,或需要有正式授权协议的数据时,请走快手官方渠道。当你的工作流需要用于研究和监测的公开、只读数据时,用 SandBase。想上手?获取 SandBase API 密钥,然后浏览快手端点。
先说结论
- 一套 API 即可读取快手公开热榜、搜索结果、购物榜、视频和评论。
- 本文的 Model API 端点用
POST /v1/api/kuaishou/<path>调用——只传该端点的参数,无 SDK,一个SANDBASE_API_KEY。- 端点以自然标识为入口:搜索用
keyword、视频用photo_id、创作者用user_id。- 只返回公开、只读数据。你这边无需发帖、无需平台登录或 OAuth、不涉及私有数据;用 SandBase API 密钥鉴权即可。
当前范围:找候选,或查一个已知账号
本次 2026-11-08 修订通过免费 inspect 和公开参考核对用户搜索 V2与单用户资料 V2,没有发起业务调用。热榜、购物、视频和评论介绍保留自 2026-09-27 原总览,属于历史导航,不代表本轮执行验证。
不知道账号时先查关键词候选页;已知数字 user_id 就直接读一个资料。达人研究教程提供检查完整的一次 Python 请求,并区分已有 Key、已连接 Agent、新项目三种接入方式。它不自动选择候选、不遍历所有人的资料,也不继续抓作品。
当前两个端点均标价每次 $0.01,具备组织共享每日 100 次额度资格,额度在 00:00 UTC 重置,其他合资格接口同样会消耗。资格不等于剩余次数,本轮没有查询余额或承诺成功调用免费。分别选择两次请求,未考虑额度的标价合计是 $0.02。
沿用封面是概念插画,其中名称、数字、卡片或排名都不是本轮响应、实测指标或已确认客户数据。
你需要哪种快手 API?
| 你的需求 | 选择 | 原因 |
|---|---|---|
| 发布、以会员身份操作,或使用账号授权数据 | 快手官方渠道 | 会员和账号级操作应通过快手直接进行。 |
| 读取公开热榜、搜索、购物榜或视频 | SandBase 快手公开数据 API | 普通 REST、一个 SandBase 密钥、结构化 JSON,面向只读工作流。 |
| 私有或仅账号可见的数据 | 两种公开方案都不适用 | 这类数据不在本篇公开数据指南范围内。 |
快手 API 能取到什么
目录横跨 app 和 web 两个面。按用途分组:
- 热榜与排行 — 趋势热榜和购物榜。
- 搜索 — 按关键词的综合搜索、实时搜索和标签搜索。
- 视频 — 按
photo_id读取单条视频及其评论。 - 创作者 — 按
user_id读取公开的创作者信息。
动手前请以每个端点的线上 API 参考为准核对具体面和参数;可用性因端点而异。
历史快手目录截图,不是当前端点数量或免费额度的测量。图中品牌榜 From $0.001 不代表本轮 $0.01 达人端点的价格。
快手提供什么,SandBase 补什么
公开数据来自快手,SandBase 提供统一鉴权入口,并不拥有快手,也不让所有端点的业务结构变成一样。每个选定路由都要分别检查参数、业务状态、载荷结构、可用性和费用。一次搜索成功,不能当成资料或视频请求也已经验证。
快速上手:只查一页候选
在本地配置 SANDBASE_API_KEY,发送关键词和空 pcursor。命令设置连接与总耗时限制,没有重定向或重试选项。它只打印返回,业务校验请用教程里的 Python。
curl --fail-with-body --connect-timeout 10 --max-time 90 \
-X POST https://api.sandbase.ai/v1/api/kuaishou/app/search-user-v2 \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keyword":"人工智能","pcursor":""}'先检查 completed 与 outputs[0].data 对象,再检查整数 responseCode 0 和包含 user 对象的 mixFeeds 数组。如果独立选择资料任务,路径改为 /v1/api/kuaishou/app/one-user-v2,只发送 {"user_id":"3795214411"};检查整数 result 1、userProfile.profile 与 userProfile.ownerCount 对象。不要把两次请求都当成隐藏的准备步骤。这个 ID 来自公开 schema 示例,并非本次重跑。
已连接的 Agent 应复用现有凭据配置。新 Agent 可读取 SKILL.md、quickstart.md和人工入门。给它任务、关键词或已知 ID 即可,不要在提示词里放 Key。先要求一个经过检查的结果和缺失字段说明,再考虑扩大工作流。
保留的历史热榜示意
下面 JSON 是原总览的热榜结构示意,不是新运行结果,也不是搜索或资料契约。它的业务 data 是列表,不能搬进本次两个对象型接口的解析器。旧 Python 逐字存于历史归档,不作为当前入门方案。
{
"id": "0e6f9926-eb40-4d04-94bf-35b070748803",
"status": "completed",
"model": "kuaishou/web/hot-list-v1",
"outputs": [
{
"data": [
{ "rank": 0, "name": "…", "tagType": "…", "viewCount": null }
]
}
]
}运行失败或未完成就停止读字段,不要假设错误响应绝不会带 outputs,不输出原始诊断正文,也不要把缺失载荷伪装成正常空结果。
历史热榜参考截图仅对应归档示意,不代表当前搜索或资料请求已经执行成功。旧 model 请求体及空 data 占位不是当前调用方式或业务结果。
能力地图
以下为 2026-09-27 的历史目录导航,本轮没有重新验证表中其他路由及参数。
| 能力簇 | 代表端点 | 典型用途 |
|---|---|---|
| 热榜 | kuaishou/web/hot-list-v1 | 趋势话题监测 |
| 购物榜 | kuaishou/app/shopping-top-list | 直播电商与商品追踪 |
| 搜索 | kuaishou/app/search-comprehensive | 关键词内容发现 |
| 视频 | kuaishou/web/one-video-v2 | 按 photo_id 读取视频 |
| 视频评论 | kuaishou/app/video-comment | 互动与情感分析输入 |
分页方式因端点而异——若干端点会返回或接受一个游标值,如 pcursor。请查阅每个端点的结构。
历史 shopping-top-list 参考展示 subTabId/subTabName 参数。本轮没有复验购物行为,旧 model 请求体和空 data 占位不作当前操作指引。
加下一次请求之前
候选不是自动查询资料的指令。先核对明确的身份字段与研究目的,再决定是否值得多查。原达人教程会搜索一次、再最多查五人,最多六次调用;共享信封不代表它们是一笔操作。
搜索的 pcursor 与保存示例中的 recoPcursor 是不同字段,不能混用。本轮只查第一页,没有验证续页或停止规则。不要自增游标、跟随猜测 token,或从追踪字符串反推缺失 user_id。作品、评论或购物请求需要各自的当前参考和预算。
历史能力导航
原总览把热榜、购物榜和综合搜索用于以下研究场景。它们是可能的后续任务,不是本轮已验证的追加步骤。使用前需另行核对选定路由的当前输入、响应结构、访问条件与预算。
| 历史能力 | 可能回答的问题 | 发新请求前要确认 |
|---|---|---|
kuaishou/web/hot-list-v1 | 一份热榜样本出现了哪些话题? | 核对当前请求和条目结构;一个快照不能证明趋势。 |
kuaishou/app/shopping-top-list | 购物排行里有哪些条目? | 核对类别与输入选项;排行不是已证实的销售报告。 |
kuaishou/app/search-comprehensive | 某个话题有哪些匹配内容? | 核对自己的字段和续页契约,不复用用户搜索规则。 |
本文不执行定时轮询、购物调用或综合搜索续页,也不提供它们的可运行代码。
报告不能改变原始记录的含义
当前资料参考把账号记录放在 userProfile.profile,计数放在 userProfile.ownerCount。authorInfo 是状态旗标,不是另一份可互换的资料。顶层 totalPhotoLike 可能包含入口链接与界面信息,ownerCount.total_photo_like 才是观察到的数值计数。不要拿链接对象做排序,也别把缺失计数悄悄改成零。
资料 README 的短 JSON 在 userProfile 之前截断,而 2026-10-07 的完整保存示例中存在这个对象。文档被裁剪,与完整响应缺字段,是两种证据。保存示例和九月原实验都不是十一月执行。教程分别保留日期明确的裁剪片段,并说明当前校验的边界。
未知、零、false 要分别处理。搜索 fansCount 与资料 ownerCount.fan 可能来自不同请求、不同时间,比较之前先记来源。累计获赞不是近期互动率,关键词样本也不代表全垂类份额。字段不完整的一个账号,不能包装成完整的受众评估;缺数据的账号不应因为默认零而自动排到末尾。
photo_private 计数不是私密作品的访问权限。商店入口与商品数也不能证明销量或转化,IP 归属地标签不等于对具体个人精确位置的测量。当前教程不会自动打开链接、下载头像、采集作品或调用模型分析。先看第一份记录,再决定哪一个真正没有回答的问题值得另发请求。
错误处理也要分层:HTTP 状态、SandBase 是否完成、所选接口的业务状态。鉴权、余额或限流失败后先检查原因;超时可能意味着结果未知,自动重发可能多算一次调用。报错说明失败层级即可,不应输出密钥、请求头或原始诊断正文。离线 mock 能验证这些处理分支,不能证明在线服务当下可用。
局限与边界
- 仅公开、只读数据。 不发帖、不关注、不涉及私有或仅账号可见的数据。
- 速率与量级。 把响应当作尽力而为的读取;遇到错误先停下检查原因,再明确决定是否另发请求。
- 参数与结构随上游面而定。 标识各异(
keyword、photo_id、user_id);分页是每端点各自的游标,如pcursor。先看一次真实响应、读一遍结构。 - 以线上参考核对端点。 可用性和字段可能变化;在依赖某个具体端点前先确认。
- 这不是快手官方合作。 SandBase 提供对公开数据的统一访问;请就你的使用场景遵守快手条款和适用规则。
常见问题
我需要快手开发者应用或登录吗?
不需要。你用自己的 SANDBASE_API_KEY 向 SandBase 鉴权。这些读取端点不需要你这边有快手账号或 OAuth。
什么标识一条视频或一个创作者?
视频用 photo_id,创作者用 user_id。搜索用 keyword。
分页怎么做? 本轮搜索 schema 指定 pcursor,第一页传空值。保存响应还有另一个 recoPcursor,不能混用。本文没有测试续页,实施前需核对准确路由的参考。
我能读私有或仅账号可见的数据吗? 不能。这套 API 只返回公开数据。私有和账号授权内容不在范围内。
从一个明确任务开始
复用已有 Key 或按 setup 指引配置,选择关键词第一页或已知账号资料,先检查一次返回。可继续读达人教程、用户搜索参考、单用户资料参考。更广的目录用于寻找需要单独验证的下一个任务。
觉得有用?分享给更多人