C/2/friendships/followers/biz
第14行: | 第14行: | ||
{{api_args|max_time|false|string|返回结果的时间戳游标,若指定此参数,则返回关注时间小于或等于max_time的粉丝,默认从当前时间开始算。返回结果中会得到next_cursor字段,表示下一页的max_time。next_cursor为0表示已经到记录末尾。}} | {{api_args|max_time|false|string|返回结果的时间戳游标,若指定此参数,则返回关注时间小于或等于max_time的粉丝,默认从当前时间开始算。返回结果中会得到next_cursor字段,表示下一页的max_time。next_cursor为0表示已经到记录末尾。}} | ||
{{api_args|cursor_uid|false|int|排重ID,传上次获取时最后一个用户ID。}} | {{api_args|cursor_uid|false|int|排重ID,传上次获取时最后一个用户ID。}} | ||
− | <--{{api_args|limit|false|int|内部使用的参数,用于限制开发者获取最新粉丝的个数。若指定该参数值为N,表示只能获取最新N个粉丝,N个之前的粉丝无法获取;不指定,表示可以获取全量粉丝。}}|--> | + | <!--{{api_args|limit|false|int|内部使用的参数,用于限制开发者获取最新粉丝的个数。若指定该参数值为N,表示只能获取最新N个粉丝,N个之前的粉丝无法获取;不指定,表示可以获取全量粉丝。}}|--> |
result= | result= | ||
<pre> | <pre> |
2015年8月26日 (三) 11:26的版本
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。
result= //成功返回 { "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." } |
注意事项
- 只能获取当前登录用户的粉丝列表;
- 活跃粉丝是指近30天内有登录的粉丝;
- 互动粉丝是指近30天内有交互(评论、转发)的粉丝;
返回结果
JSON示例
{{{result}}}
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无