社交内容 · 数据 API

快手

快手 API

搜索快手公开视频,或用用户 ID、作者主页链接获取账号作品;按返回的作者标识、作品链接与内容指标整理结果。 调用 POST /api/v1/social ;返回结构化 JSON,$0.56 / 千次;失败不计费。

2

个能力

$0.56 / 千次

能力价格

同步

调用模式

1 个

一把 Key 通用 89 个平台

快手 能力清单

action必填参数可选参数单次条数模式单价返回字段
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

快手 每个接口分别做什么

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

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

怎么调用 快手 用户内容 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,不据此宣称支持任意快手号自动转换。官方来源:快手:主页跳转的标识转换不等于本接口能力来源核查:

快手 特有返回字段与含义(7)
author_kwai_id
快手号(用户自定义 ID)。
author_verified
作者是否认证。
cover_url
封面。
duration_ms
时长,毫秒。
transcript
视频口播文案转写(有数据时返回)。
follower_count
作者粉丝数。
video_count
作者累计视频数。
快手 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 统一字段名

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

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

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

  • author_kwai_id

返回字段含义

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

id
该记录在原平台上的唯一标识。仅在同一平台内唯一,跨平台可能重复。
url
该记录在原平台上的可访问链接。
text
正文内容,已去除 HTML 标签。长文可能被截断。
duration_ms
时长,毫秒。
view_count
浏览/播放数。null 表示不公开,不等于 0。
like_count
点赞数。null 表示该平台或该接口不公开此数据,不等于 0。
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
作者是否认证。
follower_count
作者粉丝数。
video_count
作者累计视频数。
cover_url
封面。
avatar_url
头像图片链接。部分平台给的是带尺寸参数的 CDN 链接,可能有时效。
transcript
视频口播文案转写(有数据时返回)。
platform
数据来源平台标识,与请求里的 platform 一致(如 xiaohongshu、tiktok)。

请求填写示例

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

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

kuaishou_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的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 常见问题

快手 API 怎么调用?

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

快手 API 怎么收费?

$0.56 / 千次,快手 全部 2 个能力同价。按本页最高能力单价、每次单目标估算,$1 免费额度约可用于 1,798 次 快手 调用。费用按所选能力与目标数量计算,多目标请求不要按单目标估算;参数错误、鉴权失败和空结果不计费。

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

快手 有 2 个列表接口,包括 search、user_posts。数量参数要逐接口区分目标数、页数和记录数,不能将目录数值直接当作保证返回的条数;具体限制见对应参数与用例,不保证完整历史。

快手 API 返回哪些字段?

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

「用快手视频搜索发现内容与作者」怎样接入 快手 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 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用)。请先选择 快手 的目标接口,用单目标请求核对结果;实际可调用次数取决于能力价格与目标数量,不保证覆盖全部 2 个能力。无需信用卡。

开始调用 快手 API

加微信领 $1 免费额度,先选一个 快手 接口验证结果。实际可调用次数取决于能力价格与目标数量。

免费开始