微信公眾平臺(tái)于2015年1月6日啟動(dòng)了數(shù)據(jù)接口的邀請(qǐng)內(nèi)測。通過數(shù)據(jù)接口，開發(fā)者可以獲取與公眾平臺(tái)官網(wǎng)統(tǒng)計(jì)模塊類似但更靈活的數(shù)據(jù)，還可根據(jù)需要進(jìn)行高級(jí)處理。

邀請(qǐng)內(nèi)測期間，為保證服務(wù)質(zhì)量，數(shù)據(jù)接口僅向第三方平臺(tái)開發(fā)者開放。在微信開放平臺(tái)接入公眾號(hào)登錄授權(quán)即可成為第三方平臺(tái)開發(fā)者，第三方平臺(tái)可幫助運(yùn)營者管理公眾號(hào)，幫助已授權(quán)公眾號(hào)調(diào)用數(shù)據(jù)接口。在公眾號(hào)登錄授權(quán)機(jī)制的權(quán)限集劃分中，消息分析數(shù)據(jù)接口屬于消息與菜單權(quán)限集。

向所有公眾號(hào)開發(fā)者開放數(shù)據(jù)接口的時(shí)間將另行通知。

請(qǐng)注意：

1、接口側(cè)的公眾號(hào)數(shù)據(jù)的數(shù)據(jù)庫中僅存儲(chǔ)了2014年12月1日之后的數(shù)據(jù)，將查詢不到在此之前的日期，即使有查到，也是不可信的臟數(shù)據(jù)；
2、請(qǐng)開發(fā)者在調(diào)用接口獲取數(shù)據(jù)后，將數(shù)據(jù)保存在自身數(shù)據(jù)庫中，即加快下次用戶的訪問速度，也降低了微信側(cè)接口調(diào)用的不必要損耗。

消息分析數(shù)據(jù)接口指的是用于獲得公眾平臺(tái)官網(wǎng)數(shù)據(jù)統(tǒng)計(jì)模塊中消息分析數(shù)據(jù)的接口，具體接口列表如下（暫無消息關(guān)鍵詞數(shù)據(jù)接口）：

***時(shí)間跨度是指一次接口調(diào)用時(shí)***可獲取數(shù)據(jù)的時(shí)間范圍，如***時(shí)間跨度為7是指最多一次性獲取7天的數(shù)據(jù)。access_token的實(shí)際值請(qǐng)通過“獲取access_token”來獲取。

關(guān)于周數(shù)據(jù)與月數(shù)據(jù)，請(qǐng)注意：每個(gè)月/周的周期數(shù)據(jù)的數(shù)據(jù)標(biāo)注日期在當(dāng)月/當(dāng)周的***天（當(dāng)月1日或周一）。在某一月/周過后去調(diào)用接口， 才能獲取到該周期的數(shù)據(jù)。比如，在12月1日以（11月1日-11月5日）作為（begin_date和end_date）調(diào)用獲取月數(shù)據(jù)接口，可以獲取 到11月1日的月數(shù)據(jù)（即11月的月數(shù)據(jù)）。

接口調(diào)用請(qǐng)求說明

消息分析數(shù)據(jù)接口（包括接口列表中的所有接口）需要向相應(yīng)接口調(diào)用地址POST以下示例數(shù)據(jù)包：

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

調(diào)用參數(shù)說明

返回說明

獲取消息發(fā)送概況數(shù)據(jù)接口需要向相應(yīng)接口調(diào)用地址POST以下數(shù)據(jù)包：

{  
   "list": [  
       {  
           "ref_date": "2014-12-07",  
           "msg_type": 1,  
           "msg_user": 282,  
           "msg_count": 817 
       } 
    //后續(xù)還有同一ref_date的不同msg_type的數(shù)據(jù)，以及不同ref_date（在時(shí)間范圍內(nèi)）的數(shù)據(jù) 
   ] 
} 

獲取消息分送分時(shí)數(shù)據(jù)接口需要向相應(yīng)接口調(diào)用地址POST以下數(shù)據(jù)包：

{  
   "list": [  
       {  
           "ref_date": "2014-12-07",  
           "ref_hour": 0,  
           "msg_type": 1,  
           "msg_user": 9,  
           "msg_count": 10 
       } 
    //后續(xù)還有同一ref_hour的不同msg_type的數(shù)據(jù)，以及不同ref_hour的數(shù)據(jù)，ref_date固定，因?yàn)?**時(shí)間跨度為1 
   ] 
} 
 
獲取消息發(fā)送周數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下： 
 
{  
   "list": [  
       {  
           "ref_date": "2014-12-08",  
           "msg_type": 1,  
           "msg_user": 16,  
           "msg_count": 27 
       } 
        //后續(xù)還有同一ref_date下不同msg_type的數(shù)據(jù)，及不同ref_date的數(shù)據(jù) 
   ] 
} 

獲取消息發(fā)送月數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{  
   "list": [  
       {  
           "ref_date": "2014-11-01",  
           "msg_type": 1,  
           "msg_user": 7989,  
           "msg_count": 42206 
       } 
    //后續(xù)還有同一ref_date下不同msg_type的數(shù)據(jù)，及不同ref_date的數(shù)據(jù) 
   ] 
} 

獲取消息發(fā)送分布數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{  
   "list": [  
       {  
           "ref_date": "2014-12-07",  
           "count_interval": 1,  
           "msg_user": 246 
       } 
    //后續(xù)還有同一ref_date下不同count_interval的數(shù)據(jù)，及不同ref_date的數(shù)據(jù) 
   ] 
} 

獲取消息發(fā)送分布周數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{  
   "list": [  
       {  
           "ref_date": "2014-12-07",  
           "count_interval": 1,  
           "msg_user": 246 
       } 
    //后續(xù)還有同一ref_date下不同count_interval的數(shù)據(jù)，及不同ref_date的數(shù)據(jù) 
   ] 
} 

獲取消息發(fā)送分布月數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{  
   "list": [  
       {  
           "ref_date": "2014-12-07",  
           "count_interval": 1,  
           "msg_user": 246 
       } 
    //后續(xù)還有同一ref_date下不同count_interval的數(shù)據(jù)，及不同ref_date的數(shù)據(jù) 
   ] 
} 

返回參數(shù)說明

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，具體錯(cuò)誤碼查詢，請(qǐng)見：全局返回碼說明