# 数据统计接口介绍

向所有认证服务号开发者开放数据接口。通过数据接口，开发者可以获取与公众平台官网统计模块类似但更灵活的数据，还可根据需要进行高级处理。使用数据接口过程中有任何问题，可以前往微信开放社区 [微信开放社区](https://developers.weixin.qq.com/community/minihome/mixflow/1277775808983138305) 专区发帖交流。

在服务号登录授权机制的权限划分逻辑如下：

1.用户分析数据接口属于用户管理权限
2.图文分析数据接口属于群发与通知权限
3.消息分析数据接口属于消息管理权限

## 使用说明

### 1. 通用注意事项

1. 接口侧的服务号数据的数据库中仅存储了2014年12月1日之后的数据，将查询不到在此之前的日期，即使有查到，也是不可信的脏数据；
2. 请开发者在调用接口获取数据后，将数据保存在自身数据库中，即加快下次用户的访问速度，也降低了微信侧接口调用的不必要损耗。
3. 为确保服务号数据已完成统计和处理，请于每天上午8点后查询服务号前一天的数据。

### 2. 用户分析的注意事项

1. 2020年4月起，新增关注渠道增加'他人转载'，之前合并在“其他合计”中。
2. 2020年6月起，新增关注渠道增加'微信广告'、'专辑内账号名称'，之前合并在“其他合计”中。
3. 2023年6月起，支付后关注合并在“其他合计”中。

### 3. 图文分析的注意事项

1. 额外注意，获取图文群发每日数据接口的结果中，只有中间页阅读人数+原文页阅读人数+分享转发人数+分享转发次数+收藏次数 >=3的结果才会得到统计，过小的阅读量的图文消息无法统计。
2. 2020年2月28日起，获取图文统计数据（getuserread）、图文统计分时数据（getuserreadhour）数据接口的结果中，中间页阅读、分享统一提供user_source字段，用于区分与数据，详见参数说明；额外注意，原文页阅读、收藏，只在图文统计数据（getuserread）中提供，并只提供数据。

### 3. 广告分析的使用指南

- 详情可查看[广告数据分析接口说明](ad/Ad_Analysis)

## 接口列表

### 用户数据

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [获取用户增减数据](/doc/service/api/wedata/user/api_getusersummary.md) | /datacube/getusersummary | 本接口用于获取用户增减数据分析数据 |
| [获取累计用户数据](/doc/service/api/wedata/user/api_getusercumulate.md) | /datacube/getusercumulate | 本接口用于获取用户累计数据分析数据 |

### 图文数据

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [获取图文群发每日数据](/doc/service/api/wedata/news/api_getarticlesummary.md) | /datacube/getarticlesummary | 本接口用于获取某天所有被阅读过的群发文章当天的阅读数据 |
| [获取图文阅读分时数据](/doc/service/api/wedata/news/api_getuserreadhour.md) | /datacube/getuserreadhour | 本接口用于获取图文阅读分时数据 |
| [获取图文转发分时数据](/doc/service/api/wedata/news/api_getusersharehour.md) | /datacube/getusersharehour | 本接口用于获取图文转发分时数据 |
| [获取图文阅读概况数据](/doc/service/api/wedata/news/api_getuserread.md) | /datacube/getuserread | 本接口用于获取图文阅读概括数据 |
| [获取图文群发总数据](/doc/service/api/wedata/news/api_getarticletotal.md) | /datacube/getarticletotal | 获取群发文章从群发日起的总量统计数据 |
| [获取图文转发概况数据](/doc/service/api/wedata/news/api_getusershare.md) | /datacube/getusershare | 本接口用于获取图文转发概况数据 |
| [获取发表内容每日阅读数据](/doc/service/api/wedata/news/api_getarticleread.md) | /datacube/getarticleread | 本接口用于获取某天所有被阅读过的发表内容的阅读指标 |
| [获取发表内容每日分享数据](/doc/service/api/wedata/news/api_getarticleshare.md) | /datacube/getarticleshare | 本接口用于获取某天所有被分享过的发表内容的分享指标 |
| [获取发表内容概况总数据](/doc/service/api/wedata/news/api_getbizsummary.md) | /datacube/getbizsummary | 本接口用于获取圈选日期内，该账号下发表内容汇总的概览数据 |
| [获取发表内容发表详细数据](/doc/service/api/wedata/news/api_getarticletotaldetail.md) | /datacube/getarticletotaldetail | 本接口用于获取 圈选日期内 所有发表内容的详细数据 |

### 消息数据

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [获取消息发送概况数据](/doc/service/api/wedata/mess/api_getupstreammsg.md) | /datacube/getupstreammsg | 本接口用于获取消息发送概况数据 |
| [获取消息发送月数据](/doc/service/api/wedata/mess/api_getupstreammsgmonth.md) | /datacube/getupstreammsgmonth | 本接口用于获取消息发送月数据 |
| [获取消息发送分布周数据](/doc/service/api/wedata/mess/api_getupstreammsgdistweek.md) | /datacube/getupstreammsgdistweek | 本接口用于获取消息发送分布周数据 |
| [获取消息发送分布月数据](/doc/service/api/wedata/mess/api_getupstreammsgdistmonth.md) | /datacube/getupstreammsgdistmonth | 本接口用于获取消息发送分布月数据 |
| [获取消息发送分时数据](/doc/service/api/wedata/mess/api_getupstreammsghour.md) | /datacube/getupstreammsghour | 本接口用于获取消息发送分时统计数据 |
| [获取消息发送周数据](/doc/service/api/wedata/mess/api_getupstreammsgweek.md) | /datacube/getupstreammsgweek | 本接口用于获取消息发送周数据 |
| [获取消息发送分布数据](/doc/service/api/wedata/mess/api_getupstreammsgdist.md) | /datacube/getupstreammsgdist | 本接口用于获取消息发送分布数据 |

### 接口数据

| 接口名称 | 请求路径 | 描述 |
| --- | --- | --- |
| [获取被动回复概要数据](/doc/service/api/wedata/api/api_getinterfacesummary.md) | /datacube/getinterfacesummary | 本接口用于获取被动回复概要数据 |
| [获取被动回复分布数据](/doc/service/api/wedata/api/api_getinterfacesummaryhour.md) | /datacube/getinterfacesummaryhour | 本接口用于获取被动回复分布数据 |