首页 > 建站资源 > 微信营销 > 微信公众平台获取关注者列表之开发文档详解

微信公众平台获取关注者列表之开发文档详解

时间:2014-02-09    来源:互联网

微信公众号可通过本接口来获取帐号的关注者列表,关注者列表由一串OpenID(加密后的微信号,每个用户对每个公众号的OpenID是唯一的)组成。一次拉取调用最多拉取10000个关注者的OpenID,可以通过多次拉取的方式来满足需求。

接口调用请求说明

http请求方式: GET(请使用https协议)
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID
参数 是否必须 说明
access_token 调用接口凭证
next_openid 第一个拉取的OPENID,不填默认从头开始拉取

返回说明

正确时返回JSON数据包:

{"total":2,"count":2,"data":{"openid":["","OPENID1","OPENID2"]},"next_openid":"NEXT_OPENID"}
参数 说明
total 关注该公众账号的总用户数
count 拉取的OPENID个数,最大值为10000
data 列表数据,OPENID的列表
next_openid 拉取列表的后一个用户的OPENID

错误时返回JSON数据包(示例为无效AppID错误):

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

附:关注者数量超过10000时

当公众号关注者数量超过10000时,可通过填写next_openid的值,从而多次拉取列表的方式来满足需求。

具体而言,就是在调用接口时,将上一次调用得到的返回中的next_openid值,作为下一次调用中的next_openid值。

示例如下:

公众账号A拥有23000个关注的人,想通过拉取关注接口获取所有关注的人,那么分别请求url如下:
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN 
返回结果:
{
  "total":23000,
  "count":10000,
  "data":{"
     openid":[
        "OPENID1",
        "OPENID2",
        ...,
        "OPENID10000"
     ]
   },
   "next_openid":"NEXT_OPENID1"
}
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID1
返回结果:
{
   "total":23000,
   "count":10000,
   "data":{
     "openid":[
       "OPENID10001",
       "OPENID10002",
       ...,
       "OPENID20000"
     ]
   },
   "next_openid":"NEXT_OPENID2"
}
https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID2
返回结果(关注者列表已返回完时,返回next_openid为空):
{
   "total":23000,
   "count":3000,
   "data":{"
       "openid":[
         "OPENID20001",
         "OPENID20002",
         ...,
         "OPENID23000"
       ]
   },
   "next_openid":" "
}

使用网页调试工具调试该接口

相关推荐
微信公众平台用户分组管理开发文档详解
微信公众平台获取用户基本信息之开发文档详解
微信公众平台获取用户地理位置之开发文档详解
微信公众平台生成带参数的二维码之开发文档详解
微信公众平台客服接口之开发文档详解
微信公众平台上传下载多媒体文件之开发文档详解
微信公众平台教程:没有正确响应Token验证的解决方法
微信公众平台消息接口开发教程之语音触发应用
微信公众平台接口开发教程之人脸识别应用
微信公众平台消息接口开发之小黄鸡机器人应用
微信公众号自定义菜单申请与使用问题解答
拆解微信公众平台接口:CRM六大模块真容
微信公众平台自定义菜单开发文档详解
iWork365:微信第三方如何打造移动协作平台
微信开发教程:用户账号绑定到微信公众号的方法分享
微信小程序开发:微信放出公众平台小程序文档和工具
微信公众平台注册与认证图文教程分享
微信公众平台消息管理与群发图文教程
微信公众平台素材编辑与自动回复图文教程
微信公众平台开发模式详解图文教程
微信公众平台公众会议帐号使用详解
10条微信公众平台运营建议分享
微信公众平台消息接口开发教程 附PHP源码
微信公众平台运营十大要诀分享
微信公众平台编辑模式与开发模式详解
36条微信公众平台运营经验分享
商家微信公众号到底能做什么?
初识微信公众平台的在线支付功能
成功运营微信公众账号的四大要点
微信5.0上线 自定义菜单申请将重新开启

精彩推荐

热门教程