快手公开数据 API | SandBase

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

深色电影质感画面:快手热榜、搜索与视频数据经由同一条 API 管道汇入 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 参考为准核对具体面和参数;可用性因端点而异。

SandBase 快手 API 页面:描述、能力标签与端点列表 历史快手目录截图,不是当前端点数量或免费额度的测量。图中品牌榜 From $0.001 不代表本轮 $0.01 达人端点的价格。

快手提供什么,SandBase 补什么

公开数据来自快手,SandBase 提供统一鉴权入口,并不拥有快手,也不让所有端点的业务结构变成一样。每个选定路由都要分别检查参数、业务状态、载荷结构、可用性和费用。一次搜索成功,不能当成资料或视频请求也已经验证。

快速上手:只查一页候选

在本地配置 SANDBASE_API_KEY,发送关键词和空 pcursor。命令设置连接与总耗时限制,没有重定向或重试选项。它只打印返回,业务校验请用教程里的 Python。

Shell
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 逐字存于历史归档,不作为当前入门方案。

JSON
{
  "id": "0e6f9926-eb40-4d04-94bf-35b070748803",
  "status": "completed",
  "model": "kuaishou/web/hot-list-v1",
  "outputs": [
    {
      "data": [
        { "rank": 0, "name": "…", "tagType": "…", "viewCount": null }
      ]
    }
  ]
}

运行失败或未完成就停止读字段,不要假设错误响应绝不会带 outputs,不输出原始诊断正文,也不要把缺失载荷伪装成正常空结果。

某个快手端点的 SandBase API 参考,展示带厂商前缀的 URL 和响应结构 历史热榜参考截图仅对应归档示意,不代表当前搜索或资料请求已经执行成功。旧 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 参数参考 历史 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 指引配置,选择关键词第一页或已知账号资料,先检查一次返回。可继续读达人教程、用户搜索参考、单用户资料参考。更广的目录用于寻找需要单独验证的下一个任务。

觉得有用?分享给更多人