关键词查询接口

根据关键词名称查询SEO关键词的详细信息，包括搜索量、难度、CPC、竞争度等数据。支持精确查询和模糊查询两种模式。

POST /api/admin/seo-ranking/keyword-search

🔑API Key 获取

在使用API接口之前，您需要先获取API Key。请前往管理后台生成您的API Key。

前往获取API Key→

身份验证

所有API请求都需要在请求头中包含API Key进行身份验证。

请求头格式：

X-API-Key: your_api_key_here

请求头

Content-Type: application/json
X-API-Key: your_api_key_here

请求参数

{
  "keyword": "关键词名称",
  "searchMode": "exact",
  "limit": 50
}

keywordstring (必填) - 要查询的关键词名称

searchModestring (可选) - 查询模式，可选值："exact"（精确查询，默认）或 "fuzzy"（模糊查询）

limitnumber (可选) - 返回记录数量限制，仅对模糊查询有效。默认50条，最大100条

查询模式说明：

exact：精确匹配，返回完全匹配关键词名称的单条记录（默认模式）
fuzzy：模糊匹配，返回包含关键词的多条记录，按搜索量降序排列，默认返回50条，最多100条

响应示例

精确查询响应（单条记录）：

{
  "success": true,
  "data": {
    "id": 1,
    "keyword": "example keyword",
    "searchVolume": 1000,
    "keywordDifficulty": 45,
    "cpc": 1.5,
    "competition": 0.75,
    "numberOfResults": "1000000",
    "trendScore": 85,
    "commercialScore": 90,
    "overallScore": 88,
    "kws": 12,
    "language": "en"
  }
}

模糊查询响应（多条记录）：

{
  "success": true,
  "data": [
    {
      "id": 1,
      "keyword": "white screen error",
      "searchVolume": 5000,
      "keywordDifficulty": 45,
      "cpc": 1.5,
      "competition": 0.75,
      "numberOfResults": "1000000",
      "trendScore": 85,
      "commercialScore": 90,
      "overallScore": 88,
      "kws": 12,
      "language": "en"
    }
  ],
  "count": 2
}

响应字段说明

字段	类型	说明
keyword	string	关键词名称
searchVolume	number	搜索量
keywordDifficulty	number	关键词难度
cpc	number	每次点击成本
competition	number	竞争度
trendScore	number	趋势分数
commercialScore	number	商业价值分数
overallScore	number	综合分数
language	string	语言代码

错误响应

401 - 认证失败

{
  "error": "认证失败"
}

400 - 参数错误

{
  "success": false,
  "error": "缺少关键词参数"
}

404 - 未找到

{
  "success": false,
  "error": "未找到该关键词"
}

代码示例

cURL - 精确查询

curl -X POST https://youzikuaibao.com.cn/api/admin/seo-ranking/keyword-search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key_here" \
  -d '{"keyword": "example keyword", "searchMode": "exact"}'

Python

import requests

url = "https://youzikuaibao.com.cn/api/admin/seo-ranking/keyword-search"
headers = {
    "Content-Type": "application/json",
    "X-API-Key": "your_api_key_here"
}
data = {
    "keyword": "example keyword",
    "searchMode": "exact"
}

response = requests.post(url, json=data, headers=headers)
result = response.json()
print(result)

JavaScript (fetch)

fetch('https://youzikuaibao.com.cn/api/admin/seo-ranking/keyword-search', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': 'your_api_key_here'
  },
  body: JSON.stringify({
    keyword: 'example keyword',
    searchMode: 'exact'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));