2/search/statuses/en

跳转到: 导航, 搜索
(Created page with '{{api_desc_v2| uri=search/statuses| desc=搜索与指定的一个或多个条件相匹配的微博| httpMethod=GET| needAuth=是| level={{Api_L2}}| rateLimit=是| params={{api_ar…')
 
 
第1行: 第1行:
{{api_desc_v2|
+
{{api_desc_v2_en|
 
uri=search/statuses|
 
uri=search/statuses|
desc=搜索与指定的一个或多个条件相匹配的微博|
+
desc=Search for weibos by the multiple conditions. |
 
httpMethod=GET|
 
httpMethod=GET|
needAuth=|
+
needAuth=true|
level={{Api_L2}}|
+
level={{Api_L2_en}}|
rateLimit=|
+
rateLimit=true|
params={{api_args|q|false|string|搜索的关键字,必须进行URLencode。}}
+
params={{api_args|q|false|string|Keyword for searching.It must be encoded by URLencoding.}}
{{api_args|filter_ori|false|int|过滤器,是否为原创,0:全部、1:原创、2:转发,默认为0。}}
+
{{api_args|filter_ori|false|int|Whether filter the weibos by the post type. 0: All; 1:Original; 2: Repost; Default is 0. }}
{{api_args|filter_pic|false|int|过滤器。是否包含图片,0:全部、1:包含、2:不包含,默认为0。}}
+
{{api_args|filter_pic|false|int|Whether with the picture. 0:All; 1:With a picture; 2:Without a picture;Default is 0.}}
{{api_args|fuid|false|int64|搜索的微博作者的用户UID。}}
+
{{api_args|fuid|false|int64|User ID of the searched weibos.}}
{{api_args|province|false|int|搜索的省份范围,省份ID。}}
+
{{api_args|province|false|int|Province ID for searching.}}
{{api_args|city|false|int|搜索的城市范围,城市ID。}}
+
{{api_args|city|false|int|City ID for searching.}}
{{api_args|starttime|false|int64|开始时间,Unix时间戳。}}
+
{{api_args|starttime|false|int64|Begin time. Unix timestamp format.}}
{{api_args|endtime|false|int64|结束时间,Unix时间戳。}}
+
{{api_args|endtime|false|int64|End time. Unix timestamp format.}}
{{api_args|count|false|int|单页返回的记录条数,默认为10,最大为50。}}
+
{{api_args|count|false|int|The returned count for every page.Default is 10.The max value is 50.}}
{{api_args|page|false|int|返回结果的页码,默认为1。}}
+
{{api_args|page|false|int|The returned page.Default is 1.}}
{{api_args|needcount|false|boolean|返回结果中是否包含返回记录数,true:返回、false:不返回,默认为false。}}
+
{{api_args|needcount|false|boolean|Whether return the count.true: Yes; false:No; Default is false.}}
{{api_args|base_app|false|int|是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。}}|
+
{{api_args|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. }}|
 
result=
 
result=
 
<pre>
 
<pre>
第78行: 第78行:
 
}
 
}
 
</pre>|
 
</pre>|
resultDes={{Rdes_status}}|
+
resultDes={{Rdes_status_en}}|
useAge=needcount参数不同,会导致相应的返回值结构不同|
+
useAge=The returned structure will be different if the needcount is different.|
otherInfo=
+
otherInfo=None
 
}}
 
}}

2012年1月20日 (五) 15:01的最后版本

search/statuses

Search for weibos by the multiple conditions.

URL

https://api.weibo.com/2/search/statuses.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

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.

Notes

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

Response

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
        }
    },
    ...
]

//needcount为true时
{
    "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

Others

None



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


文档更新时间: 2012-01-20