# 短视频挂载数据查询

更新时间：2025-12-19 15:04:14

# 1.使用场景

支持小程序开发者通过接口分页获取近90天内挂载小程序PLC的视频数据明细，包括视频信息、流量转化、交易转化、互动数据。

# 2.接入方式

第一步：在快手开放平台 (opens new window)入驻，创建小程序应用，获得小程序appid

第二步：获取access_token

https://open.kuaishou.com/docs/develop/server/getAccessToken.html (opens new window)

第三步：请求接口

注意：若调用接口提示无查询权限，请前往开发者社区 (opens new window)发帖申请scope.ks.plc能力开通。

# 3.短视频挂载数据接口

# 3.1 请求信息

名称	内容
HTTP URL	https://open.kuaishou.com/openapi/mp/developer/plc/photo/query
HTTP Method	GET

# 3.2 请求参数

值	类型	含义	是否必须	位置
page_size	int	查询数量，最大500	否，默认500	Query Params中，即URL后边
cursor	string	查询起始坐标=返回值的next_cursor	否，默认0	Query Params中，即URL后边
access_token	String	接口调用凭证	是	Query Params中，即URL后边
app_id	string	小程序appid	是	Query Params中，即URL后边

# 3.3 请求示例

curl --request GET \
  --url 'http://open.kuaishou.com/openapi/mp/developer/plc/photo/query?page_size=100&cursor=1000&appId=&accessToken=' \

# 3.4 请求返回值

{
    "result": 1,
    "error_msg": "success",
    "data": {
        "records": {
            "appId": "ks123",
            "total": 1000,    // 数据总量
            "plcPhotoDetailList": [
                {
                    "id": 1,
                    "uploadDt": "2024-05-10",    // 视频发布时间
                    "photoUrl": "url",    // 视频链接,如果作品不可见时，返回空字符串
                    "photoId": "151784886673",    // 视频唯一标识
                    "photoTitle": "测试",    //视频标题
                    "plcMntpath": "/pages/home/index",    //挂载小程序页面路径
                    "openId": "",    // 作者open_id
                    "authorName": "测试",    // 作者名称
                    "accuDisplayFansUserNum": 168,    // 截至当前时间，该账号的粉丝数
                    "completePlayRatio": 0.24,    // 视频完播率
                    "displayCommentCnt": 8,    // 评论次数
                    "displayLikeCnt": 25,    // 点赞次数
                    "shareSuccessCnt": 2,    // 分享次数
                    "displayPlayCnt": 503,    // 视频挂载小程序时，小程序被观看的次数
                    "plcShowCnt": 503,    // PLC曝光次数
                    "plcClickCnt": 1,    // PLC点击次数
                    "plcClickEnterCnt": 1,    // PLC点击进入小程序次数
                    "submitOrderNum": 0,    // 创建订单数
                    "payOrderNum": 0,    // 支付订单数
                    "payOrderAmt": 0,    // 支付订单金额（单位：分）
                    "avgPrice": 0,    // 单均价（单位：分,四舍五入）
                    "refundOrderCnt": 0,    // 退款订单数
                    "refundAmt": 0    // 退款订单金额（单位：分）
                }
            ]
        },
        "next_cursor": "9302550",    // 分页游标，下次查询带上即可，如果返回 0 或plcPhotoDetailList为空则应该结束查询
        "log_id": "ks665688322744230657:fb9f9069-003f-4157-bd67-de043fad5272"    // 日志定位
    }
}

# 3.5 错误码

错误码	错误信息
10000412	小程序不存在
10002200	非法游标数据
10000500	服务端异常，稍后再试
10000200	非法参数
100200102	权限不足
100200100	参数为空
10000306	app调用接口次数过快，触发限流