Keyword Search Volume API 文档

接口地址

GET https://api.goanyapi.com/api/v1/keyword-search-volume

GET https://api.goanyapi.com/api/v1/keyword-search-volume

当前配置下，每次成功请求消耗 3 积分。

必要流程：先获取关键词建议

Keyword Suggestions API 是 Keyword Search Volume API 的前置接口。请先分页获取候选建议词，从 data.keywords 中选择需要衡量的精确关键词，再将该值作为本接口的 keyword 参数。

调用 GET /api/v1/keyword-suggestions?keyword=ai&page=0。
从 data.keywords 中选择精确建议词，例如 ai image。
调用 GET /api/v1/keyword-search-volume?keyword=ai%20image。

鉴权

Authorization: Bearer YOUR_API_KEY

请求参数

参数	类型	必填	说明
`keyword`	string	是	精确关键词，长度为 1 至 200 个字符

接口会拒绝未声明的查询参数。

两步请求示例

第一步，分页获取关键词建议：

GET /api/v1/keyword-suggestions?keyword=ai&page=0
Authorization: Bearer YOUR_API_KEY

第二步，选择一个返回的建议词并查询其月度搜索量：

GET /api/v1/keyword-search-volume?keyword=ai%20image
Authorization: Bearer YOUR_API_KEY

响应示例

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "keyword-search-volume",
    "remainingCredits": 97,
    "query": {
      "keyword": "ai image"
    },
    "keyword": "ai image",
    "monthlyVolumes": [
      { "month": "2026-07", "volume": 58960 },
      { "month": "2026-06", "volume": 49700 },
      { "month": "2026-05", "volume": 58050 }
    ]
  }
}

响应字段

字段	说明
`data.endpoint`	固定值：`keyword-search-volume`
`data.costCredits`	本次请求消耗的积分
`data.remainingCredits`	本次请求后剩余的积分
`data.query.keyword`	规范化后的请求关键词
`data.keyword`	结果对应的精确关键词
`data.monthlyVolumes`	有序的月度搜索量记录
`data.monthlyVolumes[].month`	`YYYY-MM` 格式的月份
`data.monthlyVolumes[].volume`	对应月份的搜索量

计费

当前请求价格以本页显示的 API 配置为准。

仅在获得有效成功响应后扣除积分
请求失败不扣积分

Keyword Search Volume API