Data statistics interface-graphic and text analysis data interface

Xin public platform launched the invitation-based internal testing of the data interface on January 6, 2015. Through the data interface, developers can obtain data similar to the statistical module of the official website of the public platform but more flexible, and can also perform advanced processing as needed.

During the invitation beta test, in order to ensure service quality, the data interface is only open to third-party platform developers. You can become a third-party platform developer by accessing the WeChat Open Platform and authorizing the public account login. The third-party platform can help operators manage public accounts and help authorized public accounts call data interfaces. In the permission set division of the public account login authorization mechanism, the graphic analysis data interface belongs to the business notification permission set.

The time for opening the data interface to all public account developers will be notified separately.

Please note:

1. The database of the public account data on the interface side only stores data after December 1, 2014. Data before that date cannot be queried. Even if data is found, it is unreliable and dirty data.
2. After calling the interface to obtain data, developers should save the data in their own database, which will speed up the next user's access and reduce unnecessary losses in calling the interface on the WeChat side.

The graphic analysis data interface refers to the interface used to obtain the graphic analysis data in the data statistics module of the official website of the public platform. The specific interface list is as follows:

***Time span refers to the time range in which data can be obtained when an API is called. For example, ***Time span of 7 means that a maximum of 7 days of data can be obtained at one time. The actual value of access_token can be obtained through "Get access_token".
Interface call request description

The graphic analysis data interface (including all interfaces in the interface list) needs to POST the following sample data packet to the corresponding interface call address:

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

Return Description

Under normal circumstances, the returned JSON data packet of the interface for obtaining the daily data of group text and picture messages is as follows:

 {
 "list": [
 {
 "ref_date": "2014-12-08",
 "msgid": "10000050_1",
 "title": "December 27 DiLi Daily",
 "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
 }
 //The following will list all articles that have been read on that date (including only mass-sent articles) and the number of times they were read on that day.
 ]
 }

Under normal circumstances, the JSON data packet returned by the interface for obtaining the total data of group text and pictures is as follows (please note that in details, the corresponding value for each day is the total amount of the article up to that day (not the amount of the day)). In addition, it is necessary to pay attention to the difference between obtaining the daily data of group text and pictures (getarticlesummary) and obtaining the total data of group text and pictures (getarticletotal) as follows:

1. The former obtains data such as the number of times all articles that have been read on a certain day (including only mass-sent articles) were read on that day.
2. The latter obtains the total data of articles sent in batches on a certain day, from the date of mass sending to the date of interface call (but data is counted for up to 7 days after the date of publication). For example, if an article is sent on December 1st, and the number of readings on the 1st, 2nd, and 3rd after it is sent is 10,000 respectively, then the data obtained by getarticletotal is that the total readings from the time of sending to 24:00 on December 1st are 10,000, the total readings from the time of sending to 24:00 on December 2nd are 20,000, and the total readings from the time of sending to 24:00 on December 1st are 30,000.

 {
 "list": [
 {
 "ref_date": "2014-12-14",
 "msgid": "202457380_1",
 "title": "The Lost Painting on Malaysia Airlines",
 "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
 },
 //All data whose stat_date matches "ref_date (mass mail date) to interface call date" (but only 7 days at most) will be listed later
 ]
 },
 //There will be data for group-sent articles whose ref_date (group-sent date) is between begin_date and end_date in the future
 ]
 } 
 
 Under normal circumstances, the returned JSON data packet of the interface for obtaining graphic and text statistical data is as follows: 
 
 {
 "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
 },
 //There will be data with ref_date between begin_date and end_date later
 ]
 }

Under normal circumstances, the returned JSON data packet of the interface for obtaining graphic and text statistics time-sharing data is as follows:

 {
 "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
 }
 //Subsequently, ref_hour will gradually increase to list the data for 24 hours a day
 ]
 } 
 
 Under normal circumstances, the returned JSON data packet of the interface for obtaining the picture and text sharing and forwarding data is as follows: 
 
 {
 "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
 }
 //There will be data of different share_scene (sharing scenes) and data with ref_date between begin_date and end_date in the future
 ]
 }

Under normal circumstances, the returned JSON data packet of the interface for obtaining the daily data of picture and text sharing and forwarding is as follows:

 {
 "list": [
 {
 "ref_date": "2014-12-07",
 "ref_hour": 1200,
 "share_scene": 1,
 "share_count": 72,
 "share_user": 4
 }
 //There will be data of different share_scenes and data of increasing ref_hour later. Since the maximum time span is 1, ref_date is fixed here.
 ]
 }