圖文分析資料介面

微信公眾平台於2015年1月6日啟動了資料介面的邀請內測。透過數據接口，開發者可以獲得與公眾平台官網統計模組類似但更靈活的數據，還可根據需要進行高級處理。

在公眾號登入授權機制的權限集分割中，圖文分析資料介面屬於群發與通知權限。

向所有公眾號開發者開放資料介面的時間將另行通知。

請注意：

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。
3、额外注意，获取图文群发每日数据接口的结果中，只有中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3的结果才会得到统计，过小的阅读量的图文消息无法统计。

圖文分析資料介面指的是用於取得公眾平台官網資料統計模組中圖文分析資料的接口，具體介面清單如下：

最大時間跨度是指一次介面呼叫時最大可取得資料的時間範圍，如最大時間跨度為7是指最多一次性取得7天的資料。 access_token的實際值請透過「取得access_token」來取得。

介面呼叫請求說明

圖文分析資料介面（包含介面清單中的所有介面）需要呼叫對應介面位址POST以下範例封包：

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

呼叫參數說明

回傳說明

正常情況下，取得圖文群發每日資料介面的回傳JSON封包如下：

{ 
    "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
        } 
 	 //后续会列出该日期内所有被阅读过的文章（仅包括群发的文章）在当天的阅读次数等数据
    ]
}

正常情況下，取得圖文群發總資料介面的回傳JSON封包如下（請注意，details中，每天對應的數值為該文章到該日為止的總量（而不是當日的量））。 額外需要注意取得圖文群發每日資料（getarticlesummary）和取得圖文群發總資料（getarticletotal）的差異如下：

1、前者获取的是某天所有被阅读过的文章（仅包括群发的文章）在当天的阅读次数等数据。
2、后者获取的是，某天群发的文章，从群发日起到接口调用日（但最多统计发表日后7天数据），每天的到当天的总等数据。例如某篇文章是12月1日发出的，发出后在1日、2日、3日的阅读次数分别为1万，则getarticletotal获取到的数据为，距发出到12月1日24时的总阅读量为1万，距发出到12月2日24时的总阅读量为2万，距发出到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,
                    "int_page_from_session_read_user": 657283, 
                    "int_page_from_session_read_count": 753486, 
                    "int_page_from_hist_msg_read_user": 1669, 
                    "int_page_from_hist_msg_read_count": 1920, 
                    "int_page_from_feed_read_user": 367308, 
                    "int_page_from_feed_read_count": 433422, 
                    "int_page_from_friends_read_user": 15428, 
                    "int_page_from_friends_read_count": 19645, 
                    "int_page_from_other_read_user": 477, 
                    "int_page_from_other_read_count": 703, 
                    "feed_share_from_session_user": 63925, 
                    "feed_share_from_session_cnt": 66489, 
                    "feed_share_from_feed_user": 18249, 
                    "feed_share_from_feed_cnt": 19319, 
                    "feed_share_from_other_user": 731, 
                    "feed_share_from_other_cnt": 775
               }, 
	//后续还会列出所有stat_date符合“ref_date（群发的日期）到接口调用日期”（但最多只统计7天）的数据
           ]
       },
	//后续还有ref_date（群发的日期）在begin_date和end_date之间的群发文章的数据
   ]
}

正常情況下，取得圖文統計資料接口的回傳JSON封包如下：

{ 
   "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
       }, 
	//后续还有ref_date在begin_date和end_date之间的数据
   ]
}

正常情況下，取得圖文統計分時資料介面的回傳JSON封包如下：

{ 
   {
   "list": [
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 0, 
           "int_page_read_user": 6391, 
           "int_page_read_count": 7836, 
           "ori_page_read_user": 375, 
           "ori_page_read_count": 440, 
           "share_user": 2, 
           "share_count": 2, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }, 
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 1, 
           "int_page_read_user": 1, 
           "int_page_read_count": 1, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 0, 
           "share_count": 0, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }, 
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 2, 
           "int_page_read_user": 3, 
           "int_page_read_count": 3, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 0, 
           "share_count": 0, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }, 
       {
           "ref_date": "2015-07-14", 
           "ref_hour": 0, 
           "user_source": 4, 
           "int_page_read_user": 42, 
           "int_page_read_count": 100, 
           "ori_page_read_user": 0, 
           "ori_page_read_count": 0, 
           "share_user": 0, 
           "share_count": 0, 
           "add_to_fav_user": 0, 
           "add_to_fav_count": 0
       }
 	//后续还有ref_hour逐渐增大,以列举1天24小时的数据
   ]
}

正常情況下，取得圖文分享轉送數據介面的回傳JSON封包如下：

{ 
   "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
       }
	//后续还有不同share_scene（分享场景）的数据，以及ref_date在begin_date和end_date之间的数据
   ]
}

正常情況下，取得圖文分享轉送每日資料介面的回傳JSON封包如下：

{ 
   "list": [ 
       { 
           "ref_date": "2014-12-07", 
           "ref_hour": 1200, 
           "share_scene": 1, 
           "share_count": 72, 
           "share_user": 4
       }
	//后续还有不同share_scene的数据，以及ref_hour逐渐增大的数据。由于最大时间跨度为1，所以ref_date此处固定
   ]
}

傳回參數說明

錯誤時微信會回傳錯誤碼等信息，具體錯誤碼查詢，請見：全域回傳碼說明