C/2/search/statuses/historical/create
(以“{{Api_desc_business| uri=search/statuses/historical/create| desc=创建检索历史数据任务。| httpMethod=POST| needAuth=是| rateLimit={{B_rate_limit}}| params...”为内容创建页面) |
|||
| 第31行： | 第31行： | ||
"starttime": "1389628800", | "starttime": "1389628800", | ||
"endtime": "1389690595", | "endtime": "1389690595", | ||
| − | "type": , | + | "type": 1, |
| − | "hasv": , | + | "hasv": 1, |
"onlynum": 80, | "onlynum": 80, | ||
"task_id": "100", //任务ID | "task_id": "100", //任务ID | ||
2014年4月30日 (三) 11:31的版本
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 | 是否只返回总数，0：是、1-100：指定的百分比。如80，表示返回符合条件数据量的80%（时间倒序，最近的80%）。默认为100。 |
注意事项
- 当商业数据总量配额小于1000时，无法创建任务。反之，可以创建任务，并扣除1000条配额，作为基础费用；
- 数据按时间倒序返回；
- 该检索任务可检索到2012年的数据，且每个任务的开始、结束时间区间最大不能超过一个月；
- 新产生的数据将尽快被检索到，最大延迟不超过1天；
- 参数province、city指发微博的IP所在的省、市；
- 对于转发微博，只根据转发内容检索，不根据原创内容检索；
- 参数q、province、city、ids必传其一；
- 指定参数city时，一定要指定参数province；
返回结果
JSON示例
//成功返回
{
"id": "3567122345", //任务创建者ID
"q": "昆明暴力事件,三元食品"，
"ids": "324344545~12121343~789078912",
"province": "11",
"city": "5",
"starttime": "1389628800",
"endtime": "1389690595",
"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."
}
关于错误返回值与错误代码，参见 错误代码说明
字段说明
无
其他
无
