关键词报告列表


获取实时关键词报告。接口分为实时数据接口和结算数据接口。通过实时数据接口可以获取相应层级的实时数据,可以不考虑延迟,但是数据没有经过反作弊清洗,不能作为结算数据。

HTTP请求方式

POST

请求地址

https://api.e.360.cn/dianjing/report/keywordNow

Headers 请求参数
字段 类型 必须 描述
apiKey String Yes 注册时分配到的api key,该参数作为HTTP HEAD字段传递。
accessToken String Yes 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin
Body 请求参数
字段 类型 必须 描述
level String Yes 物料层级,account代表账户级别,plan代表计划级别,group代表组级别
type String No 选择关键词报告的投放端类型,允许为空或不包含该参数,若不带该参数默认为all。all表示查询全部投放端数据,mobile表示移动,computer表示计算机
idList String No 如果是账户不填,其他层级需要对应的计划id或组id,使用json格式,如[1000001,20000001]
page int No 返回结果的页码,默认为1。
参数备注
1 type不传或type=all ,computer,mobile不会被聚合,如果在两种投放都展现则同一条物料为两条数据
2 level和idList共同控制;level=account,idList不起作用;level=plan,idList为计划id;level=group idList为组id
3 不建议使用idList参数,建议用户取全量数据自行进行筛选
4 每页数据1000条
请求示例
curl -X POST \ 
--header 'apiKey:APIKEY' \ 
--header 'accessToken:ACCESSTOKEN' \ 
--data 'level=account&type=all&idList=&page=1' \ 
'https://api.e.360.cn/dianjing/report/keywordNow'
返回结果
{
  "keywordList": [
    {
      "avgPosition": "0.00",
      "type": "computer",
      "keywordId": 27276359255,
      "mavgPosition": "1.00",
      "avgLeftPosition": "0.00",
      "mavgLeftPosition": "1.00",
      "mobileUrl": "http://m.simba.taob.com/",
      "url": "http://www.simba.taob.com/",
      "keyword": "关键词",
      "groupId": 1893835111,
      "campaignId": 3099690047,
      "clicks": "0",
      "views": "1",
      "totalCost": "0.00000",
      "date": "2019-12-13",
      "groupName": "组名称",
      "campaignName": "计划名称",
      "converts": "1",               //仅当type!=all时,才有此字段
      "convertsCost": "425.23",      //仅当type!=all时,才有此字段
      "ocpcRemarkName": "表单提交"    //仅当type!=all时,才有此字段
    }
  ]
}
返回结果说明
字段 类型 描述
date string 日期
type string 关键词报告的投放端类型
campaignId string 推广计划ID
groupId string 推广组ID
keywordId string 关键词ID
keyword string 关键词
views string 展现
clicks string 点击
totalCost string 消费
avgPosition string 关键词计算机排名
mavgPosition string 关键词移动排名
avgLeftPosition string 关键词左方排名
mavgLeftPosition string 关键词上方排名
url string pc端url
mobileUrl string 移动端url
converts string 转化数,仅当type!=all时,才有此字段
convertsCost string 实际转化成本,仅当type!=all时,才有此字段
ocpcRemarkName string 转化类型,仅当type!=all时,才有此字段

results matching ""

    No results matching ""