C/2/search/statuses/limited-en
search/statuses/limited
search for posts containing a certain keyword.
URL
https://c.api.weibo.com/2/search/statuses/limited.json
Supported Formats
JSON
HTTP Request Method
GET
Login Requirement
true
See Login and Authorization for details.
Authorized Access Limitation
Request for all the business API:
- 50000 times per hour per IP;
- 50000 times per hour per IP;
Request Parameters
Requires | Type and Range | Description | |
---|---|---|---|
source | false | string | This parameter is not needed when using OAuth, and is required when using other authorization methods. The value of this parameter is AppKey. |
access_token | false | string | This parameter is required when using OAuth, and is not needed when using other authorization methods. You will get the access_token after obtaining OAuth. |
q | false | string | The keywords that you want to search, it cannot include special symbols such as '{','}'. Must be URL encoded. |
ids | false | string | The user ids that you want to search, multuple user ids are should be seperated by '~', the total number of users cannot exceed 50. |
province | false | int | The province id that you want to search, please refer to our province and city code sheet. |
city | false | int | The city id that you want to search, please refer to our province and city code sheet. |
sort | false | string | Type of sort,time:by time、hot:by content polularity、fwnum:by repost count in reverse order、cmtnum:by comment count in reverse order, time is the default type. |
starttime | false | int | The start time you would specify. |
endtime | false | int | The end time you would specify. |
hasori | false | int | Whether to include the original post, 0:not include the original post, 1:only include the original post. In defalut, all posts are included. |
hasret | false | int | Whether to include repost, 0:not include repost, 1:only include repost. In defalut, all posts are included. |
hastext | false | int | Whether to include pure text , 0:not include pure text, 1:only include pure text. In defalut, all posts are included. |
haspic | false | int | Whether to include picture , 0:not include picture, 1:only include picture. In defalut, all posts are included. |
hasvideo | false | int | Whether to include video , 0:not include video, 1:only include video. In defalut, all posts are included. |
hasmusic | false | int | Whether to include music , 0:not include music, 1:only include music. In defalut, all posts are included. |
haslink | false | int | Whether to include link , 0:not include link, 1:only include link. In defalut, all posts are included. |
hasat | false | int | Whether to include symbol '@' , 0:not include '@', 1:only include '@'. In defalut, all posts are included. |
hasv | false | int | Whether the content is published by v users , 0:no 1:yes. In defalut, all posts are included. |
istag | false | int | Whether to precisely search topics between ##, 0: no(default) 1:fuzzy matching 2: precise matching. |
dup | false | int | Whether to remove duplicated posts, 0: no, 1: yes(default). |
antispam | false | int | Whether to spam, 0: no, 1:yes (default). |
page | false | int | page number, default is 1. |
count | false | int | The post count of a page, minimum is 10 (default), maximum is 50. |
base_app | false | int | Whether only to retrieve data from the existing application, 0: no (seach all data, in default), 1: yes (only search the existing app data) |
Notes
- The value of parameter sort fwnum, cmtnum, hot would only be valid for the recent original posts;
- The parameters city and province are based on ip when users are publishing post;
- The parameter province must be specified when you specify city;
- The parameter q must be specified.
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 }
Please see Error Code Description for details of error information.
Field Description
None
Others
- Logic operators are supported. When using logic operators, the number of keywords should be less than 5;
- ADD:space, for example: A B
- OR:~, for example: A~B~C
- NOT:space-,for example: A -B,it means: A occurs, B does not occur;