# Get the total data for a graph and text group

Debugging Tools

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 NametypeRequired to fill inExampleIntroductions
access_tokenstringyesACCESS_TOKENInterface invocation credentials, using access_token , authorizer_access_token

# Request BodyRequest Payload

Parameter NametypeRequired to fill inExampleIntroductions
begin_datestringyes2023-01-01Start date (YYYY-MM-DD)
end_datestringyes2023-01-01End Date (maximum value is yesterday)

# 3. Return Parameters

# Response Payload

Parameter NametypeIntroductions
listobjarrayList of data

# Res.list(Array)Object Payload

List of data

Parameter NametypeIntroductions
stat_datestringIn 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_usernumberThe 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_usernumberNumber of people who read the Graphic page (the page where you clicked on the group graphic card to get to)
int_page_read_countnumberNumber of Views on the Graphic Page
ori_page_read_usernumberNumber 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_countnumberNumber of views of the original page
share_usernumberNumber of people shared
share_countnumberNumber of times shared
add_to_fav_usernumberNumber of people in the collection
add_to_fav_countnumberNumber of collections
int_page_from_session_read_usernumberOfficial Account Number of session readers
int_page_from_session_read_countnumberOfficial Account Session Readings
int_page_from_hist_msg_read_usernumberNumber of people who read the historical message page
int_page_from_hist_msg_read_countnumberHistory of Message Page Reads
int_page_from_feed_read_usernumberThe number of readers on WeChat Moments
int_page_from_feed_read_countnumberThe number of reads on WeChat Moments;
int_page_from_friends_read_usernumberNumber of People Retweeted by their Friends
int_page_from_friends_read_countnumberHow many times a friend retweeted the reading
int_page_from_other_read_usernumberNumber of people reading in other scenes
int_page_from_other_read_countnumberOther Scenarios Read How Many Times
feed_share_from_session_usernumberOfficial Account Conversations shared to WeChat Moments
feed_share_from_session_cntnumberOfficial Account Conversations shared to WeChat Moments
feed_share_from_feed_usernumberThe number of people who have shared Moments on WeChat
feed_share_from_feed_cntnumberThe number of times WeChat Moments posts are shared on WeChat
feed_share_from_other_usernumberThe number of people who shared the other scenes in WeChat Moments
feed_share_from_other_cntnumberThe number of times other scenes were shared on WeChat Moments
int_page_from_kanyikan_read_user numberLook at the number of people who read in the source
int_page_from_kanyikan_read_countnumberLook at the source Read more
int_page_from_souyisou_read_usernumberFind out the number of people who read from the source
int_page_from_souyisou_read_countnumberSearch 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:

  1. 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.
  2. 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 codeError DescriptionSolutions
-1system errorThe system is busy, so the developer is asked to try again in a few minutes.
40001invalid credential  access_token isinvalid or not latestAppSecret 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

How this interface can be invoked under different account types:
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;