Jump to: navigation, search


Search for weibos by the multiple conditions.



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.
filter_ori false int Whether filter the weibos by the post type. 0: All; 1:Original; 2: Repost; Default is 0.
filter_pic false int Whether with the picture. 0:All; 1:With a picture; 2:Without a picture;Default is 0.
fuid false int64 User ID of the searched weibos.
province false int Province ID for searching.
city false int City ID for searching.
starttime false int64 Begin time. Unix timestamp format.
endtime false int64 End time. Unix timestamp format.
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.
needcount false boolean Whether return the count.true: Yes; false:No; Default is false.
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.


The returned structure will be different if the needcount is different.


JSON Example

        "created_at": "Tue May 31 17:46:55 +0800 2011",
        "id": 11488058246,
        "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": "5612814510546515491",
        "reposts_count": 8,
        "comments_count": 9,
        "annotations": [],
        "user": {
            "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,
            "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

    "results": [
    "total_count_maybe": 76640772

See the Error Code Description for the error information details.

Field Description

Returned Field Field Type Field Description
idstr string Weibo ID of string
created_at string Created time
id int64 Weibo ID
text string Weibo content
source string Weibo source
favorited boolean Whether it is favorited
truncated boolean Whether it is truncated
in_reply_to_status_id int64 The reply’s ID
in_reply_to_user_id int64 Replyer ID
in_reply_to_screen_name string Replyer nickname
mid int64 Weibo MID
bmiddle_pic string Medium picture
original_pic string Original picture
thumbnail_pic string Thumbnail picture
reposts_count int Repost count
comments_count int Comment count
annotations array Weibo annotation information
geo object Geography information
user object User profile that posted the weibo



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

文档更新时间: 20 January 2012