关键词报告总数
获取实时关键词报告总数。由于数据来源不同,本接口的当天数据和7天历史数据不能同时获取;历史数据最晚可以获取到前一天的23时,当天数据最晚可以获取到上一个小时,具体请参照参数说明。由于报表需要时间生成,如需获取上一个小时的数据,建议延迟15分钟获取。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/report/hourListCount
字段 |
类型 |
必须 |
描述 |
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 |
页数 |