POST/api/keywords/batch/delete

批量删除关键词

通过传入关键词 ID 数组，一次性永久删除多个关键词任务。删除后相关关键词将立即停止调度，且不会影响所属域名记录及历史消费账单。

Body 参数 (JSON)

此接口要求使用 application/json 格式提交数据。

参数名	类型	必填	说明
`ids`	array[integer]	是	需要批量删除的关键词唯一 ID 数组（如 `[1234, 1235, 1236]`）。

返回值字段说明

响应数据结构

success

布尔值。true 表示操作执行完毕。

msg

文本提示，返回实际成功删除的关键词数量（如 "成功删除 3 个关键词"）。

业务规则说明

响应数据结构

幂等与权限过滤

若传入的 ids 中包含已删除、不存在或不属于当前账户的关键词 ID，系统会自动忽略这些无效项，仅删除属于当前账户的关键词。

域名保留机制

即使某个域名下的所有关键词均被批量删除，该域名本身及其历史统计数据仍会保留。如需批量删除域名，请调用「批量删除域名」接口。

POST

curl -X POST "https://www.kuaipai.ai/api/keywords/batch/delete" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "ids": [1234, 1235, 1236]
}'

成功响应 (200 OK)

{
  "success": true,
  "msg": "成功删除 3 个关键词"
}