# Get the total data for a graph and text group
Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide
Interface English name: getarticletotal
Get statistics on the total number of group posts from the group posting date
# 1. How to call
# HTTPS calls
POST https://api.weixin.qq.com/datacube/getarticletotal?access_token=ACCESS_TOKEN
# Cloud Calls
Call method: officialAccount.datacube.getArticleTotal
The input and exit parameters are the same as the HTTPS call, which can be called in the cloud call documentation
# Third party invocation
This interface supports Third Party Platform generation business call.
The permission set id to which the interface belongs is: 7
When a service provider is authorized by one of the permissions set, it can call on behalf of the merchant by using authorizer_access_token , which can be viewed in the third-party call documentation.
# 2. Request parameters
# Query parametersQuery String parameters
Parameter Name | type | Required to fill in | Example | Introductions |
---|---|---|---|---|
access_token | string | yes | ACCESS_TOKEN | Interface invocation credentials, using access_token , authorizer_access_token |
# Request BodyRequest Payload
Parameter Name | type | Required to fill in | Example | Introductions |
---|---|---|---|---|
begin_date | string | yes | 2023-01-01 | Start date (YYYY-MM-DD) |
end_date | string | yes | 2023-01-01 | End Date (maximum value is yesterday) |
# 3. Return Parameters
# Response Payload
Parameter Name | type | Introductions |
---|---|---|
list | objarray | List of data |
# Res.list(Array)Object Payload
List of data
Parameter Name | type | Introductions |
---|---|---|
stat_date | string | In the getarticletotal interface, ref_date refers to the date of the article group, and stat_date refers to the date of the numeric count |
target_user | number | The number of deliveries is generally equal to the total number of followers (you need to exclude those who are blacklisted or otherwise unable to receive messages) |
int_page_read_user | number | Number of people who read the Graphic page (the page where you clicked on the group graphic card to get to) |
int_page_read_count | number | Number of Views on the Graphic Page |
ori_page_read_user | number | Number of people who read the original page (the page entered by clicking on the text page to read the original). The figure here is 0 when there is no original page |
ori_page_read_count | number | Number of views of the original page |
share_user | number | Number of people shared |
share_count | number | Number of times shared |
add_to_fav_user | number | Number of people in the collection |
add_to_fav_count | number | Number of collections |
int_page_from_session_read_user | number | Official Account Number of session readers |
int_page_from_session_read_count | number | Official Account Session Readings |
int_page_from_hist_msg_read_user | number | Number of people who read the historical message page |
int_page_from_hist_msg_read_count | number | History of Message Page Reads |
int_page_from_feed_read_user | number | The number of readers on WeChat Moments |
int_page_from_feed_read_count | number | The number of reads on WeChat Moments; |
int_page_from_friends_read_user | number | Number of People Retweeted by their Friends |
int_page_from_friends_read_count | number | How many times a friend retweeted the reading |
int_page_from_other_read_user | number | Number of people reading in other scenes |
int_page_from_other_read_count | number | Other Scenarios Read How Many Times |
feed_share_from_session_user | number | Official Account Conversations shared to WeChat Moments |
feed_share_from_session_cnt | number | Official Account Conversations shared to WeChat Moments |
feed_share_from_feed_user | number | The number of people who have shared Moments on WeChat |
feed_share_from_feed_cnt | number | The number of times WeChat Moments posts are shared on WeChat |
feed_share_from_other_user | number | The number of people who shared the other scenes in WeChat Moments |
feed_share_from_other_cnt | number | The number of times other scenes were shared on WeChat Moments |
int_page_from_kanyikan_read_user | number | Look at the number of people who read in the source |
int_page_from_kanyikan_read_count | number | Look at the source Read more |
int_page_from_souyisou_read_user | number | Find out the number of people who read from the source |
int_page_from_souyisou_read_count | number | Search the source and read more |
# 4. Note
In details, the value for each day is the total amount of the article up to that day (not the amount for that day)
The difference between getarticlesummary and getarticletotal is as follows:
- The former gets data such as how many times all the articles that have been read on a given day (including group posts only) have been read that day.
- The latter obtains the total amount of data from a grouped article on a given day, from the grouped day to the interface call day (but counting data for up to seven days after the publication day). For example, an article was sent on December 1st and sent on the 1st day, The number of readings on the 2nd and 3rd days was 10,000, and the data obtained by getarticletotal was 10,000 from the 24th hour of December 1, 20,000 from the 24h hour of December 2, and 30,000 from the 24 hours of December 3.
# 5. Code examples
Example Requests
{
"begin_date": "2014-12-08",
"end_date": "2014-12-08"
}
Return an example
{
"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之间的群发文章的数据
]
}
# 6. Error code
The following is a list of error codes for this interface, other error codes can refer to General error codes
Error code | Error Description | Solutions |
---|---|---|
-1 | system error | The system is busy, so the developer is asked to try again in a few minutes. |
40001 | invalid credential access_token isinvalid or not latest | AppSecret error while getting access_token, or access_token is invalid.Developers should check that AppSecret is correct, or that they are calling interfaces for the appropriate Official Account |
# 7. Scope of application
Official Account | Service Account |
---|---|
Certification only | Certification only |
- Authentication only: means that only authenticated accounts are allowed to be invoked by the enterprise entity, and accounts that are not authenticated or do not support authentication cannot be invoked.
- Other account types that are not expressly stated may not be called on this interface without special instructions;