参数名	类型	必填	说明	示例
key	string	是	接口调用密钥

快手热门视频

接口说明

快手热门视频接口用于获取快手热门短视频内容信息。
适用于娱乐内容展示、视频聚合等场景。
接口提供热门视频数据查询服务，调用需使用有效密钥。

调用地址

https://api-v2.317ak.com/api/yljk/ksrmsp/api.php

请求方式

GET、POST

鉴权说明

接口调用需要进行密钥鉴权，请在 Query 参数中传递密钥：

key=…

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥，通过 Query 参数传递，用于接口鉴权

成功响应示例

{
  "code": 1,
  "text": "获取成功",
  "data": [
    {
      "author": {
        "id": "3xuek7tmc338h7w",
        "name": "白音音",
        "headerUrl": "https://example.com/avatar.jpg",
        "following": false,
        "headerUrls": null
      },
      "data": {
        "id": "3xwbepghhrcciua",
        "duration": 16683,
        "caption": "来晚了今天 #刻晴 #琵琶曲 #卡点舞",
        "likeCount": "1.4万",
        "viewCount": "74821",
        "realLikeCount": 13923,
        "coverUrl": "https://example.com/cover.jpg",
        "photoUrl": "https://example.com/video.mp4",
        "photoH265Url": "https://example.com/video-h265.mp4"
      }
    }
  ]
}

响应字段说明

字段	类型	说明
code	int	请求处理状态标识，成功时返回 `1`
text	string	请求结果描述信息
data	array	热门视频列表
data[].author	object	视频作者信息
data[].author.id	string	作者唯一标识
data[].author.name	string	作者名称
data[].author.headerUrl	string	作者头像地址
data[].author.following	boolean	当前关注状态
data[].author.headerUrls	null	作者头像扩展信息
data[].data	object	视频详情信息
data[].data.id	string	视频唯一标识
data[].data.duration	int	视频时长
data[].data.caption	string	视频标题及描述内容
data[].data.likeCount	string	点赞数量展示值
data[].data.viewCount	string	播放数量展示值
data[].data.realLikeCount	int	实际点赞数量
data[].data.coverUrl	string	视频封面地址
data[].data.photoUrl	string	视频播放地址
data[].data.photoH265Url	string	H265 编码视频地址

错误响应示例

接口发生业务异常时，返回统一 JSON 格式：

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

业务错误码说明

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）

curl -G "https://api-v2.317ak.com/api/yljk/ksrmsp/api.php" \
  --data-urlencode "key=你的接口密钥"

PHP



## 注意事项

- 本接口调用需要提供有效密钥，请妥善保管密钥信息，避免将密钥直接暴露在公开代码、客户端页面或可被他人获取的位置。
- 请通过 Query 参数 `key` 进行鉴权，例如请求时携带对应接口调用密钥。
- 接口采用 HTTPS 访问，请使用 HTTPS 请求地址进行调用，避免敏感参数在传输过程中被窃取。
- 本接口为热门视频数据获取服务，存在调用限制，请根据业务需求合理控制请求频率，避免短时间内高频重复请求导致调用受限。
- 返回内容包含视频信息、作者信息、封面地址及视频播放地址等数据，请根据实际业务场景使用，并注意遵守相关平台内容使用规范。
- `key` 参数为必填项，缺少该参数或参数值无效时，请求可能无法正常获取数据。
- 返回数据中的视频数量、内容排序及具体信息可能会随热门内容变化而变化，请勿依赖固定数据结构之外的动态内容。
- 建议对接口返回结果进行异常处理，例如调用失败、数据为空或返回状态异常等情况，以提升程序稳定性。

快手热门视频

接口信息

请求参数

返回示例

详细文档

快手热门视频

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

快速上手

在线测试

接口反馈

推荐接口

检测链接异常