数据统计接口-图文分析数据接口

信公众平台于2015年1月6日启动了数据接口的邀请内测。通过数据接口，开发者可以获取与公众平台官网统计模块类似但更灵活的数据，还可根据需要进行高级处理。

邀请内测期间，为保证服务质量，数据接口仅向第三方平台开发者开放。在微信开放平台接入公众号登录授权即可成为第三方平台开发者，第三方平台可帮助运营者管理公众号，帮助已授权公众号调用数据接口。在公众号登录授权机制的权限集划分中，图文分析数据接口属于业务通知权限集。

向所有公众号开发者开放数据接口的时间将另行通知。

请注意：

1、接口侧的公众号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2、请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。

图文分析数据接口指的是用于获得公众平台官网数据统计模块中图文分析数据的接口，具体接口列表如下：

***时间跨度是指一次接口调用时***可获取数据的时间范围，如***时间跨度为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 
}, 
//后续还会列出所有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": "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 
} 
//后续还有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此处固定 
] 
}