搜索词报告列表
获取实时搜索词报告。接口分为实时数据接口和结算数据接口。通过实时数据接口可以获取相应层级的实时数据,可以不考虑延迟,但是数据没有经过反作弊清洗,不能作为结算数据。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/report/querywordNow
| 字段 |
类型 |
必须 |
描述 |
| apiKey |
String |
Yes |
注册时分配到的api key,该参数作为HTTP HEAD字段传递。 |
| accessToken |
String |
Yes |
身份认证通过后平台分配的临时token,作为操作对应广告账户的凭证,10小时有效。参数获取方式见接口clientLogin |
Body 请求参数
| 字段 |
类型 |
必须 |
描述 |
| type |
String |
No |
选择关键词报告的投放端类型,mobile表示移动,computer表示计算机,如果不传默认将获取到PC数据 |
| page |
int |
No |
返回结果的页码,默认为1。(每页1000条记录) |
| 参数备注 |
|
| 1 |
此接口必须按 type=computer,type=mobile 分别取数据,默认为computer |
| 2 |
每页数据1000条 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'type=computer&page=1' \
'https://api.e.360.cn/dianjing/report/querywordNow'
返回结果
{
"querywordList": [
{
"campaignId": 616649213,
"campaignName": "计划名称",
"clicks": "0",
"creativeId": 6459800769,
"creativeName": "创意标题",
"date": "2021-06-01",
"groupId": 1407772156,
"groupName": "组名称",
"keyword": "关键词",
"queryword": "搜索词",
"totalCost": "0.00",
"triggerType": "普通短语",
"views": "4",
"converts": "1",
"convertsCost": "425.23",
"ocpcRemarkName": "表单提交"
}
]
}
返回结果说明
| 字段 |
类型 |
描述 |
| queryword |
string |
搜索词 |
| keyword |
string |
关键词 |
| triggerType |
string |
触发模式 |
| campaignId |
string |
推广计划ID |
| campaignName |
string |
推广计划名称 |
| groupId |
string |
推广组ID |
| groupName |
string |
推广组名称 |
| creativeId |
string |
创意ID |
| creativeName |
string |
创意名称 |
| views |
string |
展现 |
| clicks |
string |
点击 |
| totalCost |
string |
消费 |
| converts |
string |
转化数,仅当type!=all时,才有此字段 |
| convertsCost |
string |
实际转化成本,仅当type!=all时,才有此字段 |
| ocpcRemarkName |
string |
转化类型,仅当type!=all时,才有此字段 |