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;

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

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


api评价