要用 API 获取快手视频数据，先把关键词 POST 到 Scavio 的 https://api.scavio.dev/api/v1/kuaishou/search/videos（10 积分），从每条结果的 share_info 里取 photoId，再传给 /api/v1/kuaishou/video 取视频详情（2 积分）：播放、点赞、评论数、时长、发布时间和作者粉丝数。评论、楼中楼回复和创作者直播状态各 1 积分。不需要快手账号，也不需要注册公司或办理 ICP 备案。
快手开放平台的接口面向经用户 OAuth 授权的应用，围绕授权用户自己的账号，不能按关键词搜索任意视频或读取任意视频的评论。下面用美妆品牌珀莱雅做例子，每一步的响应都是 Scavio 在 2026 年 11 月 2 日（UTC）实际返回的，只做删减，没有改动任何值。快手按接口计费，每一步都标了积分。
准备工作
- 一个 Scavio API 密钥。注册即送 50 积分，无需绑卡，足够跑完下面全部 7 步（共 28 积分）。
- 任意能发 HTTP 请求的语言。下面用 cURL 和 Python。
第 1 步：按关键词搜索视频（10 积分）
视频搜索的必填参数是 keyword：
curl -X POST 'https://api.scavio.dev/api/v1/kuaishou/search/videos' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"keyword": "珀莱雅"}'视频在 data.mixFeeds[].feed 下，这次返回 19 条。其中一条，删减到常用字段：
{
"photo_id": 5253167696832135000,
"share_info": "userId=3xfzkk5akd5cfgc&photoId=3x5866am8whg2b6",
"user_id": 1950258601,
"user_name": "珀莱雅官方旗舰店",
"caption": "倒计时2天 | 她的美，自内而外明艳，是表象力量，藏于内里向内蓄力，向外生光皮骨双修，自内而外珀莱雅护肤代言人官宣倒计时 2天期待这一场全新相遇 #第四代珀莱雅红宝石面霜 #珀莱雅红宝石面霜 #珀莱雅",
"view_count": 714855,
"like_count": 9050,
"comment_count": 1811,
"duration": 5416,
"timestamp": 1787559435070,
"time": "2026-08-24 16:17:15"
}注意 photo_id：它是一个超长整数，在 JSON 里精度丢失，末几位变成了 0（详情接口返回的真实 id 是 5253167696832135345）。查详情时用 share_info 里的 photoId，也就是 3x5866am8whg2b6。duration 是毫秒，timestamp 是毫秒级时间戳。
19 条结果里有 7 条来自珀莱雅自己的账号（官方旗舰店、官方直播间、美妆个护旗舰店），播放量合计 8,692,761，占这 19 条的 85.9%。品牌在快手搜索结果里的声量，大部分是自己的账号贡献的。
第 2 步：取视频详情（2 积分）
视频详情接受 photo_id 或视频链接 url：
curl -X POST 'https://api.scavio.dev/api/v1/kuaishou/video' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"photo_id": "3x5866am8whg2b6"}'{
"photo": {
"photoId": "5253167696832135345",
"userId": 1950258601,
"userName": "珀莱雅官方旗舰店",
"kwaiId": "PROYA_FlAGSHIP_STORE",
"viewCount": 715004,
"likeCount": 9051,
"commentCount": 1811,
"forwardCount": 0,
"duration": 5416,
"timestamp": 1787559435070,
"photoType": "VIDEO"
},
"counts": { "fanCount": 2643598, "followCount": 91, "collectionCount": 650, "photoCount": 4494 }
}详情是实时数据：搜索时 714,855 次播放，几秒后详情里是 715,004。字段名也和搜索不同（viewCount 对 view_count），映射时要分开处理。counts 是作者账号的数据，粉丝 2,643,598。完整响应还有封面、视频地址和背景音乐。
第 3 步：拉评论（每页 1 积分）
curl -X POST 'https://api.scavio.dev/api/v1/kuaishou/video/comments' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"photo_id": "3x5866am8whg2b6"}'评论在 data.rootComments 下，第一页 37 条，commentCount 为 1811。把响应里的 pcursor 原样作为 cursor 传回就是第二页（这次 20 条，和第一页没有重复）。回复最多的一条：
{
"comment_id": 1179291689820,
"content": "鞠婧祎粉丝来这里罚站",
"author_name": "呆又何妨",
"authorArea": "广东",
"likedCount": 613,
"subCommentCount": 80,
"hot": true,
"time": "2026-09-24 21:38:02",
"timestamp": 1790257081665
}authorArea 是 IP 属地，time 是北京时间，hot 标记热评（这 57 条里有 17 条）。第一页先给热评，后面按时间倒序。
第 4 步：拉楼中楼回复（每页 1 积分）
评论回复接口要同时传视频 id 和一级评论的 root_comment_id：
curl -X POST 'https://api.scavio.dev/api/v1/kuaishou/video/sub-comments' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"photo_id": "3x5866am8whg2b6", "root_comment_id": "1179291689820"}'回复在 data.subComments 下，第一页 10 条（共 80 条），用 pcursor 继续翻。其中一条：
{"comment_id": 1179566827915, "content": "这视频跟鞠婧祎没关系啊 发这不招黑吗", "authorArea": "安徽", "likedCount": 3, "time": "2026-09-25 15:14:44", "reply_to": 1850312707}第 5 步：统计评论区在说什么
这条视频是代言人官宣前的倒计时，没有露出名字，评论区在猜是谁。用 Python 拉两页评论，统计每个名字被提到的次数：
import requests
API = "https://api.scavio.dev/api/v1/kuaishou/video/comments"
HEADERS = {"Authorization": "Bearer sk_live_your_key"}
comments, cursor = [], None
for _ in range(2):
body = {"photo_id": "3x5866am8whg2b6"}
if cursor:
body["cursor"] = cursor
data = requests.post(API, headers=HEADERS, json=body, timeout=60).json()["data"]
comments += data["rootComments"]
cursor = data["pcursor"]
if cursor == "no_more":
break
names = {"孟子义": ["孟子义", "孟姐"], "鞠婧祎": ["鞠婧祎", "小鞠", "jjy"]}
for name, keys in names.items():
hits = [c for c in comments if any(k in (c.get("content") or "") for k in keys)]
print(name, len(hits), sum(c.get("likedCount") or 0 for c in hits))57 条评论里，18 条提到孟子义（共 701 个赞），10 条提到鞠婧祎（共 1,259 个赞），杨紫、赵露思、白鹿、虞书欣、孙俪各被猜了 1 次。提到孟子义的评论更多，提到鞠婧祎的评论赞更多，因为第二热的评论就是“鞠婧祎粉丝来这里罚站”。同一次搜索里，珀莱雅旗舰店后来的一条视频写着“与孟子义一同见证”，答案揭晓。做代言人或新品预热的效果评估，这类数据比单纯的点赞数更说明问题。评论里的名字常有昵称和缩写，关键词表要自己补全。
第 6 步：查创作者是否在直播（1 积分）
快手的品牌账号往往在直播间卖货。直播状态接口传 user_id：
curl -X POST 'https://api.scavio.dev/api/v1/kuaishou/user/live' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"user_id": "1950258601"}'UTC 20:26（北京时间 11 月 3 日凌晨 4 点 26 分）查询时，珀莱雅官方旗舰店的 data.dynamicIconV2.isLive 为 true，liveStream.caption 是“珀莱雅双11年终臻享好礼”，直播类型为 shop。同一时间查“珀莱雅官方直播间”（user_id 3888081897），isLive 为 false。想一次看很多品牌，用热榜接口传 {"board": "brand"}，品牌榜每个条目都会标出是否链接到直播间，见快手数据采集 API 对比。
第 7 步：读创作者主页（10 积分）
用户主页是较贵的接口，取一次后缓存：
curl -X POST 'https://api.scavio.dev/api/v1/kuaishou/profile' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk_live_your_key' \
-d '{"user_id": "1950258601"}'数据在 data.userProfile 下：profile.user_name 为“珀莱雅官方旗舰店”，认证说明“旗舰店账号”；ownerCount 里粉丝 2,643,598、公开作品 4,492、作品累计获赞 3,912,601；ipLocation.ipLocationName 为“浙江”。只要创作者的作品列表，用 1 积分的用户作品接口就够了。
全部 14 个快手接口
| 接口 | 返回内容 | 积分 |
|---|---|---|
/api/v1/kuaishou/user/resolve | 把分享链接解析成 id | 1 |
/api/v1/kuaishou/profile | 用户主页：昵称、简介、IP 属地和各项计数 | 10 |
/api/v1/kuaishou/user/posts | 创作者的作品，带播放、点赞、评论数 | 1 |
/api/v1/kuaishou/user/live | 创作者是否在直播及直播信息 | 1 |
/api/v1/kuaishou/video | 单条视频详情 | 2 |
/api/v1/kuaishou/videos/batch | 一次最多 20 条视频 | 40 |
/api/v1/kuaishou/video/comments | 一级评论 | 1 |
/api/v1/kuaishou/video/sub-comments | 一级评论下的回复 | 1 |
/api/v1/kuaishou/search | 综合搜索 | 10 |
/api/v1/kuaishou/search/videos | 视频搜索 | 10 |
/api/v1/kuaishou/search/users | 用户搜索 | 10 |
/api/v1/kuaishou/search/live | 正在直播的直播间搜索 | 10 |
/api/v1/kuaishou/tag/feed | 话题下的作品 | 1 |
/api/v1/kuaishou/trending | 热搜、直播、购物、品牌、音乐榜 | 1 |
开始使用
- 注册：dashboard.scavio.dev/sign-up，送 50 积分，无需绑卡。
- 复制 API 密钥：注册后控制台里已自动生成。
- 发第一个请求：先用 1 积分的热榜接口试一下，
{"board": "hot"}POST 到/api/v1/kuaishou/trending。
免费试用快手 API，先在 Playground 里跑一遍；也可以通过 MCP 服务器在 AI 智能体里直接调用。价格见价格页。
Frequently asked questions
快手视频 id 从哪里来？
快手链接和 share_info 里的 photoId 是 3x 开头的字符串，例如 3x5866am8whg2b6，Scavio 的 /api/v1/kuaishou/video 和评论接口都接受它作为 photo_id。搜索结果里另有一个数字型 photo_id 字段，它在 JSON 里是超长整数，末几位会变成 0，不要用它去查详情；取 share_info 里的 photoId 即可。
快手评论怎么翻页？
第一页不传 cursor，响应里的 pcursor 就是下一页的游标，原样作为 cursor 传回。pcursor 为 "no_more" 时停止。楼中楼回复用 /video/sub-comments，传 photo_id 和一级评论的 root_comment_id，同样用 pcursor 翻页。
怎么知道一个快手账号正在直播？
把 user_id 传给 /api/v1/kuaishou/user/live，每次 1 积分。正在直播时 isLive 为 true，并返回直播标题；我们 11 月 2 日查珀莱雅官方旗舰店时，标题是“珀莱雅双11年终臻享好礼”，直播类型为 shop。没有在播时 isLive 为 false。
获取快手视频数据要花多少积分？
按接口计费：热榜、评论、回复、用户作品和直播状态 1 积分，视频详情 2 积分，四个搜索接口和用户主页 10 积分，videos/batch 一次最多 20 条视频 40 积分。把本文 7 步的请求和代码全部跑一遍共 28 积分，按 Growth 年付约 0.06 美元。
数据是快手中国还是 Kwai？
只是快手中国（kuaishou.com）。快手国际版 Kwai（kwai.com）的链接解析不了，kwai.com 的 id 也不会返回数据。