獲取微信公眾號(hào)用戶列表

2018-07-27 10:08 更新

獲取用戶列表

微信獲取用戶列表

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

接口調(diào)用請(qǐng)求說(shuō)明

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

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

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

返回說(shuō)明

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

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


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

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

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

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

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

示例如下:

公眾賬號(hào)A擁有23000個(gè)關(guān)注的人,想通過(guò)拉取關(guān)注接口獲取所有關(guān)注的人,那么分別請(qǐng)求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)注者列表已返回完時(shí),返回next_openid為空):
{
  "total":23000,
  "count":3000,
  "data":{"
      "openid":[
        "OPENID20001",
        "OPENID20002",
        ...,
        "OPENID23000"
      ]
  },
  "next_openid":"OPENID23000"
}



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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)