Jump to: navigation, search


Search for users by the keyword.



Supported Formats


HTTP Request Method


Requires Login

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

Requests Count Limitation

Level:Advanced ( Authorization Required )
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.
q false string Keyword for searching.It must be encoded by URLencoding.
snick false int Whether search for the nickname. 0:No; 1:Yes;
sdomain false int Whether search for the domain name. 0:No; 1:Yes;
sintro false int Whether search for the user description. 0:No; 1:Yes;
stag false int Whether search for the tag. 0:No; 1:Yes;
province false int Province ID for searching.
city false int City ID for searching.
gender false string Gender for searching. m:Male; f:Female;
comorsch false string Company or school name for searching.
sort false int Return the users by the sort type.1: Updated time; 2: Followers count;Default is 1.
count false int The returned count for every page.Default is 10.The max value is 50.
page false int The returned page.Default is 1.
base_app false int Whether get the data based on current application only. 1 is only current application; 0 is no limitation. The default value is 0.




JSON Example

    "users": [
            "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,
            "remark": "",
            "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