2/friendships/followers/all/ids
第5行: | 第5行: | ||
needAuth=是| | needAuth=是| | ||
rateLimit={{B_rate_limit}}| | rateLimit={{B_rate_limit}}| | ||
− | params={{api_args| | + | params={{api_args|gender|false|string|指定接收用户的性别范围,m:男、f:女。}} |
− | {{api_args| | + | {{api_args|province|false|int|指定接收用户的省份范围,省份ID。}} |
+ | {{api_args|city|false|int|指定接收用户的城市范围,城市ID。}} | ||
+ | {{api_args|age|false|string|指定接收用户的年龄范围,取值内容为:6-12、13-18、19-22、23-25、26-29、30-39、40-59、60-80、其他。}} | ||
+ | {{api_args|type|false|int|指定粉丝的认证类型。0:所有用户;1:普通用户;2:黄V;4:蓝v(包括政府,企业,媒体,网站,校园,应用,机构/团体,公益组织);8:达人;支持任意数字叠加值,如,6:黄V+蓝V,默认为所有用户。}} | ||
+ | {{api_args|flag|false|int|指定粉丝的属性条件。0:所有粉丝;1:活跃粉丝;2:互动粉丝;支持任意数字叠加值,如,3:活跃粉丝+互动粉丝,默认为0。}} | ||
+ | {{api_args|bucket|false|int|筛选粉丝的个数范围,默认为1000,最大不超过10000。}} | ||
+ | {{api_args|max_time|false|string|返回结果的时间戳游标,若指定此参数,则返回关注时间小于或等于max_time的粉丝,默认从当前时间开始算。返回结果中会得到next_cursor字段,表示下一页的max_time。next_cursor为0表示已经到记录末尾。}} | ||
+ | {{api_args|cursor_uid|false|int|排重ID,传上次获取时最后一个用户ID。}}| | ||
result= | result= | ||
<pre> | <pre> | ||
{ | { | ||
"ids": [ | "ids": [ | ||
− | + | 2903271035, | |
− | + | 2813252435, | |
− | + | ... | |
], | ], | ||
− | "next_cursor": | + | "next_cursor": 1234567, // 下次max_time值 |
− | "previous_cursor": | + | "previous_cursor": 12345678, // 上次max_time值 |
− | "total_number": | + | "total_number": 14947058 |
} | } | ||
</pre>| | </pre>| | ||
resultDes=无| | resultDes=无| | ||
− | useAge=* | + | useAge=*活跃粉丝是指近30天内有登录的粉丝; |
+ | *互动粉丝是指近30天内有交互(评论、转发)的粉丝;| | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} |
2014年12月1日 (一) 16:00的版本
friendships/followers/all/ids
获取当前用户的全量粉丝ID列表(不受5000条限制) 。
URL
https://c.api.weibo.com/2/friendships/followers/all/ids.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 | 筛选粉丝的个数范围,默认为1000,最大不超过10000。 |
max_time | false | string | 返回结果的时间戳游标,若指定此参数,则返回关注时间小于或等于max_time的粉丝,默认从当前时间开始算。返回结果中会得到next_cursor字段,表示下一页的max_time。next_cursor为0表示已经到记录末尾。 |
cursor_uid | false | int | 排重ID,传上次获取时最后一个用户ID。 |
注意事项
- 活跃粉丝是指近30天内有登录的粉丝;
- 互动粉丝是指近30天内有交互(评论、转发)的粉丝;
返回结果
JSON示例
{ "ids": [ 2903271035, 2813252435, ... ], "next_cursor": 1234567, // 下次max_time值 "previous_cursor": 12345678, // 上次max_time值 "total_number": 14947058 }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无