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 | Return the weibos by the sort type.time : reverse order by time; hot : order by hot; fwnum: reverse order by repost count; cmtnum: reverse order by comment count; Default is 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
- 与、或、非的关键词不能包含除字母、数字外的其他特殊符号；
