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