获取关注者列表

跳转到: 导航, 搜索

获取订阅者列表

公众号可通过本接口来获取帐号的关注者列表,关注者列表由一串uid组成。一次拉取调用最多拉取10000个关注者的OpenID,可以通过多次拉取的方式来满足需求。


开发者可通过uid来获取用户基本信息。


URL

https://api.weibo.com/2/messages/subscribers/ids.json


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."
}



文档更新时间: 2014-05-04