微信公众号开发手册

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

在公众号登录授权机制的权限集划分中，消息分析数据接口属于消息管理权限。

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

请注意：

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

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

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

关于周数据与月数据，请注意：每个月/周的周期数据的数据标注日期在当月/当周的第一天（当月1日或周一）。在某一月/周过后去调用接口，才能获取到该周期的数据。比如，在12月1日以（11月1日-11月5日）作为（begin_date和end_date）调用获取月数据接口，可以获取到11月1日的月数据（即11月的月数据）。

接口调用请求说明

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

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

调用参数说明

返回说明

获取消息发送概况数据接口需要向相应接口调用地址POST以下数据包：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "msg_type": 1, 
           "msg_user": 282, 
           "msg_count": 817
       }
	//后续还有同一ref_date的不同msg_type的数据，以及不同ref_date（在时间范围内）的数据
   ]
}

获取消息分送分时数据接口需要向相应接口调用地址POST以下数据包：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "ref_hour": 0, 
           "msg_type": 1, 
           "msg_user": 9, 
           "msg_count": 10
       }
	//后续还有同一ref_hour的不同msg_type的数据，以及不同ref_hour的数据，ref_date固定，因为最大时间跨度为1
   ]
}

获取消息发送周数据接口的返回json数据包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-08", 
           "msg_type": 1, 
           "msg_user": 16, 
           "msg_count": 27
       }
		//后续还有同一ref_date下不同msg_type的数据，及不同ref_date的数据
   ]
}

获取消息发送月数据接口的返回JSON数据包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-11-01", 
           "msg_type": 1, 
           "msg_user": 7989, 
           "msg_count": 42206
       }
	//后续还有同一ref_date下不同msg_type的数据，及不同ref_date的数据
   ]
}

获取消息发送分布数据接口的返回JSON数据包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据，及不同ref_date的数据
   ]
}

获取消息发送分布周数据接口的返回JSON数据包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据，及不同ref_date的数据
   ]
}

获取消息发送分布月数据接口的返回JSON数据包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "count_interval": 1, 
           "msg_user": 246
       }
	//后续还有同一ref_date下不同count_interval的数据，及不同ref_date的数据
   ]
}

返回参数说明

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