C/2/search/statuses/historical/create
search/statuses/historical/create
创建检索历史数据任务。
URL
https://c.api.weibo.com/2/search/statuses/historical/create.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权，参见 如何登录授权
访问授权限制
请求所有商业接口：
- 50000次/小时/IP；
- 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精确匹配查询，如果关键词中带有空格，请在关键词外加上双引号以保证精确匹配；
- 指定参数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."
}
关于错误返回值与错误代码，参见 错误代码说明
字段说明
无
其他
文档更新时间: 2023-12-26
