GET/api/kl_keywords

查询关键词列表

获取当前账户下的所有关键词列表。您可以通过此接口查看每个关键词的执行频率、当前状态 (启用/停用/欠费冻结) 以及成功匹配（点击）的统计数据。

Query 参数

参数名	类型	必填	说明
`domain`	string	否	指定过滤的域名。若不传，则返回所有域名的关键词任务。
`search_engine`	string	否	指定过滤的搜索引擎（支持 `bing`, `baidu`）。若不传，则返回所有引擎的任务。

返回值字段说明

响应数据结构

ID

关键词的唯一 ID，用于启停任务操作。

Keyword

关键词文本。

TargetDomain

目标域名。

Enabled

状态码：0 (已暂停)、1 (运行中)、2 (原已暂停，因欠费冻结)、3 (原运行中，因欠费冻结)。

CurrentRank

最后一次记录的排名。

IntervalMins

设定的监控执行频率 (分钟)。

SearchCount

历史累计搜索次数。

MatchCount

该关键词历史累计成功模拟点击的次数。

LastCheckTime

该关键词最近一次系统巡查排名的记录时间。

SearchEngine

该关键词生效的搜索引擎（默认 bing）。

Source

关键词来源标识。常见的值及其映射关系如下：

user 或空值：用户手动添加
ai：人工智能 (AI) 推荐生成
ai_agent：AI Agent 全托管自动扩充
admin：由技术专家为0命中的网站增加的关键词，以解决用户难题，默认间隔设置为1小时。

KeywordType

关键词的业务分类标签。主要由人工智能客服在分析入库时自动识别写入，也支持自行设置。如果该字段为空，前端系统会默认展示为 普通词。常见的打标类型有：

普通词：未指定特殊分类的词（默认兜底值）
核心词：代表业务核心竞争力的主关键词
长尾词：搜索量相对较低但转化意图更精准的扩展词
标题词：从网站标题中提取的关键词，搜索命中率极高。
启动词：用于新网站或者排名较差网站提升权重的词。通常为 关键词 + 空格 + 域名 的形式

NextAvailableAt

下一次允许调度执行的时间。

TaskStatus

底层调度引擎反馈的实时任务状态。常见的值及其判断逻辑如下：

idle：空闲状态。建议结合 NextAvailableAt 字段进行逻辑判断：若当前时间未到下次调度时间，表示任务处于冷却中；若当前时间已过下次调度时间或为空，表示任务正处于等待下发的排队中。
in_use：执行中。系统正在执行寻路、查询或点击操作，单次执行时间预估为 1-15 分钟。
probing：低频探针状态。当系统连续 30 次搜索未能找到目标网站时，会自动降级为探针模式。在探针模式下，只要能成功命中 1 次网站，即可自动结束探针并恢复正常执行频率。

注：在判断最终业务状态时，拥有最高优先级的是 Enabled 字段。若 Enabled 为 0 则覆盖判定为停用；若 Enabled ≥ 2 则覆盖判定为 欠费冻结。

CreatedAt

该关键词任务的创建时间。

MaxKeywords

仅当请求带有 domain 参数时有意义。表示当前用户在此域名下能够添加的关键词总数上限（受会员等级及点击率阶梯影响）。若不传域名则返回 0。

GET

curl -X GET "https://www.fashionbashusa.com/api/kl_keywords?domain=example.com" \
     -H "Authorization: Bearer YOUR_API_KEY"

成功响应 (200 OK)

{
  "success": true,
  "data": {
    "KLKeywords": [
      {
        "ID": 1234,
        "Keyword": "apple",
        "TargetDomain": "example.com",
        "Enabled": 1,
        "CurrentRank": 5,
        "IntervalMins": 30,
        "SearchCount": 150,
        "MatchCount": 45,
        "LastCheckTime": "2023-10-25 10:30:00",
        "SearchEngine": "bing",
        "CreatedAt": "2023-10-01 08:00:00",
        "Source": "user",
        "KeywordType": "",
        "NextAvailableAt": "2023-10-25 11:00:00",
        "TaskStatus": "idle"
      }
    ],
    "MaxKeywords": 15
  }
}