C/2/friendships/followers/biz

跳转到: 导航, 搜索

friendships/followers/biz

获取当前登录用户的粉丝列表。

URL

https://c.api.weibo.com/2/friendships/followers/biz.json

支持格式

JSON

HTTP请求方式

GET

是否需要登录


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

访问授权限制


请求所有商业接口:

    • 50000次/小时/IP;

请求参数

  必选 类型及范围 说明
source false string 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。
access_token false string 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。
gender false string 指定接收用户的性别范围,m:男、f:女。
province false int 指定接收用户的省份范围,省份ID。
city false int 指定接收用户的城市范围,城市ID。
age false string 指定接收用户的年龄范围,取值内容为:6-12、13-18、19-22、23-25、26-29、30-39、40-59、60-80、其他。
type false int 指定粉丝的认证类型。0:所有用户;1:普通用户;2:黄V;4:蓝v(包括政府,企业,媒体,网站,校园,应用,机构/团体,公益组织);8:达人;支持任意数字叠加值,如,6:黄V+蓝V,默认为所有用户。
bucket false int 筛选粉丝的个数范围,默认为50,最大不超过200。
max_time false string 返回结果的时间戳游标,若指定此参数,则返回关注时间小于或等于max_time的粉丝,默认从当前时间开始算。返回结果中会得到next_cursor字段,表示下一页的max_time。next_cursor为0表示已经到记录末尾。
cursor_uid false int 排重ID,传上次获取时最后一个用户ID。

注意事项

  • 只能获取当前登录用户的粉丝列表;
  • 活跃粉丝是指近30天内有登录的粉丝;
  • 互动粉丝是指近30天内有交互(评论、转发)的粉丝;

返回结果

JSON示例

//成功返回
{
    "users": [
        {
            "id": 321205008,
            "idstr": "321205008",
            "screen_name": "江湖社***",
            "name": "江湖社***,
            "province": "41",
            "city": "1",
            "location": "河南 郑州",
            "description": "描述。。。",
            "url": "http://www.weibo.com",
            "profile_image_url": "http://tp2.sinaimg.cn/321205008/50/5652109562/1",
            "profile_url": "523438876",
            "domain": "laijianghu",
            "weihao": "523438876",
            "gender": "m",
            "followers_count": 270,
            "friends_count": 364,
            "statuses_count": 23,
            "favourites_count": 0,
            "created_at": "Wed Jan 02 23:56:03 +0800 2013",
            "following": false,
            "allow_all_act_msg": true,
            "geo_enabled": true,
            "verified": false,
            "verified_type": -1,
            "remark": "",
            "status_id": 3532859991713507,
            "allow_all_comment": true,
            "avatar_large": "http://tp2.sinaimg.cn/3212050081/180/5652109562/1",
            "verified_reason": "",
            "follow_me": false,
            "online_status": 0,
            "bi_followers_count": 204,
            "lang": "zh-cn",
            "star": 0,
            "mbtype": 0,
            "mbrank": 0,
            "block_word": 0
        },
        ...
    ],
    "next_cursor": 1,
    "previous_cursor": 0,  
    "cursor_uid":2903271035,
    "total_number": 61550
}

//失败返回
{
    "request": "/friendships/followers/biz.json",
    "error_code": XXXXX,
    "error": "error message."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2018-09-20
api评价