关键词分小时分设备实时排名数据报告列表


本接口仅支持获取昨日、今日两天的数据,单次请求不能跨天获取数据,最晚可以获取到上一个小时,具体请参照参数说明; 由于报表需要时间生成,如需获取上一个小时的数据,建议延迟15分钟获取;

HTTP请求方式

POST

请求地址

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

Headers 请求参数

字段 类型 是否必须 描述
apiKey String Yes 注册时分配的apiKey。
accessToken String Yes 身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。

Body 请求参数

字段 类型 是否必须 描述
startDate String Yes 起始时间,时间格式精确到小时(分、秒可传00:00)。当需要获取前日数据时(例如今天是2017-05-23),起始时间最早可以传2017-05-22 00:00:00;当需要获取当天数据时,开始日期必须是当天。
endDate String Yes 截止时间,时间格式精确到小时(分、秒可传00:00);若截止时间为当天,起始时间也必须为当天。
type String No 选择报告的投放端类型,允许为空或不包含该参数,若不带该参数默认为all,表示查询全部投放端数据(会汇总在一起),mobile表示移动数据,computer表示PC数据
page String No 请求的页码,一页固定为1000条数据。缺省值:1

请求示例

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&page=1" \
"https://api.e.360.cn/dianjing/report/hourRankList"

返回结果

{
    "hourRankList": [{
            "date": "2019-02-20",
            "hour": 10,
            "rank": 7.2,
            "clicks": 1,
            "views": 11,
            "totalCost": "1.11",
            "campaignId": 3552730049,
            "campaignName": "",
            "groupId": 381979510,
            "groupName": "",
            "keywordId": 388391750,
            "keyword": "技校都有什么专业",
            "type": "computer"
        },
        {
            "date": "2019-02-20",
            "hour": 10,
            "rank": 7,
            "clicks": 1,
            "views": 8,
            "totalCost": "1.11",
            "campaignId": 667026575,
            "campaignName": "",
            "groupId": 1523401582,
            "groupName": "",
            "keywordId": 4884085946,
            "keyword": "新手学电脑打字",
            "type": "computer"
        },
        {
            "date": "2019-02-20",
            "hour": 10,
            "rank": 6.8,
            "clicks": 0,
            "views": 10,
            "totalCost": "1.11",
            "campaignId": 3485616312,
            "campaignName": "",
            "groupId": 466649352,
            "groupName": "",
            "keywordId": 9687501181,
            "keyword": "it培训",
            "type": "mobile"
        }
    ]
}

返回结果说明

字段 类型 描述
date String 日期
hour String 小时
rank String 关键词排名,保留1位小数
views String 关键词展现量
clicks String 关键词点击量
totalCost String 关键词消费金额
campaignId String 广告计划ID
campaignName String 广告计划
groupId String 广告组ID
groupName String 广告组
keywordId String 关键词ID
keyword String 关键词
type String 投放端类型:mobile表示移动,computer表示PC

results matching ""

    No results matching ""