获取订阅者列表
公众号可通过本接口来获取帐号的关注者列表,关注者列表由一串uid组成。一次拉取调用最多拉取10000个关注者的OpenID,可以通过多次拉取的方式来满足需求。
开发者可通过uid来获取用户基本信息。
URL
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
接口请求参数
参数详情:
必选
类型及范围
说明
access_token
true
string
在粉丝服务平台 - 高级功能 - 开发者模式页面中获取,或者OAuth2.0授权后获得, 详细参考 获取粉丝服务平台开发接口的access token。
uid
true
int64
需要查询的用户uid。
注意事项
1、只能获取粉丝信息;
返回结果
正常情况下,微博会返回下述JSON数据包:
{
"subscribe": 1,
"uid": "123123123",
"nickname": "punk",
"sex": 1,
"language": "zh_CN",
"city": "广州",
"province": "广东",
"country": "中国",
"headimgurl": "xxx",
"follow": "1",
"subscribe_time": 1382694957
}
参数说明:
返回值字段
字段类型
字段说明
uid
int64
用户UID
nicname
string
用户昵称
sex
string
性别,1:男、2:女、0:未知
city
int
用户所在城市ID
country?
province
int
用户所在省级ID
location
string
用户所在地
language
string
用户当前的语言版本,zh-cn:简体中文,zh-tw:繁体中文,en:英语
headimgurl
string
用户头像地址(中图),50×50像素
name
string
友好显示名称
subscribe
boolean
是否订阅
follow_me
boolean
该用户是否关注当前登录用户,true:是,false:否
subscribe_time
string
订阅时间
// 失败返回
{
"request": "/2/eps/user/info.json",
"error_code": 284XX,
"error": "error message."
}