獲取微信公眾號用戶列表

2018-07-27 10:08 更新

獲取用戶列表

微信獲取用戶列表

公眾號可通過本接口來獲取帳號的關(guān)注者列表,關(guān)注者列表由一串OpenID(加密后的微信號,每個用戶對每個公眾號的OpenID是唯一的)組成。一次拉取調(diào)用最多拉取10000個關(guān)注者的OpenID,可以通過多次拉取的方式來滿足需求。

接口調(diào)用請求說明

http請求方式: GET(請使用https協(xié)議)

https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

參數(shù)是否必須說明
access_token調(diào)用接口憑證
next_openid第一個拉取的OPENID,不填默認從頭開始拉取

返回說明

正確時返回JSON數(shù)據(jù)包:

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}
參數(shù)說明
total關(guān)注該公眾賬號的總用戶數(shù)
count拉取的OPENID個數(shù),最大值為10000
data列表數(shù)據(jù),OPENID的列表
next_openid拉取列表的最后一個用戶的OPENID


錯誤時返回JSON數(shù)據(jù)包(示例為無效AppID錯誤):

{"errcode":40013,"errmsg":"invalid appid"}

附:關(guān)注者數(shù)量超過10000時

當公眾號關(guān)注者數(shù)量超過10000時,可通過填寫next_openid的值,從而多次拉取列表的方式來滿足需求。

具體而言,就是在調(diào)用接口時,將上一次調(diào)用得到的返回中的next_openid值,作為下一次調(diào)用中的next_openid值。

示例如下:

公眾賬號A擁有23000個關(guān)注的人,想通過拉取關(guān)注接口獲取所有關(guān)注的人,那么分別請求url如下:https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 返回結(jié)果:
{
 "total":23000,
 "count":10000,
 "data":{"
    openid":[
       "OPENID1",
       "OPENID2",
       ...,
       "OPENID10000"
    ]
  },
  "next_openid":"OPENID10000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1返回結(jié)果:
{
  "total":23000,
  "count":10000,
  "data":{
    "openid":[
      "OPENID10001",
      "OPENID10002",
      ...,
      "OPENID20000"
    ]
  },
  "next_openid":"OPENID20000"
}https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2返回結(jié)果(關(guān)注者列表已返回完時,返回next_openid為空):
{
  "total":23000,
  "count":3000,
  "data":{"
      "openid":[
        "OPENID20001",
        "OPENID20002",
        ...,
        "OPENID23000"
      ]
  },
  "next_openid":"OPENID23000"
}



以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號