数据统计接口-用户分析数据接口

安哥网络

数据统计接口-用户分析数据接口

微信公众平台于2015年1月6日启动了数据接口的邀请内测。通过数据接口，开发者可以获取与公众平台官网统计模块类似但更灵活的数据，还可根据需要进行高级处理。

邀请内测期间，为保证服务质量，数据接口仅向第三方平台开发者开放。在微信开放平台接入公众号登录授权即可成为第三方平台开发者，第三方平台可帮助运营者管理公众号，帮助已授权公众号调用数据接口。在公众号登录授权机制的权限集划分中，用户分析数据接口属于用户管理权限集。

向所有公众号开发者开放数据接口的时间将另行通知。

请注意：

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。

用户分析数据接口指的是用于获得公众平台官网数据统计模块中用户分析数据的接口，具体接口列表如下（暂无用户属性数据接口）：

接口名称	最大时间跨度	接口调用地址（必须使用https）
获取用户增减数据（getusersummary）	7	https://api.weixin.qq.com/datacube/getusersummary?access_token=ACCESS_TOKEN
获取累计用户数据（getusercumulate）	7	https://api.weixin.qq.com/datacube/getusercumulate?access_token=ACCESS_TOKEN

最大时间跨度是指一次接口调用时最大可获取数据的时间范围，如最大时间跨度为7是指最多一次性获取7天的数据。access_token的实际值请通过“获取access_token”来获取。

接口调用请求说明

用户分析数据接口（包括接口列表中的所有接口）需要向相应接口调用地址POST以下示例数据包：

{     "begin_date": "2014-12-02",     "end_date": "2014-12-07"}

调用参数说明

参数	是否必须	说明
access_token	是	调用接口凭证
begin_date	是	获取数据的起始日期，begin_date和end_date的差值需小于“最大时间跨度”（比如最大时间跨度为1时，begin_date和end_date的差值只能为0，才能小于1），否则会报错
end_date	是	获取数据的结束日期，end_date允许设置的最大值为昨日

返回说明

正常情况下，获取用户增减数据接口的返回JSON数据包如下：

{     "list": [         {             "ref_date": "2014-12-07",             "user_source": 0,             "new_user": 0,             "cancel_user": 0        }        //后续还有ref_date在begin_date和end_date之间的数据    ]}

正常情况下，获取累计用户数据接口的返回JSON数据包如下：

{     "list": [         {             "ref_date": "2014-12-07",             "cumulate_user": 1217056        },         //后续还有ref_date在begin_date和end_date之间的数据    ]}

返回参数说明

参数	说明
ref_date	数据的日期
user_source	用户的渠道，数值代表的含义如下： 0代表IT论坛 30代表扫二维码 17代表名片分享 35代表搜号码（即微信添加朋友页的搜索） 39代表查询微信公众帐号 43代表图文页右上角菜单
new_user	新增的用户数量
cancel_user	取消关注的用户数量，new_user减去cancel_user即为净增用户数量
cumulate_user	总用户量

错误时微信会返回错误码等信息，具体错误码查询，请见：全局返回码说明

数据统计接口-用户分析数据接口
http://mp.weixin.qq.com/wiki/3/e ... e5efac98e864b7.html