search/statuses/historical/create
创建检索历史数据任务。
URL
https://c.api.weibo.com/2/search/statuses/historical/create.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
请求所有商业接口：
50000次/小时/IP；
请求参数
必选
类型及范围
说明
source
false
string
采用OAuth授权方式不需要此参数，其他授权方式为必填参数，数值为应用的AppKey。
access_token
false
string
采用OAuth授权方式为必填参数，其他授权方式不需要此参数，OAuth授权后获得。
q
false
string
检索的关键词。最多指定1000个关键词，每个关键词长度不超过24个中文字符或英文字符，由英文半角逗号分隔。匹配上任意关键词的微博都会被检索到。必须进行URLencode。
ids
false
string
搜索指定批量用户的微博，传用户UID，多个用~分隔，最多不超过50个。
province
false
int
搜索的省份ID，参考省份城市编码表，参数q为空表示搜索这个省份的所有微博。
city
false
int
搜索的城市ID，参考省份城市编码表，参数q为空表示搜索这个城市的所有微博，支持传入多个城市，由英文半角逗号分隔。
starttime
true
int64
搜索范围起始时间，取值为时间戳（精确到毫秒）。
endtime
true
int64
搜索范围结束时间，取值为时间戳（精确到毫秒，最晚不能晚过昨天的最后一秒）。
type
false
int
指定微博类型，0：原创、1：转发，默认为空（全部）。
hasv
false
int
是否为v用户发言，0：否、1：是，默认为空（全部）。
onlynum
false
int
1-100：返回指定的百分比。如80，表示返回符合条件数据量的80%（均匀取样）。默认为100。
注意事项
当商业数据总量配额小于1000时，无法创建任务。反之，可以创建任务，并扣除1000条配额，作为基础费用；
数据按时间倒序返回；
该检索任务可检索到2018年的数据，且每个任务的开始、结束时间区间最大不能超过一个月；
新产生的数据将尽快被检索到，最大延迟不超过1天；
参数province、city指发微博的IP所在的省、市；
对于转发微博，只根据转发内容检索，不根据原创内容检索；
参数q、province、ids必传其一；
该接口不支持模糊查询，为根据关键词q精确匹配查询，如果关键词中带有空格，表示&&的逻辑，即包含A又包含B；
指定参数city时，一定要指定参数province；
当同时传入多个city时，返回结果里city字段代表的是传入city的数量，传入单个city时返回的为传入的city编码；
每个任务的最大下载量为200万，超过后会自动截断；
返回结果
JSON示例
//成功返回
{
"id": "3567122345", //任务创建者ID
"q": "昆明暴力事件,三元食品"，
"ids": "324344545~12121343~789078912",
"province": "11",
"city": "5",
"starttime": "1389628800000",
"endtime": "1389690595000",
"type": 1,
"hasv": 1,
"onlynum": 80,
"task_id": "100", //任务ID
"secret_key": "384323434" //任务创建成功后，返回密钥，用于查看任务执行状态、及下载结果数据
}
//失败返回
{
"request": "/2/search/statuses/historical/create.json",
"error_code": "2111XX",
"error": "error message."
}
关于错误返回值与错误代码，参见 错误代码说明
字段说明
无
其他
Language: [[{{{2/uri}}}|中文]]