POST/api/keywords

添加关键词

向系统中批量添加新的关键词。系统将根据您设置的频率，自动在搜索引擎中寻路并监控该关键词在对应域名下的排名与点击曝光情况。

Body 参数 (JSON)

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

参数名	类型	必填	说明
`domain`	string	是	要监控的纯域名 (例如: `example.com`，不含协议或路径)。注：后端会自动清洗 URL（如将 `https://www.example.com/path` 自动剥离为纯域名 `example.com`）。
`keyword`	string	是	目标关键词。支持批量添加，多个关键词之间请使用换行符 `\n` 分隔。
`interval`	integer	否	监控频率 (分钟)。可选值: `2`, `5`, `10`, `30`, `60`, `360`, `1440`。默认值为 `10`。Free 账户最低允许频率为 30。
`search_engine`	string	否	指定目标搜索引擎（支持 `bing`, `baidu`）。默认值为 `bing`。

返回值字段说明

响应数据结构

success

布尔值。true 表示添加成功，false 表示添加失败。

msg

文本提示。成功时返回如 "成功添加 3 个关键词"，失败时返回具体的错误原因（如余额不足、频率无效等）。

业务规则限制

响应数据结构

全局唯一

一个域名全局只能被绑定到一个用户账户下。如果域名已被他人绑定，将返回 HTTP 403。

余额限制

当前账户可用余额必须大于 0.1 元方可提交新任务。

数量配额

域名与关键词数量限制：Free 账号最多只能添加 1 个域名，Pro 账号最多 100 个域名（随 VIP 等级提升），Ultra 账号支持最多 500 个域名；关键词数量规则：Free（基本版）账号单域名最多允许 10 个关键词（含停用）；Pro（专业版）账号基础配额为单域名 15 个关键词，随该域名点击率（CTR）上升可逐级解锁至 105 个，并叠加账号整体点击率阶梯乘数（最高 2.0 倍），单域名最高可动态解锁 210 个关键词容量；Ultra（旗舰版）账号单域名固定享有 500 个关键词容量，不受点击率与历史命中次数限制。

POST

curl -X POST "https://www.kuaipai.ai/api/keywords" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "domain": "example.com",
  "keyword": "apple\norange\nbanana",
  "interval": 30,
  "search_engine": "bing"
}'

成功响应 (200 OK)

{
  "success": true,
  "msg": "成功添加 3 个关键词"
}

失败响应示例 (400 Bad Request)

{
  "success": false,
  "msg": "无效的监控频率，允许的值为: 2, 5, 10, 30, 60, 360, 1440 分钟"
}