快手

快手 API

搜索快手公开视频,用用户 ID 或作者主页链接获取账号作品,按视频链接读取单条视频详情和一级评论,并获取热榜。

请求发到 POST https://api.everyinfra.com/api/v1/social,platform 填 kuaishou,action 填下方列表里的能力名,例如 search。

  • 12 个能力
  • 每千次 $0.56 起
  • 失败和空结果都不收费
  • 24h 健康值 98%

平台运行状态

24h 健康值
98%
健康

30 天趋势

快手 能力清单

能力做什么单价空白行均为 $0.81 / 千次24 小时运行状态 · 全部正常
关键词搜索search先按主题找视频,再从作者 ID 进入指定账号的作品列表。$0.56 / 千次正常
用户内容user_posts把搜索返回的用户 ID 用于 user_posts,保持作者与作品关联。$0.56 / 千次正常
热榜trending用 trending 一次读快手热榜,带名次、热度和每条热点下的作品 ID。正常
视频详情video用 video 读一条快手作品的文案、时长、互动数和作者。正常
评论comments用 comments 读快手作品下的顶层评论,看点赞数、IP 属地和作者有没有点赞。$1.6 / 千次健康 · 健康值 100%
热点榜hot_boards用 hot_boards 一次读快手的一张热点榜:热榜、文娱榜、社会榜或有用榜。正常
直播榜live_rank用 live_rank 读快手直播榜,按总榜或音乐、舞蹈、游戏等分类看人气主播。正常
带货榜shopping_rank用 shopping_rank 读快手带货榜,看热门带货主播,或者换成热销商品榜。正常
品牌榜brand_rank用 brand_rank 读快手品牌榜,按美妆、汽车、手机等行业看品牌账号的人气排名。正常
热搜人物榜hot_person_board用 hot_person_board 一次读快手热搜人物榜,看哪些账号正在被搜、为什么上榜。正常
直播状态user_live用 user_live 按快手数字用户 ID 查这个账号现在是不是在直播。正常
账号搜索user_search用 user_search 按昵称、快手号或领域词搜快手账号,带粉丝数和作品数。$8 / 千次正常

快手 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。 请求都发到 POST /api/v1/social, 切换 action 时,也要按对应接口调整参数。 同名参数在不同平台、不同接口中可能指向不同对象;请以该条说明中的格式和适用范围为准。

下方只展示平台官方资料,用于核对对象与术语,不表示平台对 EveryInfra 的授权或背书。 本接口接受的参数、字段与能力边界以各条说明为准,不与平台官方 API 直接等同。

所有能力都是同步调用。

能力必填参数可选参数单次条数单价空白行均为 $0.81 / 千次返回字段
searchkeyword—默认 20 · 最多 100$0.56 / 千次id · url · text · duration_ms · view_count · like_count · comment_count · share_count · posted_at · author_id · author_name · author_kwai_id · author_url · author_verified · follower_count · video_count · cover_url · avatar_url · transcript · platform
user_postsuser_id—默认 20 · 最多 100$0.56 / 千次id · url · text · duration_ms · view_count · like_count · comment_count · share_count · posted_at · author_id · author_name · author_kwai_id · author_url · author_verified · follower_count · video_count · cover_url · avatar_url · transcript · platform
trending——默认 50 · 最多 50rank · title · hot_value · label · cover_url · video_ids · platform
videourl——id · url · text · duration_ms · view_count · like_count · comment_count · share_count · collect_count · posted_at · author_id · author_name · author_kwai_id · author_url · author_verified · author_gender · cover_url · avatar_url · platform
commentsurlpage_token每页 50 条$1.6 / 千次next_page_token · id · text · like_count · posted_at · author_id · author_name · author_avatar_url · author_gender · author_verified · ip_location · liked_by_author · platform
hot_boards—board默认 50 · 最多 50rank · title · hot_value · view_count · label · platform
live_rank—category默认 50 · 最多 50rank · name · type · user_id · avatar_url · subtitle · live_stream_id · popularity · platform
shopping_rank—board默认 50 · 最多 50rank · name · type · user_id · seller_id · product_id · price_cny · promotion · avatar_url · image_url · live_stream_id · popularity · platform
brand_rank—category默认 50 · 最多 50rank · name · type · user_id · avatar_url · live_stream_id · popularity · platform
hot_person_board——默认 50 · 最多 50rank · name · type · user_id · avatar_url · reason · popularity · platform
user_liveuser_id——user_id · is_live · video_count · platform
user_searchkeywordpage_token每页 20 条$8 / 千次next_page_token · user_id · nickname · kwai_id · bio · gender · verified · follower_count · video_count · avatar_url · platform

怎么调用 快手 用户内容 API?

user_posts

使用 platform="kuaishou"、action="user_posts" 调用“用户内容”能力;返回列表,默认 20 条、单次最多 100 条,主要包含 id、url、text、duration_ms、view_count、like_count 等 20 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 user_posts 的参数分别是什么意思?

user_id必填
快手用户 ID 或作者主页链接(支持 /profile/{id} 与 /@{user} 两种形式),user_posts 从该主页取视频;可从视频搜索结果的 author_id / author_url 直接取得。

快手小程序的主页跳转能力可将快手号转换为 UID,但这是该官方组件的行为。EveryInfra 的 user_id 仍按上方格式使用搜索返回的 ID,不据此宣称支持任意快手号自动转换。官方来源:快手:主页跳转的标识转换不等于本接口能力来源核查:

快手 返回字段与含义(9)
author_kwai_id
快手号(用户自定义 ID)。
author_verified
作者是否认证(comments 上是评论者)。
cover_url
封面图(trending 上是这条热点的配图)。
duration_ms
时长,毫秒。
transcript
视频口播文案转写(有数据时返回)。
follower_count
粉丝数(search、user_posts 是作者的;user_search 是这个账号的)。
video_count
累计作品数(search、user_posts 是作者的;user_live、user_search 是这个账号的)。
like_count
点赞数。
view_count
这条热点的浏览量(hot_boards)。

怎么调用 快手 视频详情 API?

video

使用 platform="kuaishou"、action="video" 调用“视频详情”能力;返回单个对象,主要包含 id、url、text、duration_ms、view_count、like_count 等 19 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 video 的参数分别是什么意思?

url必填
快手作品链接(https://www.kuaishou.com/short-video/<作品ID>),也可以直接填作品 ID:3x 开头的短 ID(如 3xmbjwnf3ugq3z4,trending 结果的 video_ids 里就是这种)或纯数字 ID。
快手 返回字段与含义(7)
author_kwai_id
快手号(用户自定义 ID)。
author_verified
作者是否认证(comments 上是评论者)。
cover_url
封面图(trending 上是这条热点的配图)。
duration_ms
时长,毫秒。
like_count
点赞数。
view_count
这条热点的浏览量(hot_boards)。
author_gender
作者性别(video、comments:M 男 / F 女)。

怎么调用 快手 评论 API?

comments

使用 platform="kuaishou"、action="comments" 调用“评论”能力;返回列表,每次一页、固定 50 条,更多用 next_page_token 翻页,主要包含 next_page_token、id、text、like_count、posted_at、author_id 等 13 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 comments 的参数分别是什么意思?

url必填
快手作品链接(https://www.kuaishou.com/short-video/<作品ID>),也可以直接填作品 ID:3x 开头的短 ID 或纯数字 ID。每次返回一页顶层评论,一页条数不固定(多为 10 条,最多约 50 条),更多用 next_page_token 翻页。

官方评论规范确认评论是快手作品下的正式内容对象;它没有提供读取任意作品评论列表的公开接口,也不证明 EveryInfra 对 /short-video、/video、/photo 路径的 ID 提取、翻页或最大评论数。官方来源:快手:评论是作品下的正式内容对象来源核查:

page_token可选
翻页令牌。第一页不传;之后把上一页响应里的 next_page_token 原样传回取下一页,作品不变。每页算一次调用;翻到底时响应里没有 next_page_token。
快手 返回字段与含义(6)
author_verified
作者是否认证(comments 上是评论者)。
like_count
点赞数。
author_gender
作者性别(video、comments:M 男 / F 女)。
ip_location
评论者的 IP 属地(comments,平台展示的省份)。
liked_by_author
这条评论是否被作品作者点赞(comments)。
next_page_token
翻页令牌(comments、user_search):作为下一次请求的 page_token 原样传回取下一页(其余参数不变,24 小时内有效);同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。

怎么调用 快手 热点榜 API?

hot_boards

使用 platform="kuaishou"、action="hot_boards" 调用“热点榜”能力;返回列表,默认 50 条、单次最多 50 条,主要包含 rank、title、hot_value、view_count、label、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 hot_boards 的参数分别是什么意思?

board可选
榜单:hot 热榜(默认)/ entertainment 文娱榜 / society 社会榜 / useful 有用榜。每次给整个榜(约 50 条)。
查看全部 4 个允许值

entertainmenthotsocietyuseful

快手 返回字段与含义(4)
view_count
这条热点的浏览量(hot_boards)。
rank
榜单名次,从 1 开始,按快手榜单顺序(trending、hot_boards:置顶的那条排第 1)。
hot_value
热度(trending、hot_boards):快手热榜显示的热度值,页面上写成「1244.2万」,这里换成整数 12442000;置顶那条可能没有。只在榜单内可比。
label
热榜角标,原文:置顶 / 新 / 独家 等(trending;hot_boards 只标置顶);没有角标时没有这个字段。

怎么调用 快手 直播榜 API?

live_rank

使用 platform="kuaishou"、action="live_rank" 调用“直播榜”能力;返回列表,默认 50 条、单次最多 50 条,主要包含 rank、name、type、user_id、avatar_url、subtitle 等 9 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 live_rank 的参数分别是什么意思?

category可选
直播榜分类:all 总榜(默认)/ music 音乐 / dance 舞蹈 / looks 颜值 / chinese_art 国艺 / dating 相亲 / gaming 游戏 / anime 二次元 / story 故事 / group_live 团播 / multi_host 九宫格。每次给这一类的整个榜(最多 50 个主播)。
查看全部 11 个允许值

allanimechinese_artdancedatinggaminggroup_livelooksmulti_hostmusicstory

快手 返回字段与含义(7)
rank
榜单名次,从 1 开始,按快手榜单顺序(trending、hot_boards:置顶的那条排第 1)。
name
上榜对象的名字(live_rank、shopping_rank、brand_rank、hot_person_board):主播 / 品牌账号昵称,带货榜商品行是商品标题。
type
上榜对象的类型(rank 类能力):user 账号(主播、品牌、人物)/ product 商品(只有 shopping_rank 的 products 榜)。
user_id
快手数字用户 ID(rank 类能力、user_search、user_live),可传 user_live 查直播状态。
subtitle
榜单上名字下面那行字(live_rank 是直播间标题,hot_person_board 没有这一项,见 reason)。
live_stream_id
正在进行的直播场次 ID(live_rank、shopping_rank、brand_rank 的主播行;没在播时没有)。
popularity
榜单上显示的人气 / 热度,换成整数(「15.5万人气」→ 155000),快手自有指标,只在同一个榜里比较。

怎么调用 快手 带货榜 API?

shopping_rank

使用 platform="kuaishou"、action="shopping_rank" 调用“带货榜”能力;返回列表,默认 50 条、单次最多 50 条,主要包含 rank、name、type、user_id、seller_id、product_id 等 13 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 shopping_rank 的参数分别是什么意思?

board可选
带货榜:hosts 热门主播(默认)/ products 热销商品。每次给整个榜(最多 50 条)。
查看全部 2 个允许值

hostsproducts

快手 返回字段与含义(11)
rank
榜单名次,从 1 开始,按快手榜单顺序(trending、hot_boards:置顶的那条排第 1)。
name
上榜对象的名字(live_rank、shopping_rank、brand_rank、hot_person_board):主播 / 品牌账号昵称,带货榜商品行是商品标题。
type
上榜对象的类型(rank 类能力):user 账号(主播、品牌、人物)/ product 商品(只有 shopping_rank 的 products 榜)。
user_id
快手数字用户 ID(rank 类能力、user_search、user_live),可传 user_live 查直播状态。
live_stream_id
正在进行的直播场次 ID(live_rank、shopping_rank、brand_rank 的主播行;没在播时没有)。
popularity
榜单上显示的人气 / 热度,换成整数(「15.5万人气」→ 155000),快手自有指标,只在同一个榜里比较。
seller_id
卖这个商品的快手账号的数字用户 ID(shopping_rank 商品行)。
product_id
快手小店商品 ID(shopping_rank 商品行)。
price_cny
商品价格,人民币元(shopping_rank 商品行,榜单上显示的价格)。
promotion
商品角标原文(shopping_rank 商品行),如 满20减4、好评率98%。
image_url
商品主图(shopping_rank 商品行)。

怎么调用 快手 品牌榜 API?

brand_rank

使用 platform="kuaishou"、action="brand_rank" 调用“品牌榜”能力;返回列表,默认 50 条、单次最多 50 条,主要包含 rank、name、type、user_id、avatar_url、live_stream_id 等 8 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 brand_rank 的参数分别是什么意思?

category可选
品牌榜行业:beauty 美妆(默认)/ apparel 服饰 / auto 汽车 / gaming 游戏 / health 医疗健康 / electronics 3C数码 / phones 手机 / appliances 家电 / baby 母婴 / food_drink 食品饮料。每次给这个行业的整个榜(最多 50 个品牌账号)。
查看全部 10 个允许值

apparelappliancesautobabybeautyelectronicsfood_drinkgaminghealthphones

快手 返回字段与含义(6)
rank
榜单名次,从 1 开始,按快手榜单顺序(trending、hot_boards:置顶的那条排第 1)。
name
上榜对象的名字(live_rank、shopping_rank、brand_rank、hot_person_board):主播 / 品牌账号昵称,带货榜商品行是商品标题。
type
上榜对象的类型(rank 类能力):user 账号(主播、品牌、人物)/ product 商品(只有 shopping_rank 的 products 榜)。
user_id
快手数字用户 ID(rank 类能力、user_search、user_live),可传 user_live 查直播状态。
live_stream_id
正在进行的直播场次 ID(live_rank、shopping_rank、brand_rank 的主播行;没在播时没有)。
popularity
榜单上显示的人气 / 热度,换成整数(「15.5万人气」→ 155000),快手自有指标,只在同一个榜里比较。

怎么调用 快手 热搜人物榜 API?

hot_person_board

使用 platform="kuaishou"、action="hot_person_board" 调用“热搜人物榜”能力;返回列表,默认 50 条、单次最多 50 条,主要包含 rank、name、type、user_id、avatar_url、reason 等 8 个字段。

查看完整接口文档:参数、代码示例、响应样例与健康状态

这个能力没有业务参数,只传 platform 与 action。

快手 返回字段与含义(6)
rank
榜单名次,从 1 开始,按快手榜单顺序(trending、hot_boards:置顶的那条排第 1)。
name
上榜对象的名字(live_rank、shopping_rank、brand_rank、hot_person_board):主播 / 品牌账号昵称,带货榜商品行是商品标题。
type
上榜对象的类型(rank 类能力):user 账号(主播、品牌、人物)/ product 商品(只有 shopping_rank 的 products 榜)。
user_id
快手数字用户 ID(rank 类能力、user_search、user_live),可传 user_live 查直播状态。
popularity
榜单上显示的人气 / 热度,换成整数(「15.5万人气」→ 155000),快手自有指标,只在同一个榜里比较。
reason
上榜原因(hot_person_board),快手原文,如 作品更新、近期搜索量飙升。

怎么调用 快手 直播状态 API?

user_live

使用 platform="kuaishou"、action="user_live" 调用“直播状态”能力;返回单个对象,主要包含 user_id、is_live、video_count、platform。

查看完整接口文档:参数、代码示例、响应样例与健康状态

快手 user_live 的参数分别是什么意思?

user_id必填
快手数字用户 ID(如 501353480),取自 live_rank、user_search 等返回行的 user_id;也收 kuaishou.com/profile/<数字ID> 链接。
快手 返回字段与含义(3)
video_count
累计作品数(search、user_posts 是作者的;user_live、user_search 是这个账号的)。
user_id
快手数字用户 ID(rank 类能力、user_search、user_live),可传 user_live 查直播状态。
is_live
这个账号现在是否在直播(user_live)。
快手 search 调用流程一次 快手 search 调用的全过程:向 POST /api/v1/social 发送 platform="kuaishou"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、duration_ms、view_count 等字段;返回列表,单次最多 100 条,计费 $0.56 / 千次,失败与空结果不计费。1 · 请求POST /api/v1/socialplatform: "kuaishou"action: "search"keywordEveryInfra$0.56 / 千次2 · 响应 · 列表idurltextduration_msview_count
一次 快手 search 调用的全过程:向 POST /api/v1/social 发送 platform="kuaishou"、action="search",以及必填参数 keyword;返回结构化 JSON,含 id、url、text、duration_ms、view_count 等字段;返回列表,单次最多 100 条,计费 $0.56 / 千次,失败与空结果不计费。

快手 原始字段名

EveryInfra 统一字段名

左边是 快手 数据里原本的字段名,右边是我们统一后的。点任意一行看对应关系。106 个平台复用通用字段命名,减少重复适配; 切换平台仍需核对参数、字段集合、类型与空值含义。这里展示映射关系,不是目标的实时返回数据。

快手 的独有字段名(当前目录)

全站 106 个平台的当前目录中,这 7 个字段名只在 快手 出现。 这是字段命名的分布,不代表其他平台没有同类信息,也不保证每次响应都含这些字段;具体含义和返回条件仍需逐接口核对。

  • author_kwai_id
  • transcript
  • video_ids
  • live_stream_id
  • popularity
  • reason
  • kwai_id

返回字段含义

通用字段采用统一命名;切换平台时仍需核对目标格式、字段是否存在、类型、空值与平台特有含义。 机器可读版:/api/v1/social/fields

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签,全文返回、不截断(个别平台的列表结果本身只有摘要,以该平台的字段说明为准)。
duration_ms
时长,毫秒。
view_count
这条热点的浏览量(hot_boards)。
like_count
点赞数。
comment_count
评论数。null 表示不公开,不等于 0。
share_count
分享/转发数。null 表示不公开,不等于 0。
posted_at
发布时间,ISO 8601 格式、UTC 时区(如 2026-08-07T12:34:56+00:00)。平台只给非标准字符串时原样透传,解析前建议做容错。null 表示平台未公开。
author_id
作者在原平台的唯一 ID。
author_name
作者昵称(显示名)。
author_kwai_id
快手号(用户自定义 ID)。
author_url
作者在原平台的主页链接。
author_verified
作者是否认证(comments 上是评论者)。
follower_count
粉丝数(search、user_posts 是作者的;user_search 是这个账号的)。
video_count
累计作品数(search、user_posts 是作者的;user_live、user_search 是这个账号的)。
cover_url
封面图(trending 上是这条热点的配图)。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
transcript
视频口播文案转写(有数据时返回)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。
rank
榜单名次,从 1 开始,按快手榜单顺序(trending、hot_boards:置顶的那条排第 1)。
title
标题。平台无标题概念时(如纯文本帖)为 null。
hot_value
热度(trending、hot_boards):快手热榜显示的热度值,页面上写成「1244.2万」,这里换成整数 12442000;置顶那条可能没有。只在榜单内可比。
label
热榜角标,原文:置顶 / 新 / 独家 等(trending;hot_boards 只标置顶);没有角标时没有这个字段。
video_ids
这条热点下的作品 ID 列表(trending,3x 开头的短 ID),可直接传给 video、comments 的 url;有时榜单不带作品 ID,这时没有这个字段。
collect_count
收藏数。null 表示不公开,不等于 0。
author_gender
作者性别(video、comments:M 男 / F 女)。
next_page_token
翻页令牌(comments、user_search):作为下一次请求的 page_token 原样传回取下一页(其余参数不变,24 小时内有效);同一页每行的值相同,响应顶层也有同一个 next_page_token。没有该字段即到底。
author_avatar_url
作者头像图片链接(多数平台带签名、会过期)。
ip_location
评论者的 IP 属地(comments,平台展示的省份)。
liked_by_author
这条评论是否被作品作者点赞(comments)。
name
上榜对象的名字(live_rank、shopping_rank、brand_rank、hot_person_board):主播 / 品牌账号昵称,带货榜商品行是商品标题。
type
上榜对象的类型(rank 类能力):user 账号(主播、品牌、人物)/ product 商品(只有 shopping_rank 的 products 榜)。
user_id
快手数字用户 ID(rank 类能力、user_search、user_live),可传 user_live 查直播状态。
subtitle
榜单上名字下面那行字(live_rank 是直播间标题,hot_person_board 没有这一项,见 reason)。
live_stream_id
正在进行的直播场次 ID(live_rank、shopping_rank、brand_rank 的主播行;没在播时没有)。
popularity
榜单上显示的人气 / 热度,换成整数(「15.5万人气」→ 155000),快手自有指标,只在同一个榜里比较。
seller_id
卖这个商品的快手账号的数字用户 ID(shopping_rank 商品行)。
product_id
快手小店商品 ID(shopping_rank 商品行)。
price_cny
商品价格,人民币元(shopping_rank 商品行,榜单上显示的价格)。
promotion
商品角标原文(shopping_rank 商品行),如 满20减4、好评率98%。
image_url
商品主图(shopping_rank 商品行)。
reason
上榜原因(hot_person_board),快手原文,如 作品更新、近期搜索量飙升。
is_live
这个账号现在是否在直播(user_live)。
nickname
昵称。
kwai_id
快手号(账号自己设的 ID,user_search);没设时没有。
bio
个人简介,账号自己填写的文本。可能含换行和 emoji。
gender
性别(user_search):M 男 / F 女。
verified
是否认证账号(user_search)。

请求填写示例

这里检索短视频;作者和单条作品查询使用各自的目标标识。

以下为填写格式示意,并非成功调用记录。请替换 API Key 和尖括号中的目标,确认可选筛选项后再调用;示例不保证目标当前有数据。

kuaishou_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"kuaishou","action":"search","params":{"keyword":"露营装备"}}'

记录字段预览(非真实响应)

仅展示 search 的记录字段,不包含外层响应、计费或任务状态。null 只作展示占位,不表示字段类型或实际空值;完整响应须以接口文档与实际调用为准。

fields.preview.json
{
  "id": null,
  "url": null,
  "text": null,
  "duration_ms": null,
  "view_count": null,
  "like_count": null,
  "comment_count": null,
  "share_count": null,
  "posted_at": null,
  "author_id": null,
  "author_name": null,
  "author_kwai_id": null,
  "author_url": null,
  "author_verified": null,
  "follower_count": null,
  "video_count": null,
  "cover_url": null,
  "avatar_url": null,
  "transcript": null,
  "platform": null
}

常见用例

以下是基于现有接口的接入思路,不是开箱即用的分析或告警功能。字段以实际返回为准,缺失值不按零处理。

用快手视频搜索发现内容与作者

先按主题找视频,再从作者 ID 进入指定账号的作品列表。

查看 search 的 keyword 参数
  • keyword 用于 search 视频搜索;id / url 定位作品,author_id 定位作者,author_kwai_id 是快手号展示信息,不直接代替 user_posts 所需的用户 ID。
  • view_count、like_count、comment_count 与 share_count 是各自计数,不提供观看者名单;url 是视频页面链接,不是可直接下载的 MP4 地址。

按快手用户 ID 整理其视频作品

把搜索返回的用户 ID 用于 user_posts,保持作者与作品关联。

查看 user_posts 的 user_id 参数
  • user_id 接受快手用户 ID 或作者主页链接,支持 /profile/{id} 与 /@{user};可从 search 结果的 author_id 或 author_url 取得。返回 author_id、id、url、text 与 posted_at 可用于关联作者与作品。
  • text 是作品文案;当前没有公开的排序、时间窗口或独立主页详情参数,不承诺全部历史投稿。默认条数与单次上限见本页能力清单,本次列表长度仍不代表账号作品总量。

快手热榜 API 如何一次拿到整张热榜?

用 trending 一次读快手热榜,带名次、热度和每条热点下的作品 ID。

查看 trending 接口说明
  • 不需要参数,一次给整张榜(最多 50 条),limit 只能调小。rank 从 1 开始、置顶那条排第 1;hot_value 把「1244.2万」这类写法换成整数;label 是置顶、新、独家等角标,没有角标时不出现。
  • video_ids 是这条热点下的作品短 ID(3x 开头),可以直接交给 video 或 comments;少数情况下这一项不出现。热度只在同一张榜里比较。

快手视频详情 API 如何按链接或作品 ID 读一条作品?

用 video 读一条快手作品的文案、时长、互动数和作者。

查看 video 的 url 参数
  • url 填作品链接(https://www.kuaishou.com/short-video/<作品ID>),也可以直接填 3x 开头的短 ID(trending 的 video_ids 里就是这种)或纯数字 ID。
  • 返回 duration_ms(毫秒)、view_count、like_count、comment_count、share_count、collect_count,作者有 author_id、author_kwai_id 快手号、author_gender、author_verified。计数是这一刻的数,不是历史曲线。

快手评论 API 如何逐页读一条作品下的评论?

用 comments 读快手作品下的顶层评论,看点赞数、IP 属地和作者有没有点赞。

查看 comments 的 url 参数
  • url 填作品链接或作品 ID(3x 短 ID 或纯数字)。每次一页顶层评论,条数不固定(多为 10 条,最多约 50 条),每页算一次调用;把 next_page_token 原样作为 page_token 传回取下一页,没有它就到底了。
  • 每行有 text、like_count、posted_at、ip_location(平台展示的省份)、liked_by_author(作品作者是否点赞)和评论者的 author_name、author_gender、author_verified。只给顶层评论,不含楼中楼回复。

快手热点榜 API 如何读文娱榜、社会榜和有用榜?

用 hot_boards 一次读快手的一张热点榜:热榜、文娱榜、社会榜或有用榜。

查看 hot_boards 的 board 参数
  • board 选 hot(默认)、entertainment、society 或 useful,一次给整张榜(约 50 条),limit 只能调小。rank 从 1 开始,置顶那条排第 1、label 是「置顶」;hot_value 是整数热度,view_count 是浏览数。
  • 只给热点标题和热度,不给封面和作品 ID;要热榜下的作品 ID 请用 trending。热度只在同一张榜里比较。

快手直播榜 API 如何看此刻人气最高的主播?

用 live_rank 读快手直播榜,按总榜或音乐、舞蹈、游戏等分类看人气主播。

查看 live_rank 的 category 参数
  • category 选 all(默认)或 music、dance、looks、chinese_art、dating、gaming、anime、story、group_live、multi_host,一次最多 50 个主播。
  • 每行有 rank、name、user_id(数字用户 ID,可交给 user_live)、avatar_url、subtitle(直播间标题)、live_stream_id 和 popularity(人气,把「15.5万人气」换成整数)。榜单是此刻的快照,人气只在同一张榜里比较。

快手带货榜 API 如何看热门带货主播和热销商品?

用 shopping_rank 读快手带货榜,看热门带货主播,或者换成热销商品榜。

查看 shopping_rank 的 board 参数
  • board 选 hosts(默认,热门带货主播)或 products(热销商品),一次最多 50 行。主播行有 name、user_id、avatar_url、live_stream_id 和 popularity。
  • 商品行的 type 是 product,有 product_id、seller_id(卖家用户 ID)、price_cny(人民币标价)、promotion(满减券、好评率等角标原文)和 image_url。price_cny 是上榜时的展示价,不含券后价。

快手品牌榜 API 如何按行业看品牌账号排名?

用 brand_rank 读快手品牌榜,按美妆、汽车、手机等行业看品牌账号的人气排名。

查看 brand_rank 的 category 参数
  • category 选 beauty(默认)、apparel、auto、gaming、health、electronics、phones、appliances、baby 或 food_drink,一次最多 50 个品牌账号。
  • 每行有 rank、name、user_id、avatar_url、live_stream_id(正在直播时才有)和 popularity。popularity 是快手榜单自己的人气分,只在同一行业榜里比较,不是销售额。

快手热搜人物榜 API 如何看哪些账号正在上热搜?

用 hot_person_board 一次读快手热搜人物榜,看哪些账号正在被搜、为什么上榜。

查看 hot_person_board 接口说明
  • 不需要参数,一次给整张榜(约 50 个账号),limit 只能调小。
  • 每行有 rank、name、user_id、avatar_url、popularity 和 reason(快手给的上榜原因,如「作品更新」「搜索飙升」)。榜单是此刻的快照,热度只在同一张榜里比较。

快手直播状态 API 如何查一个账号此刻是否在直播?

用 user_live 按快手数字用户 ID 查这个账号现在是不是在直播。

查看 user_live 的 user_id 参数
  • user_id 填数字用户 ID(如 501353480,可从 live_rank、user_search 结果里取),也可以填 kuaishou.com/profile/<数字ID> 链接;3x 开头的短 ID 不收。
  • 返回 is_live(此刻是否在直播)和 video_count(账号作品数)。只看当下状态,不给直播间详情和历史直播记录;查无此人时返回空结果。

快手用户搜索 API 如何按昵称或领域找账号?

用 user_search 按昵称、快手号或领域词搜快手账号,带粉丝数和作品数。

查看 user_search 的 keyword 参数
  • keyword 填昵称、快手号或领域词(如 美食)。每页 20 个账号,每页算一次调用;把 next_page_token 原样作为 page_token 传回取下一页,没有它就到底了。
  • 每行有 user_id(数字 ID,可交给 user_live)、nickname、kwai_id(账号设了快手号才有)、bio、gender、verified、follower_count、video_count 和 avatar_url。结果按快手的相关度排序,不按粉丝数。

快手 教程与实战

先在本页核对 action、参数和字段,再按你的任务看下面的完整步骤或相关做法。文章里的示例和边界说明只作参考,以本页的参数和字段为准。

指南

多平台口碑监控蓝图:先记录采集范围,再判断负面变化

做多平台口碑监控:从目标清单、评论身份和增量游标开始,设计可追溯的采集流程;用离线样本演示去重和采集缺口怎么发现,关键判断一律保留人工复核。

阅读完整文章
指南

统一数据 API 入门:从能力目录到第一条可用结果

用 platform、action、params 接入多平台数据:读懂能力目录,完成最小请求,处理异步任务、部分结果与计费,并建立可追溯的数据记录。

阅读完整文章

快手 API 常见问题

快手 API 怎么调用?

调用 POST /api/v1/social,请求体传 platform="kuaishou"、action 和 params。以 search 为例,必填 keyword,没有可选参数。这里检索短视频;作者和单条作品查询使用各自的目标标识。 快手 共 12 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 106 个平台。

快手 API 怎么收费?

每千次 $0.56 起,按能力不同(清单里逐条标了)。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 125 次 快手 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

快手 API 一次能返回多少条数据?

快手 有 10 个列表接口,包括 search、user_posts、trending、comments、hot_boards、live_rank、shopping_rank、brand_rank、hot_person_board、user_search。其余 2 个接口返回单个对象;对象内仍可能包含数组。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

快手 API 返回哪些字段?

当前目录为 search 列出 id、url、text、duration_ms、view_count、like_count 等 20 个字段名。按全站当前目录统计,7 个字段名只在 快手 出现;这不表示其他平台没有同类信息。字段不保证每次齐全,嵌套位置、类型与空值须按各接口说明核对,同名字段不代表语义可互换。

「用快手视频搜索发现内容与作者」怎样接入 快手 API?

先按主题找视频,再从作者 ID 进入指定账号的作品列表。 keyword 用于 search 视频搜索;id / url 定位作品,author_id 定位作者,author_kwai_id 是快手号展示信息,不直接代替 user_posts 所需的用户 ID。 view_count、like_count、comment_count 与 share_count 是各自计数,不提供观看者名单;url 是视频页面链接,不是可直接下载的 MP4 地址。

「按快手用户 ID 整理其视频作品」怎样接入 快手 API?

把搜索返回的用户 ID 用于 user_posts,保持作者与作品关联。 user_id 接受快手用户 ID 或作者主页链接,支持 /profile/{id} 与 /@{user};可从 search 结果的 author_id 或 author_url 取得。返回 author_id、id、url、text 与 posted_at 可用于关联作者与作品。 text 是作品文案;当前没有公开的排序、时间窗口或独立主页详情参数,不承诺全部历史投稿。默认条数与单次上限见本页能力清单,本次列表长度仍不代表账号作品总量。

快手热榜 API 如何一次拿到整张热榜?

用 trending 一次读快手热榜,带名次、热度和每条热点下的作品 ID。 不需要参数,一次给整张榜(最多 50 条),limit 只能调小。rank 从 1 开始、置顶那条排第 1;hot_value 把「1244.2万」这类写法换成整数;label 是置顶、新、独家等角标,没有角标时不出现。 video_ids 是这条热点下的作品短 ID(3x 开头),可以直接交给 video 或 comments;少数情况下这一项不出现。热度只在同一张榜里比较。

快手视频详情 API 如何按链接或作品 ID 读一条作品?

用 video 读一条快手作品的文案、时长、互动数和作者。 url 填作品链接(https://www.kuaishou.com/short-video/<作品ID>),也可以直接填 3x 开头的短 ID(trending 的 video_ids 里就是这种)或纯数字 ID。 返回 duration_ms(毫秒)、view_count、like_count、comment_count、share_count、collect_count,作者有 author_id、author_kwai_id 快手号、author_gender、author_verified。计数是这一刻的数,不是历史曲线。

可以先免费试用 快手 API 吗?

可以。注册免费,在 GitHub 给 everyinfra/everyinfra-agent-plugins 和 everyinfra/seo-skills 两个仓库都点星,就能在控制台「余额与充值」领取 $1 额度(≈720 次数据调用),直接进赠送余额,不用输码,24 小⁠时内有效。请先选择 快手 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 12 个能力。无需信用卡。

开始调用 快手 API

在 GitHub 给两个仓库点星领 $1 额度,注册后在控制台领取,24 小⁠时内有效,先选一个 快手 接口验证结果。

免费开始

自有访问统计常开;Google Analytics 仅在你点「同意分析」后启用。 隐私政策