經過10多天的微信公眾平台數據接口內測,現在正式對所有認證公眾號開放了。微信公眾平台數據接口正式向所有已微信認證(通過資質認證即可)的服務號和訂閱號開放。通過數據接口,公眾號開發者可以便利地獲取更詳細、更靈活的運營數據。

1、用戶分析數據接口
通過該接口可以獲取公眾號的用戶增減數據和累計用戶數據。
2、圖文分析數據接口
通過該接口可以獲取公眾號群發的圖文消息的閱讀、分享、收藏等數據。
3、消息分析數據接口
通過該接口可以獲取用戶向公眾號發送消息的數據,包括消息發送人數、次數,以及消息發布次數的分布等。
4、接口分析數據接口
通過該接口可以獲取公眾號在通過接口響應用戶消息時的性能數據,包括接口回復次數、耗時等。
微信公眾平台數據接口開發者文檔
微信公眾平台於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代表其他 30代表掃二維碼 17代表名片分享 35代表搜號碼(即微信添加朋友頁的搜索) 39代表查詢微信公眾帳號 43代表圖文頁右上角菜單 |
| new_user | 新增的用戶數量 |
| cancel_user | 取消關注的用戶數量,new_user減去cancel_user即為凈增用戶數量 |
| cumulate_user | 總用戶量 |
