This API is used to query the total number of users who connect to the Wi-Fi network, the number of users who connect to the Wi-Fi network via Weixin, the number of users who visit the merchant homepage, the number of users who receive the message of successful connection, the number of new followers of the Official Account, and the total number of followers of the Official Account within a specified time range (30 days at most).
API Request Format
Protocol: HTTPS
HTTP request method: POST
Request URL: https://api.weixin.qq.com/bizwifi/statistics/list?access_token=ACCESS_TOKEN
POST data format: JSON
Request Parameters
| Parameter | Required | Description |
|---|---|---|
| access_token | Yes | The credential for calling the API |
| POST data | Yes | JSON data |
POST Data
Example:
{
"begin_date": "2015-05-01",
"end_date": "2015-05-02",
"shop_id": -1
}
Fields:
| Field | Required | Description |
|---|---|---|
| begin_date | Yes | Start date, in yyyy-mm-dd format. The maximum time range is 30 days. |
| end_date | Yes | End date, in yyyy-mm-dd format. The maximum time range is 30 days. |
| shop_id | No | The store ID used for search. "-1" indicates overall statistical data. |
Response
The JSON data returned for a successful request:
{
"errcode": 0,
"data": [
{
"shop_id": "-1",
"statis_time": 1430409600000,
"total_user": 2,
"homepage_uv": 0,
"new_fans": 0,
"total_fans": 4,
"wxconnect_user": 8,
"connect_msg_user": 5
},
{
"shop_id": "-1",
"statis_time": 1430496000000,
"total_user": 2,
"homepage_uv": 0,
"new_fans": 0,
"total_fans": 4,
"wxconnect_user": 4,
"connect_msg_user": 3
}
]
}
Fields:
| Field | Description |
|---|---|
| shop_id | Store ID. "-1" indicates overall statistical data. |
| statis_time | Statistical time (in ms) |
| total_user | Total number of users who connect to the Wi-Fi network |
| homepage_uv | Number of users who visit the merchant homepage |
| new_fans | Number of new followers of the Official Account |
| total_fans | Total number of followers of the Official Account |
| wxconnect_user | Number of users who connect to the Wi-Fi network via Weixin |
| connect_msg_user | Number of users who receive the message of successful connection |