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

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

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

請注意：

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

圖文分析數(shù)據(jù)接口指的是用于獲得公眾平臺官網(wǎng)數(shù)據(jù)統(tǒng)計模塊中圖文分析數(shù)據(jù)的接口，具體接口列表如下：

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

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

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

返回說明

正常情況下，獲取圖文群發(fā)每日數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
"list": [ 
{ 
"ref_date": "2014-12-08", 
"msgid": "10000050_1", 
"title": "12月27日 DiLi日報", 
"int_page_read_user": 23676, 
"int_page_read_count": 25615, 
"ori_page_read_user": 29, 
"ori_page_read_count": 34, 
"share_user": 122, 
"share_count": 994, 
"add_to_fav_user": 1, 
"add_to_fav_count": 3 
} 
//后續(xù)會列出該日期內(nèi)所有被閱讀過的文章（僅包括群發(fā)的文章）在當(dāng)天的閱讀次數(shù)等數(shù)據(jù) 
] 
} 

正常情況下，獲取圖文群發(fā)總數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下（請注意，details中，每天對應(yīng)的數(shù)值為該文章到該日為止的總量（而不是當(dāng)日的量））。 額外需要注意獲取圖文群發(fā)每日數(shù)據(jù)（getarticlesummary）和獲取圖文群發(fā)總數(shù)據(jù)（getarticletotal）的區(qū)別如下：

1、前者獲取的是某天所有被閱讀過的文章（僅包括群發(fā)的文章）在當(dāng)天的閱讀次數(shù)等數(shù)據(jù)。
2、后者獲取的是，某天群發(fā)的文章，從群發(fā)日起到接口調(diào)用日（但最多統(tǒng)計發(fā)表日后7天數(shù)據(jù)），每天的到當(dāng)天的總等數(shù)據(jù)。例如某篇文章是12月1日發(fā)出的，發(fā)出后在1日、2日、3日的閱讀次數(shù)分別為1萬，則getarticletotal獲取到的數(shù)據(jù)為，距發(fā)出到12月1日24時的總閱讀量為1萬，距發(fā)出到12月2日24時的總閱讀量為2萬，距發(fā)出到12月1日24時的總閱讀量為3萬。

{ 
"list": [ 
{ 
"ref_date": "2014-12-14", 
"msgid": "202457380_1", 
"title": "馬航丟畫記", 
"details": [ 
{ 
"stat_date": "2014-12-14", 
"target_user": 261917, 
"int_page_read_user": 23676, 
"int_page_read_count": 25615, 
"ori_page_read_user": 29, 
"ori_page_read_count": 34, 
"share_user": 122, 
"share_count": 994, 
"add_to_fav_user": 1, 
"add_to_fav_count": 3 
}, 
//后續(xù)還會列出所有stat_date符合“ref_date（群發(fā)的日期）到接口調(diào)用日期”（但最多只統(tǒng)計7天）的數(shù)據(jù) 
] 
}, 
//后續(xù)還有ref_date（群發(fā)的日期）在begin_date和end_date之間的群發(fā)文章的數(shù)據(jù) 
] 
} 
 
正常情況下，獲取圖文統(tǒng)計數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下： 
 
{ 
"list": [ 
{ 
"ref_date": "2014-12-07", 
"int_page_read_user": 45524, 
"int_page_read_count": 48796, 
"ori_page_read_user": 11, 
"ori_page_read_count": 35, 
"share_user": 11, 
"share_count": 276, 
"add_to_fav_user": 5, 
"add_to_fav_count": 15 
}, 
//后續(xù)還有ref_date在begin_date和end_date之間的數(shù)據(jù) 
] 
} 

正常情況下，獲取圖文統(tǒng)計分時數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
"list": [ 
{ 
"ref_date": "2014-12-07", 
"ref_hour": 1200, 
"int_page_read_user": 0, 
"int_page_read_count": 0, 
"ori_page_read_user": 4, 
"ori_page_read_count": 25517, 
"share_user": 4, 
"share_count": 96, 
"add_to_fav_user": 1, 
"add_to_fav_count": 3 
} 
//后續(xù)還有ref_hour逐漸增大,以列舉1天24小時的數(shù)據(jù) 
] 
} 
 
正常情況下，獲取圖文分享轉(zhuǎn)發(fā)數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下： 
 
{ 
"list": [ 
{ 
"ref_date": "2014-12-07", 
"share_scene": 1, 
"share_count": 207, 
"share_user": 11 
}, 
{ 
"ref_date": "2014-12-07", 
"share_scene": 5, 
"share_count": 23, 
"share_user": 11 
} 
//后續(xù)還有不同share_scene（分享場景）的數(shù)據(jù)，以及ref_date在begin_date和end_date之間的數(shù)據(jù) 
] 
} 

正常情況下，獲取圖文分享轉(zhuǎn)發(fā)每日數(shù)據(jù)接口的返回JSON數(shù)據(jù)包如下：

{ 
"list": [ 
{ 
"ref_date": "2014-12-07", 
"ref_hour": 1200, 
"share_scene": 1, 
"share_count": 72, 
"share_user": 4 
} 
//后續(xù)還有不同share_scene的數(shù)據(jù)，以及ref_hour逐漸增大的數(shù)據(jù)。由于***時間跨度為1，所以ref_date此處固定 
] 
}