第9行: | 第9行: | ||
{{api_args|uid|false|int64|需要查询的用户UID。}} | {{api_args|uid|false|int64|需要查询的用户UID。}} | ||
{{api_args|screen_name|false|string|需要查询的用户昵称。}} | {{api_args|screen_name|false|string|需要查询的用户昵称。}} | ||
− | {{api_args|count|false|int| | + | {{api_args|count|false|int|单页返回的记录条数,默认为5,最大不超过5。}} |
{{api_args|cursor|false|int|返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。}} | {{api_args|cursor|false|int|返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。}} | ||
{{arg_trim_status}}| | {{arg_trim_status}}| | ||
第69行: | 第69行: | ||
*<font style="color:red">接口升级后:uid与screen_name只能为当前授权用户;</font> | *<font style="color:red">接口升级后:uid与screen_name只能为当前授权用户;</font> | ||
*只返回同样授权本应用的用户,非授权用户将不返回; | *只返回同样授权本应用的用户,非授权用户将不返回; | ||
− | * | + | *例如一次调用count是5,但其中授权本应用的用户只有1条,则实际只返回1条; |
− | + | ||
| | | | ||
otherInfo=无 | otherInfo=无 | ||
}}{{#a:showgrade}} | }}{{#a:showgrade}} |
2017年4月27日 (四) 17:26的最后版本
friendships/followers
获取用户的粉丝列表
URL
https://api.weibo.com/2/friendships/followers.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
访问级别:普通接口
频次限制:是
关于频次限制,参见 接口访问权限说明
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | true | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
uid | false | int64 | 需要查询的用户UID。 |
screen_name | false | string | 需要查询的用户昵称。 |
count | false | int | 单页返回的记录条数,默认为5,最大不超过5。 |
cursor | false | int | 返回结果的游标,下一页用返回值里的next_cursor,上一页用previous_cursor,默认为0。 |
trim_status | false | int | 返回值中user字段中的status字段开关,0:返回完整status字段、1:status字段仅返回status_id,默认为1。 |
注意事项
- 参数uid与screen_name二者必选其一,且只能选其一;
- 接口升级后:uid与screen_name只能为当前授权用户;
- 只返回同样授权本应用的用户,非授权用户将不返回;
- 例如一次调用count是5,但其中授权本应用的用户只有1条,则实际只返回1条;
调用样例及调试工具
返回结果
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, "total_number": 61550 }
关于错误返回值与错误代码,参见 错误代码说明
返回字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
id | int64 | 用户UID |
idstr | string | 字符串型的用户UID |
screen_name | string | 用户昵称 |
name | string | 友好显示名称 |
province | int | 用户所在省级ID |
city | int | 用户所在城市ID |
location | string | 用户所在地 |
description | string | 用户个人描述 |
url | string | 用户博客地址 |
profile_image_url | string | 用户头像地址(中图),50×50像素 |
profile_url | string | 用户的微博统一URL地址 |
domain | string | 用户的个性化域名 |
weihao | string | 用户的微号 |
gender | string | 性别,m:男、f:女、n:未知 |
followers_count | int | 粉丝数 |
friends_count | int | 关注数 |
statuses_count | int | 微博数 |
favourites_count | int | 收藏数 |
created_at | string | 用户创建(注册)时间 |
following | boolean | 暂未支持 |
allow_all_act_msg | boolean | 是否允许所有人给我发私信,true:是,false:否 |
geo_enabled | boolean | 是否允许标识用户的地理位置,true:是,false:否 |
verified | boolean | 是否是微博认证用户,即加V用户,true:是,false:否 |
verified_type | int | 暂未支持 |
remark | string | 用户备注信息,只有在查询用户关系时才返回此字段 |
status | object | 用户的最近一条微博信息字段 详细 |
allow_all_comment | boolean | 是否允许所有人对我的微博进行评论,true:是,false:否 |
avatar_large | string | 用户头像地址(大图),180×180像素 |
avatar_hd | string | 用户头像地址(高清),高清头像原图 |
verified_reason | string | 认证原因 |
follow_me | boolean | 该用户是否关注当前登录用户,true:是,false:否 |
online_status | int | 用户的在线状态,0:不在线、1:在线 |
bi_followers_count | int | 用户的互粉数 |
lang | string | 用户当前的语言版本,zh-cn:简体中文,zh-tw:繁体中文,en:英语 |
其他
无
相关问题
到 帮助中心 查看更多问题或提问
文档更新时间: 2017-04-27