C/2/search/statuses/limited
(未显示3个用户的14个中间版本) | |||
第6行: | 第6行: | ||
rateLimit={{B_rate_limit}}| | rateLimit={{B_rate_limit}}| | ||
params= | params= | ||
− | {{api_args|q| | + | {{api_args|q|true|string|搜索的关键字( 不能包含{、}、“ 等特殊字符)。必须进行URLencode。}} |
{{api_args|ids|false|string|搜索指定批量用户的微博,传用户UID,多个用~分隔,最多不超过50个。}} | {{api_args|ids|false|string|搜索指定批量用户的微博,传用户UID,多个用~分隔,最多不超过50个。}} | ||
− | {{api_args|province|false|int| | + | {{api_args|province|false|int|搜索的省份ID,参考省份城市编码表。}} |
− | {{api_args|city|false|int| | + | {{api_args|city|false|int|搜索的城市ID,参考省份城市编码表。}} |
− | {{api_args|sort|false|string| | + | {{api_args|sort|false|string|排序方式,time:时间倒序、hot:热门度【设置此参数只会返回精选微博】、fwnum:按转发数倒序、cmtnum:评论数倒序,默认为time。}} |
− | {{api_args|starttime|false|int| | + | {{api_args|starttime|false|int|搜索范围起始时间,取值为时间戳,单位为秒。}} |
− | {{api_args|endtime|false|int| | + | {{api_args|endtime|false|int|搜索范围结束时间,取值为时间戳,单位为秒。}} |
{{api_args|hasori|false|int|是否包含原创,0:不包含原创、1:只包含原创,默认为空(全部)。}} | {{api_args|hasori|false|int|是否包含原创,0:不包含原创、1:只包含原创,默认为空(全部)。}} | ||
{{api_args|hasret|false|int|是否包含转发,0:不包含转发、1:只包含转发,默认为空(全部)。}} | {{api_args|hasret|false|int|是否包含转发,0:不包含转发、1:只包含转发,默认为空(全部)。}} | ||
第23行: | 第23行: | ||
{{api_args|hasv|false|int|是否为v用户发言,0:否、1:是,默认为空(全部)。}} | {{api_args|hasv|false|int|是否为v用户发言,0:否、1:是,默认为空(全部)。}} | ||
{{api_args|istag|false|int|是否严格为搜##内的话题,0:否、1:##内模糊匹配、2:##内精确匹配,默认为0。}} | {{api_args|istag|false|int|是否严格为搜##内的话题,0:否、1:##内模糊匹配、2:##内精确匹配,默认为0。}} | ||
− | |||
{{api_args|dup|false|int|是否排重(不显示相似数据),0:否、1:是,默认为1。}} | {{api_args|dup|false|int|是否排重(不显示相似数据),0:否、1:是,默认为1。}} | ||
{{api_args|antispam|false|int|是否反垃圾(不显示低质量数据),0:否、1:是,默认为1。}} | {{api_args|antispam|false|int|是否反垃圾(不显示低质量数据),0:否、1:是,默认为1。}} | ||
{{api_args|page|false|int|页码,默认为1。}} | {{api_args|page|false|int|页码,默认为1。}} | ||
− | {{api_args|count|false|int| | + | {{api_args|count|false|int|每页返回的数量,最小为10,最大50。(默认返回10条)}} |
{{api_args|base_app|false|int|是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。}}| | {{api_args|base_app|false|int|是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。}}| | ||
result= | result= | ||
第84行: | 第83行: | ||
</pre>| | </pre>| | ||
resultDes={{Rdes_status}}| | resultDes={{Rdes_status}}| | ||
− | useAge= | + | useAge=*sort参数值fwnum, cmtnum, hot 都只对近期原创微博有效; |
− | *sort参数值fwnum, cmtnum, hot | + | *sort参数值fwnum, cmtnum只针对最近一个月数据有效; |
*参数province、city指发微博的IP所在的省、市; | *参数province、city指发微博的IP所在的省、市; | ||
*指定city时,一定要指定province; | *指定city时,一定要指定province; | ||
− | * | + | *参数q为必传; |
+ | *搜索为模糊匹配; | ||
+ | *结果总数,若结果大于1000,仅显示1000,请根据starttime和endtime获取更多数据; | ||
+ | *返回的微博内容超过140字时,本接口只返回140字以内的内容,如需获取完整微博内容,请求/statuses/show_batch/biz接口获取超过140字内容。| | ||
otherInfo= | otherInfo= | ||
*关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法; | *关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法; |
2018年1月31日 (三) 11:32的最后版本
search/statuses/limited
搜索含某关键词的微博 。
URL
https://c.api.weibo.com/2/search/statuses/limited.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
q | true | string | 搜索的关键字( 不能包含{、}、“ 等特殊字符)。必须进行URLencode。 |
ids | false | string | 搜索指定批量用户的微博,传用户UID,多个用~分隔,最多不超过50个。 |
province | false | int | 搜索的省份ID,参考省份城市编码表。 |
city | false | int | 搜索的城市ID,参考省份城市编码表。 |
sort | false | string | 排序方式,time:时间倒序、hot:热门度【设置此参数只会返回精选微博】、fwnum:按转发数倒序、cmtnum:评论数倒序,默认为time。 |
starttime | false | int | 搜索范围起始时间,取值为时间戳,单位为秒。 |
endtime | false | int | 搜索范围结束时间,取值为时间戳,单位为秒。 |
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。 |
dup | false | int | 是否排重(不显示相似数据),0:否、1:是,默认为1。 |
antispam | false | int | 是否反垃圾(不显示低质量数据),0:否、1:是,默认为1。 |
page | false | int | 页码,默认为1。 |
count | false | int | 每页返回的数量,最小为10,最大50。(默认返回10条) |
base_app | false | int | 是否只获取当前应用的数据。0为否(所有数据),1为是(仅当前应用),默认为0。 |
注意事项
- sort参数值fwnum, cmtnum, hot 都只对近期原创微博有效;
- sort参数值fwnum, cmtnum只针对最近一个月数据有效;
- 参数province、city指发微博的IP所在的省、市;
- 指定city时,一定要指定province;
- 参数q为必传;
- 搜索为模糊匹配;
- 结果总数,若结果大于1000,仅显示1000,请根据starttime和endtime获取更多数据;
- 返回的微博内容超过140字时,本接口只返回140字以内的内容,如需获取完整微博内容,请求/statuses/show_batch/biz接口获取超过140字内容。
返回结果
JSON示例
{ "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 }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
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 |
其他
- 关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法;
- 与:空格即可,如A B
- 或:~表示,如A~B~C
- 非:空格-,比如A -B,表示出现A,不出现B
- 混用情况:(A B)~(C D)表示同时出现A,B或同时出现C,D, A B -C表示同时出现A,B但不出现C
- 与、或、非的关键词不能包含除字母、数字外的其他特殊符号;
文档更新时间: 2018-01-31