快手 API
快手是中国最大的短视频平台之一。研究机构、MCN、品牌和数据团队无需自己开发和维护采集程序,就能拿到结构化数据:14 个接口覆盖用户主页、帖子、评论、综合搜索、直播和热榜,每个都是一次 POST 请求,返回结构化 JSON。
注册即送 50 积分。无需绑卡,无需注册公司或办理 ICP 备案。
{ "data": { "result": 1, "userProfile": { "profile": { "user_id": 5518803932, "user_name": "玉儿脱口秀", "user_text": "玉儿上线,快乐开讲,用段子解锁生活趣味~", "user_sex": "F", "verified": false, "headurl": "http://p22.a.yximgs.com/uhead/AB/..." }, "ownerCount": { "like": 0, "photo": 312 } } }, "response_time": 1880, "credits_used": 10, "credits_remaining": 4726}这是该接口返回的真实响应。注册后即可自己调用。
什么是 Scavio 快手 API?
Scavio 快手 API 是一个 REST API,以结构化 JSON 返回中国主要短视频平台快手的公开数据。你用 API 密钥把分享链接、用户 id、视频 id 或关键词发送到 14 个 POST 接口之一,即可拿到用户主页、帖子、评论、搜索结果、直播或热榜数据。
- 14
- 个接口,全部已在生产环境上线
- 1–40
- 积分,按接口计费
- 20
- 条视频,每次批量调用
从这四个接口开始
它们覆盖了大多数使用场景。全部 14 个接口及价格见下表。
综合搜索
POST /api/v1/kuaishou/search快手自己的综合排序:视频、创作者和直播按 App 中的顺序返回,而不是事后拼凑的结果。
用户主页
POST /api/v1/kuaishou/profile创作者的昵称、简介、IP 属地和各项计数。每次 10 积分,是较贵的一个,所以请先解析并缓存,不要反复请求。
视频批量查询
POST /api/v1/kuaishou/videos/batch一次请求最多 20 条视频,消耗 40 积分:每个 id 合 2 积分,与单条调用每条 2 积分相同,但只需一次往返。补全视频列表最省事的方式。
热榜
POST /api/v1/kuaishou/trending热搜榜以及直播、购物和品牌榜单,每次 1 积分。了解中国短视频用户正在关注什么,这是最便宜的方式。
全部 14 个快手接口
所有接口都是 POST,返回 JSON,使用同一个 API 密钥。快手按接口计费,扩大任务规模之前请先看积分列。
| 接口 | 返回数据 | 积分 |
|---|---|---|
分享链接解析/api/v1/kuaishou/user/resolve | 把从 App 复制的分享链接解析为其他接口所需的 id | 1 |
用户主页/api/v1/kuaishou/profile | 昵称、简介、头像、性别、IP 属地以及各项计数 | 10 |
用户帖子/api/v1/kuaishou/user/posts | 创作者的热门作品:文案、播放 / 点赞 / 评论 / 分享数 | 1 |
直播状态/api/v1/kuaishou/user/live | 创作者此刻是否在直播,以及直播间信息 | 1 |
视频详情/api/v1/kuaishou/video | 按 photo id 或链接获取单条视频:文案和完整计数 | 2 |
视频批量查询/api/v1/kuaishou/videos/batch | 一次请求最多 20 条视频:每个 id 合 2 积分,而不是每个 40 积分 | 40 |
视频评论/api/v1/kuaishou/video/comments | 评论内容、作者昵称和 id、IP 属地 | 1 |
评论回复/api/v1/kuaishou/video/sub-comments | 一条一级评论下的全部回复 | 1 |
综合搜索/api/v1/kuaishou/search | 快手自己的综合搜索,结果与 App 中展示的一致 | 10 |
视频搜索/api/v1/kuaishou/search/videos | 每页 20 条排序视频:文案、作者、播放数 | 10 |
用户搜索/api/v1/kuaishou/search/users | 按昵称、快手号或主题,每页 20 个创作者 | 10 |
直播搜索/api/v1/kuaishou/search/live | 某个关键词下此刻正在直播的直播间 | 10 |
话题信息流/api/v1/kuaishou/tag/feed | 话题下每页 20 条帖子,附作者和各项计数 | 1 |
热榜/api/v1/kuaishou/trending | 热搜榜,以及直播、购物和品牌榜单 | 1 |
注册赠送的 50 积分可用于 5 次用户主页查询、50 页信息流,或一次完整的 20 条视频批量查询。 查看套餐
先解析链接,再读取创作者
分享链接里没有 id,所以先用 1 积分解析。右侧的响应是一次真实调用的结果,注意快手的嵌套有多深。
from scavio import ScavioClient
client = ScavioClient(api_key="sk_live_your_key")
# 粘贴 App 中的分享链接 - 1 积分
ids = client.kuaishou.user_resolve(share_link="https://v.kuaishou.com/...")
# 该用户的帖子 - 1 积分
posts = client.kuaishou.user_posts(user_id=ids["data"]["user_id"])
for p in posts["data"]["feeds"]:
print(p["caption"][:40], p["view_count"]){
"data": {
"result": 1,
"userProfile": {
"profile": {
"user_id": 5518803932,
"user_name": "玉儿脱口秀",
"user_text": "玉儿上线,快乐开讲,用段子解锁生活趣味~",
"user_sex": "F",
"verified": false,
"headurl": "http://p22.a.yximgs.com/uhead/AB/..."
},
"ownerCount": {
"like": 0,
"photo": 312
}
}
},
"response_time": 1880,
"credits_used": 10,
"credits_remaining": 4726
}为什么不自己开发?
快手没有面向开发者的公开 API,自己动手的实际门槛比大多数平台都高。
自己开发
- 没有面向开发者的公开 API,也没有文档化的接口
- 分享链接里没有可直接使用的 id,每个流程都要自己写解析
- 中文数据,嵌套深且结构不统一
Scavio 快手 API
- 注册即发放 API 密钥,无需注册公司,无需 ICP 备案
- 有文档的解析接口,1 积分即可把任意分享链接转换为 id
- 批量查询视频,每个 id 合 2 积分,一次请求完成
- 与 Scavio 其他平台使用同一个密钥和同一种 JSON 结构
Scavio 只返回公开数据,从不以快手用户身份登录。
开发者用它做什么
中国市场研究
快手是中国最大的短视频平台之一。搜索和热榜能帮你读懂消费者的注意力,补上只看抖音时缺失的那一块。
search + trending达人发现与筛选
按主题找到创作者,在联系之前先查看主页上真实的粉丝数和作品数。用户主页每次 10 积分,所以解析一次后请缓存。
search/users + profile直播带货监测
快手高度依赖直播电商。搜索此刻正在直播的直播间,并查看某位创作者是否在直播,这正是直播带货最关键的时刻。
search/live + user/live活动与话题跟踪
以每页 1 积分读取话题信息流,再通过批量接口一次补全感兴趣的视频,而不是一条一条地调用。
tag/feed + videos/batch评论与舆情分析
每页 1 积分获取评论及其回复,并附带 IP 属地,再用大模型对中文文本做主题分析。
video/comments + video/sub-commentsAI 智能体工具
把 AI 智能体接入 MCP 服务器,快手就和 Scavio 的其他平台一样成为可调用的工具:一个密钥,一种 JSON 结构。
MCP + REST如何以 JSON 获取快手数据
- 1
获取 API 密钥
注册 Scavio 账号,在控制台复制你的密钥。注册即送 50 积分,无需绑卡,也无需注册公司或办理 ICP 备案。
- 2
先解析分享链接
快手分享链接里没有可直接使用的 id。把 {"share_link": "https://v.kuaishou.com/..."} 发送到 /api/v1/kuaishou/user/resolve,消耗 1 积分,即可拿到其他接口所需的 id。
- 3
留意积分列
快手按接口计费:大多数读取接口 1 积分,视频详情 2 积分,搜索和用户主页 10 积分,videos/batch 最多 20 个 id 共 40 积分。处理列表时批量接口更划算:每个 id 合 2 积分,与单条调用相同,但只需一次请求。
快手 API 常见问题
什么是 Scavio 快手 API?
+
这是一个 REST API,以结构化 JSON 返回快手的公开数据。14 个 POST 接口覆盖分享链接解析、用户主页、用户帖子和直播状态、视频详情和视频批量查询、评论和回复、综合 / 视频 / 用户 / 直播搜索、话题信息流以及热榜。使用 Scavio API 密钥进行身份验证。
这些接口适合谁使用?
+
研究中国市场的品牌和市场研究人员;需要在产品中嵌入短视频社交数据的开发者;把快手作为 MCP 或 SDK 工具接入的 AI 智能体开发者;在 n8n、Zapier 或 Make 中运行监测任务的自动化工程师;跟踪直播的直播电商团队;以及研究短视频注意力的分析师。他们用的都是同一套 API。
一次快手请求消耗多少积分?
+
快手按接口计费,而不是统一价格。大多数读取接口(分享链接解析、用户帖子、直播状态、评论、回复、话题信息流和热榜)消耗 1 积分。视频详情 2 积分。用户主页和四个搜索接口都是 10 积分。批量接口 videos/batch 是 40 积分。所有价格都列在本页的表格中。
为什么 videos/batch 要 40 积分?
+
因为它一次请求最多返回 20 条视频。20 个 id 共 40 积分,相当于每个 id 2 积分,与单条视频调用相同,但只需一次往返。只要真正凑满一批,它就是补全列表的低成本方式,而不是昂贵的方式。
快手和抖音、TikTok 是一回事吗?
+
不是。快手是独立的中国短视频平台,是抖音的直接竞争对手。它不是 TikTok,也不是 TikTok 的中国版,创作者、趋势和电商生态都各不相同。Scavio 也单独提供抖音和 TikTok 的接口。
支持快手国际版 Kwai 吗?
+
不支持。Scavio 快手 API 只覆盖快手(中国,kuaishou.com)。快手国际版 Kwai(kwai.com)的链接无法解析,kwai.com 的 id 也不会返回任何内容。
需要注册公司或办理备案吗?
+
不需要。你只需用 Scavio API 密钥调用 Scavio 接口,无需注册公司、办理 ICP 备案,也不需要本地合作伙伴。
响应是什么样的?
+
API 把快手的数据放在 data 键下,并附加 credits_used 和 credits_remaining。注意快手的嵌套比大多数平台更深:用户主页位于 data.userProfile.profile,计数位于 data.userProfile.ownerCount,而不是直接在 data 根下。
返回的内容是中文吗?
+
是的。文案、评论、昵称和简介都以原始中文返回,不做改动。这是有意为之:中间做翻译会丢失含义,你可以自己翻译,或者用大模型处理这些文本。
如何翻页?
+
快手接口采用游标分页。第一页不传 cursor,之后把上一次响应中的 data.pcursor 作为 cursor 传回;pcursor 为 "no_more" 表示没有更多页。注意字段名是 pcursor,不是 next_cursor;搜索结果中的 recoPcursor 是推荐流的另一个游标,不能用来翻页。
支持哪些语言和工具?
+
官方 Python SDK(pip install scavio)和 JavaScript / TypeScript SDK(npm i scavio)、位于 mcp.scavio.dev 的远程 MCP 服务器(面向 AI 智能体),以及 n8n 社区节点。任何语言都可以用 HTTP 客户端直接调用 REST 接口。
使用快手数据合法吗?
+
Scavio 返回的是公开的帖子和主页数据,不会以用户身份登录。你采集哪些数据、如何使用,受中国数据相关法规和快手自身条款的约束;涉及个人信息时,还要视你所在的司法辖区承担更多义务。请就你的具体用例咨询自己的法律顾问。