获取订阅者列表

跳转到: 导航, 搜索

获取订阅者列表

开发者可以通过本接口来获取订阅用户uid列表,一次拉取调用最多拉取10000个关注者的uid,可以通过多次拉取的方式来满足需求。

URL

https://m.api.weibo.com/2/messages/subscribers/get.json

HTTP请求方式

GET

是否需要登录


关于登录授权,参见 如何登录授权


接口请求参数

参数详情:

  必选 类型及范围 说明
access_token true string 在粉丝服务平台 - 高级功能 - 开发者模式页面中获取,或者OAuth2.0授权后获得, 详细参考 获取粉丝服务平台开发接口的access token
next_uid false int64 第一个拉取的uid,不填默认从头开始拉取。

注意事项

  • 1、当账号的订阅者数量超过10000时,可通过填写next_uid的值,从而多次拉取列表的方式来满足需求;

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

  • 2、如果一次拉去的用户数不到10000,则next_uid为"",空字符串;
  • 3、access_token中的uid已经开启开发模式;

返回结果

正常情况下,微博会返回下述JSON数据包:


{
    "total": 139,  //总订阅用户数
    "count": 2, //本次拉取的用户数,最大值为10000
    "data": {
        "uids": [
        1649670037,
        2731569005
        ]
    },
    "next_uid": "NEXT_UID" //拉取列表的后一个用户的UID
}

// 失败返回

{
    "request": "/2/messages/subscribers/ids.json",
    "error_code": 264XX,
    "error": "error message."
}