讲师中心微信公众号

首页

文章

后端开发 web前端数据库开发工具 php框架常见问题科技 Java 系统教程电脑教程硬件教程手机教程软件教程游戏教程自媒体新闻

专题

后端开发 web前端数据库开发工具 php框架科技 Java 系统教程电脑教程硬件教程手机教程软件教程游戏教程新闻

AI工具

AI 聊天问答 Agent智能体 AI 文本写作 AI 绘画作图 AI 设计工具 AI 视频创作 AI 音频制作 AI 办公学习 AI 编程开发 Prompt指令

学习

大前端后端开发数据库移动端运维开发计算机基础

编程手册

大前端后端开发数据库移动端运维开发计算机基础

下载

js特效网站源码工具下载类库下载网站素材学习资源插件扩展手机游戏

最近更新

手册

目录

微信公众平台开发概述

微信公众平台开发概述微信开发者规范微信公众号接口权限说明微信公众号接口调用频次限制说明

开始开发

微信开发者平台接入指南微信公众平台接口域名说明微信公众平台获取access_token 获取微信服务器IP地址报警排查指引接口测试号申请

微信自定义开发

自定义菜单创建接口自定义菜单查询接口自定义菜单删除接口自定义菜单事件推送个性化菜单接口获取自定义菜单配置接口

消息管理

接收普通消息接收事件推送被动回复用户消息消息加解密说明客服消息高级群发接口模板消息接口模板消息运营规范获取公众号的自动回复规则

微信网页开发

微信网页授权微信网页开发样式库微信JS-SDK说明文档微信web开发者工具

素材管理

新增临时素材获取临时素材新增永久素材删除永久素材修改永久图文素材获取素材总数获取素材列表

用户管理

用户标签管理设置用户备注名获取用户基本信息(UnionID机制) 获取用户列表获取用户地理位置黑名单管理

账号管理

生成带参数的二维码长链接转短链接接口微信认证事件推送

数据统计

用户分析数据接口图文分析数据接口消息分析数据接口接口分析数据接口

微信卡券接口说明

微信卡券接口创建卡券投放卡券核销卡券管理卡券卡券事件推送会员卡专区（一）会员卡专区（二）朋友的券专区特殊票券第三方开发者模式卡券错误码

微信门店

微信门店接口

微信小店

微信小店接口语义理解接口

微信设备功能

微信服务号设备功能介绍如何新增产品型号

新版客服功能

将消息转发到微信客服微信客服管理微信会话控制微信获取聊天记录

微信摇一摇周边

申请开通微信摇一摇微信设备ID 微信摇一摇页面管理微信摇一摇上传图片素材管理设备与页面的关联关系微信摇一摇数据统计摇一摇关注的JSAPI 摇一摇事件通知 html5页面获取设备信息微信摇一摇获取设备及用户信息摇一摇红包介绍说明摇一摇周边错误码

微信连WIFI

微信连Wi-Fi开发者指引 Wi-Fi硬件鉴权协议接口说明 Wi-Fi软件服务管理接口说明开通微信连Wi-Fi插件 Wi-Fi门店管理 Wi-Fi设备管理配置微信WiFi联网方式微信商家主页管理 Wi-Fi数据统计连网后下发消息微信卡券投放微信Wi-Fi接口返回错误码微信连网过程常见错误码

微信扫一扫

微信扫一扫接入指南微信上进行商品创建微信商品发布微信商品管理扫一扫事件推送一物一码专区扫一扫错误码在线帮助工具

首页后端开发 PHP 微信公众平台开发者文档

获取用户列表

收藏989

阅读41837

更新时间2022-04-11

获取用户基本信息(UnionID机制)

获取用户地理位置

获取用户列表

公众号可通过本接口来获取帐号的关注者列表，关注者列表由一串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":"OPENID10000"
}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":"OPENID20000"
}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":"OPENID23000"
}

获取用户基本信息(UnionID机制)

获取用户地理位置

相关

视频

RELATED VIDEOS

更多

科技资讯

更多

更多

精选课程

更多

PHP实战天龙八部之微信支付视频教程

PHP实战天龙八部之微信支付视频教程

共5课时

17.3万人学习

PHP实战天龙八部之仿爱奇艺电影网站

PHP实战天龙八部之仿爱奇艺电影网站

共49课时

77.4万人学习

前端入门_HTML5

前端入门_HTML5

共29课时

62万人学习

CSS视频教程-玉女心经版

CSS视频教程-玉女心经版

共25课时

39.5万人学习

JavaScript极速入门_玉女心经系列

JavaScript极速入门_玉女心经系列

共43课时

71.3万人学习

独孤九贱(1)_HTML5视频教程

独孤九贱(1)_HTML5视频教程

共25课时

61.9万人学习

独孤九贱(2)_CSS视频教程

独孤九贱(2)_CSS视频教程

共22课时

23.1万人学习

独孤九贱(3)_JavaScript视频教程

独孤九贱(3)_JavaScript视频教程

共28课时

34.1万人学习

独孤九贱(4)_PHP视频教程

独孤九贱(4)_PHP视频教程

共89课时

125.8万人学习

热门下载

更多

phpStudy 2018最新版

phpStudy 2018最新版

下载

vc9-vc14（32+64位）运行库合集（链接在下方）

vc9-vc14（32+64位）运行库合集（链接在下方）

下载

VC9 32位

VC9 32位

下载

VC11 32位

VC11 32位

下载

php程序员工具箱完整版

php程序员工具箱完整版

下载

VC14 32位

VC14 32位

下载

SublimeText3汉化版

SublimeText3汉化版

下载

Notepad++7.3.1

Notepad++7.3.1

下载

phpStudy V8.1（Win64位）（已支持php8）

phpStudy V8.1（Win64位）（已支持php8）

下载

关于我们免责申明举报中心意见反馈讲师合作广告合作最新更新: php中文网：公益在线php培训，帮助PHP学习者快速成长！; 关注服务号技术交流群

PHP中文网订阅号: 每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号