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;

请求参数

  必选 类型及范围 说明
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条配额,作为基础费用;
  • 数据按时间倒序返回;
  • 该检索任务可检索到2012年的数据,且每个任务的开始、结束时间区间最大不能超过一个月;
  • 新产生的数据将尽快被检索到,最大延迟不超过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."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2017-06-09
api评价