关键词推荐-量身推词&以词推词-提交任务
此接口用来获取量身推词&以词推词。
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/tool/addKrByKeywordsTask
| 字段 |
类型 |
必须 |
描述 |
| apiKey |
String |
Yes |
注册时分配到的api key，该参数作为HTTP HEAD字段传递。 |
| accessToken |
String |
Yes |
身份认证通过后平台分配的临时token，作为操作对应广告账户的凭证，10小时有效。参数获取方式见接口clientLogin。 |
Body请求参数
| 字段 |
类型 |
必须 |
描述 |
| type |
int |
Y |
类型，1：以词推词，2：量身推词 |
| groupIds |
json |
N |
仅当type=2时有效，推广组id列表，json数组，如果为空，则按照账户推词，最大100个组，例如:[12345,34563] |
| query |
josn |
N |
仅当type=1时有效且必填，最长100个关键词，每个词最多40个字符，或20个汉字，例如:["汽车","鲜花"] |
| reason |
json |
N |
推荐理由,默认全部, 1：移动好词，2：黑马词，3：热搜词，4：转化好词，5：同行买词，6：咨询词，7：价格词，8：周末热词，9：夜间好词，例如：[1,2,3,4,5] |
| inWord |
string |
N |
包含关键词，只能填写一个，最多40个字符，或20个汉字，例如:汽车 |
| filterWord |
string |
N |
过滤关键词（不包含），只能填写一个，最多40个字符，或20个汉字，例如:鲜花 |
| bFilter |
int |
N |
是否过滤已购词，1：是，0：不过滤 |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'type=1&query=["鲜花","汽车","水果"]&reason=[1,2,3]&inWord=汽车&filterWord=鲜花' \
'https://api.e.360.cn/dianjing/tool/addKrByKeywordsTask'
正常返回结果
{
"failed_gids": [
2212323
],
"fileId": "cji5nt7evr6sn030cr1g"
}
返回结果说明
| 字段 |
类型 |
描述 |
| failed_gids |
json |
量身推词带推广组的情况下，该字段返回无效的推广组 |
| fileId |
String |
任务唯一标识，以此任务获取状态和数据下载 |