C/2/search/statuses/limited-en
第83行: | 第83行: | ||
</pre>| | </pre>| | ||
resultDes={{Rdes_status}}| | resultDes={{Rdes_status}}| | ||
− | useAge=* | + | useAge=* 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;| |
otherInfo= | otherInfo= | ||
*关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法; | *关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法; |
2018年5月22日 (二) 18:14的版本
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 '{','}'. |
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
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
created_at | string | 微博创建时间 |
id | int64 | 微博ID |
mid | int64 | 微博MID |
idstr | string | 字符串型的微博ID |
text | string | 微博信息内容 |
source | string | 微博来源 |
favorited | boolean | 是否已收藏,true:是,false:否 |
truncated | boolean | 是否被截断,true:是,false:否 |
in_reply_to_status_id | string | (暂未支持)回复ID |
in_reply_to_user_id | string | (暂未支持)回复人UID |
in_reply_to_screen_name | string | (暂未支持)回复人昵称 |
thumbnail_pic | string | 缩略图片地址,没有时不返回此字段 |
bmiddle_pic | string | 中等尺寸图片地址,没有时不返回此字段 |
original_pic | string | 原始图片地址,没有时不返回此字段 |
geo | object | 地理信息字段 详细 |
user | object | 微博作者的用户信息字段 详细 |
retweeted_status | object | 被转发的原微博信息字段,当该微博为转发微博时返回 详细 |
reposts_count | int | 转发数 |
comments_count | int | 评论数 |
attitudes_count | int | 表态数 |
mlevel | int | 暂未支持 |
visible | object | 微博的可见性及指定可见分组信息。该object中type取值,0:普通微博,1:私密微博,3:指定分组微博,4:密友微博;list_id为分组的组号 |
pic_ids | object | 微博配图ID。多图时返回多图ID,用来拼接图片url。用返回字段thumbnail_pic的地址配上该返回字段的图片ID,即可得到多个图片url。 |
ad | object array | 微博流内的推广微博ID |
Others
- 关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法;
- 与:空格即可,如A B
- 或:~表示,如A~B~C
- 非:空格-,比如A -B,表示出现A,不出现B
- 混用情况:(A B)~(C D)表示同时出现A,B或同时出现C,D, A B -C表示同时出现A,B但不出现C
- 与、或、非的关键词不能包含除字母、数字外的其他特殊符号;