Keyword Suggestions API
分页获取关键词建议，并在查询精确搜索量前确定目标关键词。
接口地址
GET https://api.goanyapi.com/api/v1/keyword-suggestions当前配置下，每次成功请求消耗 1 积分。
请先调用此接口发现候选关键词，从返回的建议词中选择一个精确关键词，再将它传给 Keyword Search Volume API 查询月度搜索量历史。
鉴权
Authorization: Bearer YOUR_API_KEY请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
keyword | string | 是 | 关键词片段，长度为 1 至 200 个字符 |
page | integer | 否 | 从 0 开始的页码，范围 0 至 100000，默认 0 |
接口会拒绝未声明的查询参数。
请求示例
GET /api/v1/keyword-suggestions?keyword=ai&page=0
Authorization: Bearer YOUR_API_KEY响应示例
{
"code": "ok",
"message": "ok",
"data": {
"endpoint": "keyword-suggestions",
"remainingCredits": 99,
"query": {
"keyword": "ai",
"page": "0"
},
"page": 0,
"size": 10,
"total": 12923,
"totalPages": 1293,
"hasNext": true,
"keywords": [
"ai image",
"ai image generator",
"ai image detector",
"ai image editor"
]
}
}响应字段
| 字段 | 说明 |
|---|---|
data.endpoint | 固定值：keyword-suggestions |
data.costCredits | 本次请求消耗的积分 |
data.remainingCredits | 本次请求后剩余的积分 |
data.query.keyword | 规范化后的关键词片段 |
data.query.page | 规范化后的从 0 开始页码 |
data.page | 当前响应页码 |
data.size | 当前页返回的建议词数量 |
data.total | 匹配建议词总数 |
data.totalPages | 总页数 |
data.hasNext | 是否还有下一页 |
data.keywords | 有序的匹配关键词字符串列表 |
计费
当前请求价格以本页显示的 API 配置为准。
- 仅在获得有效成功响应后扣除积分
- 请求失败不扣积分