C/2/search/statuses/historical/download
search/statuses/historical/download
下载任务执行后的结果数据。
URL
https://c.api.weibo.com/2/search/statuses/historical/download.json
支持格式
JSON
HTTP请求方式
GET
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
task_id | true | int | 检索历史数据任务ID。 |
timestamp | true | timestamp | 调用方服务器当前时间的UNIX时间戳。 |
signature | true | string | 认证签名。加密方式为signature = md5(id + secret_key + timestamp)。id为任务创建者ID,id,secret_key平台方通过task_id得到。(编码规则:16进制,小写字母) |
注意事项
- 该接口将验证商业数据总量配额,当配额>=(任务结果条数-1000),扣除相应配额(扣除配额=任务结果条数-1000);若任务结果条数小于等于1000,则不需判断配额且不再扣除配额。然后跳转至下载地址;
- 当访问该接口,第一次获取该appkey的该task_id下的数据时,扣除配额,之后重复下载该appkey下同一个task_id下数据时,不再扣除配额;
- 下载地址与task_id唯一对应,点击下载地址可进行数据下载;
- 解压数据包时,需要输入task_id+secret_key(如:1172851e0f5a39d0fe242eff91a)值验证后才可成功解压;
- 每个数据包最多返回2000000条数据,您可以根据最后一条数据的生成时间作为任务终止时间再次创建任务继续检索;
- 每个下载任务(task_id)7天后自动过期,过期后,再调该接口返回相应错误信息;
返回结果
JSON示例
//成功返回 无,跳转到下载地址 //失败返回 { "request": "/aim/campaign/create.json", "error_code": 2111XX, "error": "error information" //显示错误信息 }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
下载后的数据返回格式
//原创微博: { "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", }
文档更新时间: 2018-10-25