C/2/friendships/followers/other all-en

跳转到: 导航, 搜索


Return the list of followers.



Supported Formats


HTTP Request Method


Login Requirement

See Login and Authorization for details.

Authorized Access Limitation

Request for all the business API:

    • 50000 times per hour per IP;

Request Parameters

  Requires Type and Range Description
source false string This parameter is not needed when using OAuth, and is required when using other authorization methods. The value of this parameter is AppKey.
access_token false string This parameter is required when using OAuth, and is not needed when using other authorization methods. You will get the access_token after obtaining OAuth.
uid false long Return designated user IDs' followers. The result will be current user's by default.
screen_name false string Users' nickname.
gender false string Designate the gender of the followers: m for male; f for female.
province false int Designate the province range of the followers, the province ID.
city false int Designate the city range of the followers, the city ID.
age false string Designate the age range of the followers. The ranges are from 6 to 12, 13 to 18, 19 to 22, 23 to 25, 26 to 29, 30 to 39, 40 to 59, 60 to 80 and others.
type false int Designate the verified type of the followers: 0 for all the users; 1 for normal users; 2 for 'yellow V' users; 4 for 'blue V' users (including government, enterprises , media, website, campus , applications, institutions or groups and non-profit organizations) ; 8 for masters. Any stacking numbers value is supported. For example: 6 stands for yellow V plus blue V. Default as all users.
flag false int Designate the properties of followers: 0 for all followers; 1 for active followers; 2 for interactive followers, Any stacking numbers value is supported, for example: 3 stands for active followers plus interactive followers. Defaults as 0.
bucket false int The number of the screening followers, which defaults as 50, not exceeds 200.
max_time false string The timestamp cursor of the returning result. If this parameter is designated, return those followers who followed no later than max_time, default as counting from current time. The field of 'next_cursor' in the returned results stands for max_time in next page. End of the results is reached if next_cursor is '0'.
cursor_uid false int Remove duplicate IDs, transfer the latest user ID.


  • One of the uid and screen_name must be chosen. Uid is preferred when using both of them.
  • The active followers refer to those who logged in within 30 days.
  • The interactive followers refer to those followers who made comment s or repost within 30 days.


JSON Example

    "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

Please see Error Code Description for details of error information.

Field Description




Language: [[{{{2/uri}}}|中文]]

文档更新时间: 2015-07-16