C/2/search/statuses/limited

跳转到: 导航, 搜索
 
第89行: 第89行:
 
*参数q为必传;
 
*参数q为必传;
 
*搜索为模糊匹配;
 
*搜索为模糊匹配;
*结果总数,若结果大于1000,仅显示1000,请根据starttime和endtime获取更多数据|
+
*结果总数,若结果大于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;

请求参数

  必选 类型及范围 说明
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
  • 与、或、非的关键词不能包含除字母、数字外的其他特殊符号;



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2018-01-31
api评价