Jump to: navigation, search


Return system recommended users.



Supported Formats


HTTP Request Method


Requires Login

See the Login and Authorization Mechanism Statement for login and authorization details.

Requests Count Limitation

Count Limitation:true
See the Interface Access Rights Statement for the request count limitation details.

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.
category false string Return a certain kind of recommend users by the category.Default is default. default:Hot user; ent:Film star; music:Music; fashion:Fashion; literature:Literature; business:Business; sports:Sport; health:Health; auto:Automobile; house:Housing estates; trip:Trip; stock:Stock; food:Food; fate:Fate; art:Art; tech:Science and technology; cartoon:Cartoon; games:Game;




JSON Example

        "id": 1404376560,
        "screen_name": "zaku",
        "name": "zaku",
        "province": "11",
        "city": "5",
        "location": "北京 朝阳区",
        "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。",
        "url": "http://blog.sina.com.cn/zaku",
        "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1",
        "domain": "zaku",
        "gender": "m",
        "followers_count": 1204,
        "friends_count": 447,
        "statuses_count": 2908,
        "favourites_count": 0,
        "created_at": "Fri Aug 28 00:00:00 +0800 2009",
        "following": false,
        "allow_all_act_msg": false,
        "geo_enabled": true,
        "verified": false,
        "status": {
            "created_at": "Tue May 24 18:04:53 +0800 2011",
            "id": 11142488790,
            "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",
        "verified_reason": "",
        "follow_me": false,
        "online_status": 0,
        "bi_followers_count": 215

See the Error Code Description for the error information details.

Field Description

Returned Field Field Type Field Description
id int64 User ID
screen_name string User nickname
name string Friendly displayed name
province int Province ID user located
city int City ID user located
location string Address user located
description string User description
url string Url of the user’s blog
profile_image_url string Profile image
domain string The user’s personalized weibo url
gender string Gender, m--male, f-- female, n-- unknown
followers_count int Followers count
friends_count int Friends count
statuses_count int Weibo count
favourites_count int Favorites count
created_at string Created time
following boolean Whether the current user is following the user
allow_all_act_msg boolean Whether all the people can send direct message to the user
geo_enabled boolean Whether can have the geography information
verified boolean Whether the user is verified by his real identity, marked with “V”
allow_all_comment boolean Whether all the people can comment the user's weibo
avatar_large string Profile large image
verified_reason string verification reason
follow_me boolean Whether the user is following the current user
online_status int Whether the user is online,0:offline、1:online
bi_followers_count int The count of the users that are following the user and are being followed by the user
status object The latest weibo of the user



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

文档更新时间: 20 January 2012