C/2/search/statuses/oneyear
search/statuses/oneyear
搜索含某关键词近一年的全部微博(beta)。
URL
https://c.api.weibo.com/2/search/statuses/oneyear.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
是
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
q | false | string | 搜索的关键词。 |
province | false | int | 搜索的省份ID,参考省份城市编码表,参数q为空表示搜索这个省份的所有微博。 |
city | false | int | 搜索的城市ID,参考省份城市编码表,参数q为空表示搜索这个城市的所有微博,支持传入多个城市,由英文半角逗号分隔。 |
starttime | true | int64 | 搜索范围起始时间,取值为unix时间戳(精确到秒),pageId未指定时必传。 |
endtime | true | int64 | 搜索范围结束时间,取值为unix时间戳(精确到秒),pageId未指定时必传。 |
type | false | int | 指定微博类型,0:原创、1:转发,默认为空(全部)。 |
pageId | true | int | 翻页id(翻页时只需要传入该参数,无需其他参数),该参数失效时间为5秒。 |
注意事项
- 数据按时间倒序返回;
- 参数province、city指发微博的IP所在的省、市;
- 对于转发微博,只根据转发内容检索,不需根据原创内容检索;
- 指定city时,一定要指定province;
- 每页返回10条数据;
- 参数q和province两者必传其一;
- 该接口目前在测试期,仅支持搜索近两周内的数据,正式上线后支持搜索近一年的全量数据。
返回结果
JSON示例
//原创微博: { "mid": "3701582888062260", "uid": "3876186865", "extend": "-1", //扩展属性,原创值为-1 "huati_tag": "", //话题标签 "created_at": "2014-04-20 23:59:55", "source_id": "365330", //微博应用来源 "filter": "264", //微博类型,1:图片微博,2:含链接微博,4:转发微博,8:含@微博,16:视频微博,32:音乐微博,64:含表情微博,1+16:图片+视频微博,依次递推 "content": "为你做的一切都值得,我你,你要紧握我,@赵晗炜 不管将来怎么样,我希望我能做到文章的一句话我最骄傲的一件事就是我的女人叫张恩竹@赵晗炜 我爱你 我在这里:http://t.cn/8kP8VGy", //博文内容 "mentions": "1806892183", //博文内被提及人列表 "blog_url ": "http://weibo.com/3876186865/B0Fb2xPms", //博文地址 "parent_rt_id_db": "-1", //原博文ID,当为原创时,该值为-1 } //转发微博: { "mid": "3701582888061524", "uid": "1778265875", "extend": "text=>今天给爸妈写的信。。。,rootuid=>1658537731,rootmid=>3644164354469467,rootmid62=>AiwUPiKIb", "huati_tag": "", "created_at": "2014-04-20 23:59:54", "source_id": "576239", "filter": "77", "content": "//@田不野:尽管社会上总有论调,说一代不如一代。但是这样的文章让我相信,社会是在前进。 //@泉水叮咚玲珑心:@皮皮旺财小皮妈 //@邵_小_花:作者的这个观点非常精准。", "mentions": "1675753864, 1777476347, 1061866935, 1412337811, 1658537731", "blog_url ": "http://weibo.com/1778265875/B0Fb2xPaA", "parent_rt_id_db": "3701568102992124", }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
- 关键词内容支持与、或、非。最好是5个词以内,并且最好一次使用一种语法;
- 与:空格即可,如A B
- 或:~表示,如A~B~C
- 非:空格-,比如A -B,表示出现A,不出现B
- 混用情况:(A B)~(C D)表示同时出现A,B或同时出现C,D, A B -C表示同时出现A,B但不出现C
- 与、或、非的关键词不能包含除字母、数字外的其他特殊符号;