搜狗首页  |   服务首页  |   客服热线:010-56898080

API参考  |  平均排名下载服务

平均排名下载服务 (CpcRankService)

通过 CpcRankService ,您可以下载帐户所有有消耗的关键词平均排名信息。您首先需要通过 getCpcRankId() 方法获得一个字符串类型的 rankId ,然后通过调用 getCpcRankStatus() 方法检查数据是否产生。待产生后,则可调用 getCpcRankPath() 方法获取文件的下载地址。根据该地址即可下载您所需要的整帐户文件。 同报告 id 一样,下载任务 id 采用 <32 位 16 进制数 > 的取值形式。 当天7点后可获取昨天的数据。

数据类型

接口描述

getCpcRankId

方法说明:获取下载平均排名的任务ID
输入信息: getCpcRankIdRequest 说明如下 :

属性名 类型 说明 限制
deviceType Integer 设备类型 id 选填,默认为0,0代表计算机,1代表移动设备
queryDate Date 查询日期 选填,目前只支持查询昨天的排名数据,该字段可以不填

返回信息: getCpcRankIdResponse :含有本次请求所返回的任务 Id.

属性名 类型 说明 限制
rankId String 执行下载任务 ID ID 为一串 MD5 值,格式为 32 位 16 进制数标示,例如 8e7e3f2d84a19c5df1415957434b2bd8

getCpcRankStatus

方法说明:查询任务是否生成
输入信息: getCpcRankStatusRequest

属性名 类型 说明 限制
rankId String 下载的任务 ID

返回信息: getCpcRankStatusResponse :

属性名 类型 说明 限制
isGenerated Integer 文件生成状态 1: 已完成
0: 处理中
-1:下载异常

getCpcRankPath

方法说明:获取排名下载地址
输入信息: getCpcRankPathRequest

属性名 类型 说明 限制
rankId String 下载的任务 ID

返回信息: getCpcRankPathResponse

属性名 类型 说明 限制
rankPath String 下载地址