C/2/friendships/followers/biz-en
friendships/followers/biz
Return current login user's follower list.
URL
https://c.api.weibo.com/2/friendships/followers/biz.json
Supported Formats
JSON
HTTP Request Method
GET
Requires Login
true
See the Login and Authorization Mechanism Statement for login and authorization details.
Requests Count Limitation
Request all APIs:
- 50000/hour/IP;
- 50000/hour/IP;
Request Parameters
Requires | Type and Range | Description | |
---|---|---|---|
source | false | string | This parameter is not needed when using OAuth.The value of this parameter is the AppKey. |
access_token | false | string | This parameter is required when using OAuth.You will get the access_token after oauth authorization. |
gender | false | string | Designated followers gender, m for male, f for female. |
province | false | int | Designated followers province, using province ID. |
city | false | int | Designated followers city, using 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 verification type of 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 exceeding 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. |
limit | false | int | Internal parameters, used to constrain the followers number developers can get. If set to 'N', means can just get the latest N followers. If no value is assigned, can get all followers. |
Notes
- Can just return current login user's follower list.
- 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.
Response
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, "cursor_uid":2903271035, "total_number": 61550 } //失败返回 { "request": "/friendships/followers/biz.json", "error_code": XXXXX, "error": "error message." }
See the Error Code Description for the error information details.
Field Description
none
Others
none