关键词报告列表

获取实时关键词报告。由于数据来源不同，本接口的当天数据和7天历史数据不能同时获取；历史数据最晚可以获取到前一天的23时，当天数据最晚可以获取到上一个小时，具体请参照参数说明。由于报表需要时间生成，如需获取上一个小时的数据，建议延迟15分钟获取。

HTTP请求方式

POST

请求地址

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

Headers 请求参数

字段	类型	必须	描述
apiKey	String	Yes	注册时分配到的api key，该参数作为HTTP HEAD字段传递。
accessToken	String	Yes	身份认证通过后平台分配的临时token，作为操作对应广告账户的凭证，10小时有效。参数获取方式见接口clientLogin

Body 请求参数

字段	类型	必须	描述
startDate	date	Yes	起始时间，时间格式精确到小时（分、秒可传00:00）；当需要获取30天历史数据时，最大跨度为30天，不包括当天，startDate和endDate最大时间跨度为7天。例如今天是2017-05-23，起始时间最早可以传2017-05-16 00:00:00；当需要获取当天数据时，开始日期必须是当天。
endDate	date	Yes	截止时间，时间格式精确到小时（分、秒可传00:00）； startDate和endDate最大时间跨度为7天，建议按每次只取1天数据，结束时间最晚为前一天的23点，例如当前时间是2017-05-23 20:19:00，截止时间最晚可以传2017-05-22 23:00:00；当需要获取当天数据时，截止日期必须是当天；传入的日期只精确到小时，比如想获取2017-10-10 23点的数据，开始结束时间都传2017-10-10 23:00:00即可。
type	String	No	选择报告的投放端类型，允许为空或不包含该参数，若不带该参数默认为all。all表示查询全部投放端数据，mobile表示移动，computer表示计算机；该接口建议，不是用all，推荐使用分设备类型取数据
groupBy	String	Yes	报表数据粒度，account为账户搜索产品线汇总数据，campaign为推广计划汇总数据，keyword为关键词数据。
page	int	No	请求的页码，默认为1，一页固定为1000条数据

参数备注
1	type不传或type=all ，computer,mobile不会被聚合，如果在两种投放都展现则同一条物料为两条数据
2	该接口支持历史数据和当日实时数据查询，单需要分成不同请求进行查询
3	建议分日进行取数据 (既startDate=endDate,例如startDate=2019-02-20 00:00:00，endDate=2019-02-20 23:00:00为一整天)，如果取多天数据分为多次请求
4	建议按type=computer，type=mobile 分别取数据
5	支持最近查询历史30天数据，但是startDate和endDate跨度为7天，如果要获取更久的数据需要分为多次查询
6	每页数据1000条

请求示例

curl -X POST \
--header "apiKey:APIKEY" \
--header 'accessToken:ACCESSTOKEN' \
--data "startDate=2019-02-20 00:00:00&endDate=2019-02-20 23:00:00&type=all&groupBy=keyword&page=1" \
"https://api.e.360.cn/dianjing/report/hourList"

返回结果

{
  "hourList": [
    {
      "campaignId": 3317763963,
      "campaignName": "计划标题",
      "clicks": "0",
      "date": "2021-06-08",
      "groupId": 1674963977,
      "groupName": "组标题",
      "hour": "1",
      "keyword": "关键词",
      "keywordId": 14393242438,
      "totalCost": "0.00",
      "type": "mobile",
      "views": "1"
    }
  ]
}

返回结果说明

字段	类型	描述
date	string	日期
hour	string	小时，0-23
campaignId	string	推广计划ID，groupBy为campaign或keyword时返回该字段
campaignName	string	推广计划名称，groupBy为campaign或keyword时返回该字段
groupId	string	推广组ID，groupBy为keyword时返回该字段
groupName	string	推广组名称，groupBy为keyword时返回该字段
keywordId	string	关键词ID，groupBy为keyword时返回该字段
keyword	string	关键词，groupBy为keyword时返回该字段
views	string	展现
clicks	string	点击
totalCost	string	消费

results matching ""

No results matching ""