C/2/search/statuses/limited/en
search/statuses/limited
Search for weibos by the multiple conditions.
URL
https://c.api.weibo.com/2/search/statuses/limited.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;
- 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. |
q | true | string | Keyword for searching.It must be encoded by URLencoding. |
sort | false | string | 排序方式,time:时间倒序、hot:热门度、fwnum:按转发数倒序、cmtnum:评论数倒序,默认为time。 |
starttime | false | int | Begin time. Unix timestamp format. |
endtime | false | int | End time. Unix timestamp format. |
hasori | false | int | 是否包含原创,0:不包含原创、1:只包含原创,默认为空(全部)。 |
hasret | false | int | 是否包含转发,0:不包含转发、1:只包含转发,默认为空(全部)。 |
hastext | false | int | 是否包含纯文本,0:不包含纯文本、1:只包含纯文本,默认为空(全部)。 |
haspic | false | int | 是否包含图片,0:不包含图片、1:只包含图片,默认为空(全部)。 |
hasvideo | false | int | 是否包含视频,0:不包含视频、1:只包含视频,默认为空(全部)。 |
hasmusic | false | int | 是否包含音乐,0:不包含音乐、1:只包含音乐,默认为空(全部)。 |
haslink | false | int | 是否包含链接,0:不包含链接、1:只包含链接,默认为空(全部)。 |
hasat | false | int | 是否包含@,0:不包含@、1:只包含@,默认为空(全部)。 |
hasv | false | int | 是否为v用户发言,0:否、1:是,默认为空(全部)。 |
istag | false | int | 是否为搜##内的话题,0:否、1:模糊匹配、2:精确匹配,默认为0。 |
onlynum | false | int | 是否只返回总数,0:否、1:是,默认为0。 |
dup | false | int | 是否排重(不显示相似数据),0:否、1:是,默认为1。 |
antispam | false | int | 是否反垃圾(不显示低质量数据),0:否、1:是,默认为1。 |
page | false | int | The returned page.Default is 1. |
count | false | int | The returned count for every page.Default is 10.The max value is 50 |
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
- 根据购买的返回条数,返回相应的搜索结果条数,最多返回1000条微博,与搜到的总数会不一致;
- 购买的返回条数不能小于每页返回的数量;
- sort参数值fwnum, cmtnum, hot 都只对近期原创微博有效。若返回的是转发微博,则sort为这三种排序时无数据返回;
Response
JSON Example
{ "statuses": [ { "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 } }, ... ], "total_number": 16 }
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
- 关键词q用英文双引号引起后,再UTF-8编码,搜索时表示精确匹配;
- 关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法;
- 与:空格即可,如A B
- 或:~表示,如A~B~C
- 非:空格-,比如A -B,表示出现A,不出现B
- 混用情况:(A B)~(C D)表示同时出现A,B或同时出现C,D, A B -C表示同时出现A,B但不出现C
- 与、或、非的关键词不能包含除字母、数字外的其他特殊符号;