跳转到：导航, 搜索

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条；

调用样例及调试工具

API测试工具

返回结果

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：英语

其他

无

@@ 第9行： / 第9行： @@
 {{api_args|uid|false|int64|需要查询的用户UID。}}
 {{api_args|screen_name|false|string|需要查询的用户昵称。}}
-{{api_args|count|false|int|单页返回的记录条数，默认为50，最大不超过200。}}
+{{api_args|count|false|int|单页返回的记录条数，默认为5，最大不超过5。}}
 {{api_args|cursor|false|int|返回结果的游标，下一页用返回值里的next_cursor，上一页用previous_cursor，默认为0。}}
 {{arg_trim_status}}|
@@ 第15行： / 第15行： @@
 relat_qa=<html><div id="relat_qa" data="friendships/followers"></div></html>|
 result=
-<pre>
+<pre class="brush:js">
 {
      "users": [
          {
-             "id": 1404376560,
+             "id": 321205008,
-             "screen_name": "zaku",
+            "idstr": "321205008",
-             "name": "zaku",
+             "screen_name": "江湖社***",
-             "province": "11",
+             "name": "江湖社***,
-             "city": "5",
+             "province": "41",
-             "location": "北京 朝阳区",
+             "city": "1",
-             "description": "人生五十年，乃如梦如幻；有生斯有死，壮士复何憾。",
+             "location": "河南 郑州",
-             "url": "http://blog.sina.com.cn/zaku",
+             "description": "描述。。。",
-             "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
+             "url": "http://www.weibo.com",
-             "domain": "zaku",
+             "profile_image_url": "http://tp2.sinaimg.cn/321205008/50/5652109562/1",
+            "profile_url": "523438876",
+             "domain": "laijianghu",
+            "weihao": "523438876",
              "gender": "m",
-             "followers_count": 1204,
+             "followers_count": 270,
-             "friends_count": 447,
+             "friends_count": 364,
-             "statuses_count": 2908,
+             "statuses_count": 23,
              "favourites_count": 0,
-             "created_at": "Fri Aug 28 00:00:00 +0800 2009",
+             "created_at": "Wed Jan 02 23:56:03 +0800 2013",
              "following": false,
-             "allow_all_act_msg": false,
+             "allow_all_act_msg": true,
-            "remark": "",
              "geo_enabled": true,
              "verified": false,
-             "status": {
+             "verified_type": -1,
-                "created_at": "Tue May 24 18:04:53 +0800 2011",
+            "remark": "",
-                "id": 11142488790,
+            "status_id": 3532859991713507,
-                "text": "我的相机到了。",
-                "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>",
-                "favorited": false,
-                "truncated": false,
-                "in_reply_to_status_id": "",
-                "in_reply_to_user_id": "",
-                "in_reply_to_screen_name": "",
-                "geo": null,
-                "mid": "5610221544300749636",
-                "annotations": [],
-                "reposts_count": 5,
-                "comments_count": 8
-            },
              "allow_all_comment": true,
-             "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1",
+             "avatar_large": "http://tp2.sinaimg.cn/3212050081/180/5652109562/1",
              "verified_reason": "",
              "follow_me": false,
              "online_status": 0,
-             "bi_followers_count": 215
+             "bi_followers_count": 204,
+            "lang": "zh-cn",
+            "star": 0,
+            "mbtype": 0,
+            "mbrank": 0,
+            "block_word": 0
          },
          ...
      ],
-     "next_cursor": 5,
+     "next_cursor": 1,
      "previous_cursor": 0,
-     "total_number": 668
+     "total_number": 61550
 }
 </pre>|
 resultDes={{Rdes_user}}|
 useAge=
-参数uid与screen_name二者必选其一，且只能选其一；最多返回5000条数据|
+*参数uid与screen_name二者必选其一，且只能选其一；
+*<font style="color:red">接口升级后：uid与screen_name只能为当前授权用户；</font>
+*只返回同样授权本应用的用户，非授权用户将不返回；
+*例如一次调用count是5，但其中授权本应用的用户只有1条，则实际只返回1条；
+|
 otherInfo=无
 }}{{#a:showgrade}}

微博开放平台

首页

平台政策与指引

微博登录接入

移动应用接入

媒体接入平台

电商接入平台

粉丝服务平台

商业接口

网站接入

微博API

资源下载

常见问题

联系我们

工具箱

2017年4月27日 (四) 17:26的最后版本

friendships/followers

URL

支持格式

HTTP请求方式

是否需要登录

访问授权限制

请求参数

注意事项

调用样例及调试工具

返回结果

返回字段说明

其他

相关问题