参数名	类型	必填	说明	示例
key	string	是	接口调用密钥；当前单文件接口默认未启用密钥校验，如需鉴权请在服务端增加校验逻辑
action	string	是	操作方法。传 list 获取分类列表；也可以传具体分类 action 获取对应推荐数据	list
count	string	否	每次请求返回的数据数量，允许范围为 1-50，省略时默认为 20	20
reset	string	否	是否清除当前 action 对应的本地 pcursor。传 1、true 或 yes 时清除，省略或传其他值时不清除

快手推荐视频

接口说明

该接口用于根据指定的频道分类获取快手推荐视频列表，涵盖男神、国风、次元等多个类别。适用于需要集成快手多频道推荐内容的开发者或应用调用。

调用地址

https://api.vsaa.cn/api/kuaishou/channel.php

请求方式

GET 或 POST

鉴权说明

接口调用需携带密钥，通过 URL 查询参数 key 传递。例如：https://api.vsaa.cn/api/kuaishou/channel.php?key=您的密钥&action=list。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥。通过 Query 参数传递，例如 `?key=您的密钥`。
action	string	是	操作方法。传 `list` 获取支持的所有频道分类列表；传具体的频道标识（如 `dimension_anime`）获取该频道的推荐视频数据。
count	string	否	指定返回的视频条目数量。有效范围为 1 到 50，若省略该参数，默认返回 20 条。
reset	string	否	控制是否重置分页游标。传 `1`、`true` 或 `yes` 时清除当前会话的分页状态，从列表头部重新开始；省略或传其他值时保持当前分页状态继续请求下一页。

成功响应示例

{
  "code": 0,
  "message": "success",
  "data": {
    "action": "dimension_anime",
    "name": "次元推荐",
    "request": {
      "channelId": 7147,
      "feedPoolId": "7151:0:7149:7151",
      "pcursor": "19:1791277200570",
      "count": 20
    },
    "next_pcursor": "37:1791035656872",
    "upstream": {
      "result": 1,
      "pcursor": "37:1791035656872",
      "llsid": "2005854237412792418",
      "host-name": "public-bjmt-c34-kce-node3841.idchb1az4.hb1.kwaidc.com",
      "photos": [
        {
          "singlePicture": false,
          "photoDeepLink": "kwai://work/5214324156214523792?userId=1345492925",
          "type": 1,
          "headUrls": [
            {
              "cdn": "p4-pro.a.yximgs.com",
              "url": "https://p4-pro.a.yximgs.com/uhead/AB/2022/12/08/10/BMjAyMjEyMDgxMDQ0MzlfMTM0NTQ5MjkyNV8xX2hkOTI1XzQyMQ==_s.jpg"
            },
            {
              "cdn": "p2-pro.a.yximgs.com",
              "url": "https://p2-pro.a.yximgs.com/uhead/AB/2022/12/08/10/BMjAyMjEyMDgxMDQ0MzlfMTM0NTQ5MjkyNV8xX2hkOTI1XzQyMQ==_s.jpg"
            }
          ],
          "coverUrls": [
            {
              "cdn": "p5.a.yximgs.com",
              "url": "https://p5.a.yximgs.com/upic/2026/10/05/23/BMjAyNjEwMDUyMzQxMDdfMTM0NTQ5MjkyNV8yMTEyNjU4MjcyMzlfMF8z_Be200f5fb024fc93d648c90e71a499244.jpg?tag=1-1791459716-unknown-0-rru0nhkhe4-2d7b8a3fce545e0a&clientCacheKey=3xfgfmmkzgze82e.jpg&di=d3a1ec2d&bp=10000"
            },
            {
              "cdn": "p2.a.yximgs.com",
              "url": "https://p2.a.yximgs.com/upic/2026/10/05/23/BMjAyNjEwMDUyMzQxMDdfMTM0NTQ5MjkyNV8yMTEyNjU4MjcyMzlfMF8z_Be200f5fb024fc93d648c90e71a499244.jpg?tag=1-1791459716-unknown-1-mbsve6cauq-5c521cdfa6778145&clientCacheKey=3xfgfmmkzgze82e.jpg&di=d3a1ec2d&bp=10000"
            }
          ],
          "webpCoverUrls": [
            {
              "cdn": "p5.a.yximgs.com",
              "url": "https://p5.a.yximgs.com/upic/2026/10/05/23/BMjAyNjEwMDUyMzQxMDdfMTM0NTQ5MjkyNV8yMTEyNjU4MjcyMzlfMF8z_Be200f5fb024fc93d648c90e71a499244.jpg?tag=1-1791459716-unknown-0-amxw9ryzem-efc782436cffa6e3&clientCacheKey=3xfgfmmkzgze82e.jpg&di=d3a1ec2d&bp=10000"
            },
            {
              "cdn": "p2.a.yximgs.com",
              "url": "https://p2.a.yximgs.com/upic/2026/10/05/23/BMjAyNjEwMDUyMzQxMDdfMTM0NTQ5MjkyNV8yMTEyNjU4MjcyMzlfMF8z_Be200f5fb024fc93d648c90e71a499244.jpg?tag=1-1791459716-unknown-1-bafcqozpuv-52765b065a3b46ca&clientCacheKey=3xfgfmmkzgze82e.jpg&di=d3a1ec2d&bp=10000"
            }
          ],
          "verified": false,
          "headUrl": "https://p4-pro.a.yximgs.com/uhead/AB/2

## 错误响应示例

当接口调用未成功时，返回体包含 `code`、`msg` 与 `errcode` 字段。业务异常时 `code` 通常为 0，`errcode` 对应具体错误类型，`msg` 提供可读描述。

```json
{
  "code": 0,
  "msg": "未提供调用密钥",
  "errcode": 11001
}

业务错误码说明

下表列出了快手推荐视频接口可能返回的全部业务错误码及其含义。调用方应根据 errcode 判断具体失败原因并做相应处理。

errcode	含义
11001	未提供调用密钥
11002	密钥错误
11003	密钥已禁用
11004	积分余额不足
11005	请求过于频繁（QPM 限制）
11006	接口维护中
11007	接口已禁用
11008	接口不可用
11009	密钥校验暂不可用
11010	积分系统暂不可用
11011	收费接口须提供有效密钥
11012	鉴权方式错误
11013	接口不存在
11014	***地址无效
11015	***地址不允许
11016	***请求失败
11017	服务暂不可用
11018	请求方式不允许
11019	当前IP不在白名单内
11020	启用出口代理须提供有效密钥
11021	未配置可用出口代理
11022	出口代理不可用
11023	密钥已过期
11024	令牌分配积分不足

调用示例

终端 curl（bash）

使用 list 获取频道分类列表，并通过 URL 查询参数传入密钥 key：

curl -X GET "https://api.vsaa.cn/api/kuaishou/channel.php" \
  --data-urlencode "key=您的接口密钥" \
  --data-urlencode "action=list"

获取“次元”频道的前 10 条推荐视频：

curl -X GET "https://api.vsaa.cn/api/kuaishou/channel.php" \
  --data-urlencode "key=您的接口密钥" \
  --data-urlencode "action=dimension_anime" \
  --data-urlencode "count=10"

PHP

注意事项

请将密钥仅在后端或服务端代码中保管，不要将其暴露在前端 JavaScript、客户端 App 或用户可见的日志中，防止被窃取后导致接口被滥用。
调用时务必通过 HTTPS 请求 https://api.vsaa.cn/api/kuaishou/channel.php，避免使用 HTTP 明文传输，保障密钥与请求数据的安全。
接口频率限制约为每分钟 60 次，请在业务侧添加合理的节流或缓存机制，避免短时间内的密集轮询导致请求被拒绝。
count 参数取值范围为 1-50，超出该范围的请求不会报错，但实际返回条数可能不符合预期，建议默认使用 20 或根据实际展示需求调整。
action 参数需传入具体的频道标识或 list。若传入无效的 action 字符串，接口将返回错误信息而非推荐数据，请通过先调用 action=list 获取合法标识列表后再进行后续查询。
返回数据中包含 next_pcursor，该字段用于分页。若需获取下一页数据，应保持相同的 action 并携带上一次的 next_pcursor；若需重新加载当前频道，可使用 reset=1 参数清除本地游标。
响应中的图片 URL 带有 CDN 签名，直接展示时无需额外鉴权，但需注意部分图片链接可能存在有效期，长期存储建议记录 photoId 并重新拉取。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

快手-频道系列

接口信息

请求参数

返回示例

详细文档

快手推荐视频

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

唱鸭