C/2/friendships/followers/biz
Xuezheng (讨论 | 贡献)
(以“{{Api_desc_business| uri=friendships/followers/biz| desc=获取当前登录用户的粉丝列表。| httpMethod=GET| needAuth=是| rateLimit={{B_rate_limit}}| params...”为内容创建页面)
下一编辑→
(以“{{Api_desc_business| uri=friendships/followers/biz| desc=获取当前登录用户的粉丝列表。| httpMethod=GET| needAuth=是| rateLimit={{B_rate_limit}}| params...”为内容创建页面)
下一编辑→
2015年6月26日 (五) 23:06的版本
friendships/followers/biz
获取当前登录用户的粉丝列表。
URL
https://c.api.weibo.com/2/friendships/followers/biz.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
请求所有商业接口：
- 50000次/小时/IP；
- 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，默认为所有用户。 |
| flag | false | int | 指定粉丝的属性条件。0：所有粉丝；1：活跃粉丝；2：互动粉丝；支持任意数字叠加值，如，3：活跃粉丝+互动粉丝，默认为0。 |
| bucket | false | int | 筛选粉丝的个数范围，默认为50，最大不超过200。 |
| max_time | false | string | 返回结果的时间戳游标，若指定此参数，则返回关注时间小于或等于max_time的粉丝，默认从当前时间开始算。返回结果中会得到next_cursor字段，表示下一页的max_time。next_cursor为0表示已经到记录末尾。 |
| cursor_uid | false | int | 排重ID，传上次获取时最后一个用户ID。 |
| limit | false | int | 内部使用的参数，用于限制开发者获取最新粉丝的个数。若指定该参数值为N，表示只能获取最新N个粉丝，N个之前的粉丝无法获取；不指定，表示可以获取全量粉丝。 |
注意事项
- 只能获取当前登录用户的粉丝列表；
- 活跃粉丝是指近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."
}
关于错误返回值与错误代码，参见 错误代码说明
字段说明
无
其他
无
