获取流量数据

更新时间：2024-12-04 15:31:01

简介

小程序开发者通过接口获取小程序的流量数据，支持指定范围时间格式获取近100天内的数据明细。

接入方式

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

第二步：提供appId，联系快手开放平台同学申请接口权限（scope：scope.us.profile）

第三步：获取access_token，查看获取方式 (opens new window)

第四步：请求接口路径

参数	使用说明
path	https://open.kuaishou.com/openapi/mp/developer/order/v1/report
Method	POST

请求参数说明

最多能查询最近100天数据，单次最多查询7天数据

值	类型	含义	是否必须	位置
begin_date	string	开始日期。格式为 yyyymmdd	是	Query Params中，即URL后边
end_date	string	结束日期，允许设置的最大值为昨日。格式为 yyyymmdd	是	Query Params中，即URL后边
access_token	String	接口调用凭证	是	Query Params中，即URL后边
app_id	string	小程序appId	是	Query Params中，即URL后边

请求示例

curl --request GET \
  --url 'http://open.kuaishou.com/openapi/mp/developer/plc/photo/query?begin_date=&end_date=&app_id=&access_token=' \

返回参数说明

{
    "result": 1,
    "error_msg": "success",
    "data": {
        "appId": "ks718605615927775478",
        "logId": "ks718605615927775478_511a5404-6f77-457c-a0f4-67bc5bbea50c",
        "records": [
            {
                "date": "20241101",
                "list": [
                    {
                        "openSourceName": "常用小程序",    // 打开渠道
                        "item": {
                            "visitDeviceNum": 2,    // 访问设备数
                            "visitPageCnt": 2        // 访问次数
                        }
                    },
                    {
                        "openSourceName": "视频左下角导流入口",
                        "item": {
                            "visitDeviceNum": 1,
                            "visitPageCnt": 1
                        }
                    },
                    {
                        "openSourceName": "小程序中心最近使用",
                        "item": {
                            "visitDeviceNum": 1,
                            "visitPageCnt": 1
                        }
                    },
                    {
                        "openSourceName": "搜索",
                        "item": {
                            "visitDeviceNum": 16,
                            "visitPageCnt": 21
                        }
                    },
                    {
                        "openSourceName": "all",    // 汇总数据，所有渠道的加和
                        "item": {
                            "visitDeviceNum": 20,
                            "visitPageCnt": 25
                        }
                    }
                ]
            },
            {
                "date": "20241102",
                "list": [
                    {
                        "openSourceName": "小程序中心最近使用",
                        "item": {
                            "visitDeviceNum": 2,
                            "visitPageCnt": 6
                        }
                    },
                    {
                        "openSourceName": "搜索",
                        "item": {
                            "visitDeviceNum": 27,
                            "visitPageCnt": 38
                        }
                    },
                    {
                        "openSourceName": "all",    // 汇总数据，所有场景的加和
                        "item": {
                            "visitDeviceNum": 29,
                            "visitPageCnt": 44
                        }
                    }
                ]
            }
        ]
    }
}

错误码信息

10000412	小程序不存在
10000500	服务端异常，稍后再试
10000200	非法参数，检查参数范围
100200102	权限不足
100200100	参数为空
10000306	app调用接口次数过快，触发限流