Keyword Difficulty (KD) API
按关键词查询关键词难度和标准化 SERP 搜索结果。
使用场景和在线测试请看关键词难度 API 产品页。本文集中说明请求输入、结果字段和计费。
关键词难度 API 产品页 →
接口
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",
"serp": {
"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 | 按当前接口配置扣除的积分 |
data.remainingCredits | 扣费后的剩余积分 |
data.keyword | 标准化后的查询关键词 |
data.country | 本次结果对应的搜索国家 |
data.difficulty | Keyword Difficulty（KD）分数 |
data.shortage | 响应中的 shortage 数值 |
data.lastUpdate | 响应中的数据更新时间 |
data.serp.results | 标准化后的 SERP 结果 |
data.serp.results[].type | organic、ai_overview、questions 或其他类型 |
自然搜索结果可能包含位置、标题、URL、展示 URL、站点链接和 SEO 指标。AI Overview 结果可能包含摘要及引用链接，问题结果包含标准化后的问题标题和可选链接。
计费
当前请求价格以本页显示的 API 配置为准。
- 仅成功且有非空结果时扣除积分
- 请求失败不消耗积分