关键词报告总数


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

HTTP请求方式

POST

请求地址

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

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为关键词数据。
参数备注
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 10:00:00&endDate=2019-02-20 11:00:00&type=all&groupBy=keyword" \
"https://api.e.360.cn/dianjing/report/hourListCount"
返回结果
{
  "totalNumber": 150,
  "totalPage": 1
}
返回结果说明
字段 类型 描述
totalNumber Int 报告总数
totalPage Int 页数

results matching ""

    No results matching ""