Keyword Difficulty (KD) API
按关键词查询关键词难度和标准化 SERP 搜索结果。
接口
GET https://api.goanyapi.com/api/v1/keyword-difficulty当前配置下，每次成功请求消耗 3 积分。
鉴权
Authorization: Bearer YOUR_API_KEY请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | string | 是 | 目标关键词，最长 200 个字符，例如 ai |
country | string | 否 | 两位国家代码，默认值为 us |
请求示例
GET /api/v1/keyword-difficulty?keyword=ai&country=us
Authorization: Bearer YOUR_API_KEY响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "keyword-difficulty",
"remainingCredits": 97,
"query": {
"keyword": "ai",
"country": "us"
},
"keyword": "ai",
"country": "us",
"difficulty": 95,
"shortage": 1391,
"lastUpdate": "2026-08-09 05:00:20",
"source": "Serps",
"serp": {
"source": "Serps",
"results": [
{
"type": "organic",
"position": 1,
"positionWithMetrics": 1,
"title": "Artificial intelligence",
"url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
"displayUrl": "https://en.wikipedia.org wiki Artificial_intelligence",
"metrics": {
"rank": 15,
"domainRating": 97,
"urlRating": 37,
"traffic": 583603,
"keywords": 946,
"topKeyword": "artificial intelligence",
"topVolume": 740000,
"httpCode": 200
},
"siteLinks": []
},
{
"type": "questions",
"position": 3,
"questions": [
{
"title": "Which AI is free to use?"
}
]
}
]
}
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 固定值：keyword-difficulty |
data.costCredits | 本次请求消耗的积分：3 |
data.remainingCredits | 扣费后的剩余积分 |
data.keyword | 标准化后的查询关键词 |
data.country | 服务商返回的搜索国家 |
data.difficulty | Keyword Difficulty（KD）分数 |
data.shortage | 服务商返回的 shortage 数值 |
data.lastUpdate | 服务商数据更新时间 |
data.source | 数据来源 |
data.serp.results | 标准化后的 SERP 结果 |
data.serp.results[].type | organic、ai_overview、questions 或其他类型 |
自然搜索结果可能包含位置、标题、URL、展示 URL、站点链接和 SEO 指标。AI Overview 结果可能包含摘要及引用链接，问题结果包含标准化后的问题标题和可选链接。
公开响应会移除服务商 URL 签名、内部 URL 输入对象和标签元组。
计费
当前请求价格以本页显示的 API 配置为准。
- 只有请求成功且业务
code为0时才扣积分 - 请求失败不消耗积分