API Documentation

Keyword Search Volume API

Query monthly search-volume history for an exact keyword.

Test API

Endpoint

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

With the current configuration, each successful request costs 3 credits.

Required Workflow: Get Suggestions First

The Keyword Suggestions API is the required prerequisite for the Keyword Search Volume API. Use it to retrieve paginated candidate keywords, select the exact suggestion you want to measure, and then pass that value as this API's keyword parameter.

  1. Call GET /api/v1/keyword-suggestions?keyword=ai&page=0.
  2. Select an exact value from data.keywords, such as ai image.
  3. Call GET /api/v1/keyword-search-volume?keyword=ai%20image.

Authentication

Authorization: Bearer YOUR_API_KEY

Request Parameters

ParameterTypeRequiredDescription
keywordstringYesExact keyword, from 1 to 200 characters

Additional query parameters are rejected.

Two-step Example

First, get a page of keyword suggestions:

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

Then select one returned suggestion and query its monthly search volume:

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

Response Example

{
  "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 }
    ]
  }
}

Response Fields

FieldDescription
data.endpointFixed value: keyword-search-volume
data.costCreditsCredits consumed by this request
data.remainingCreditsCredits remaining after this request
data.query.keywordNormalized request keyword
data.keywordExact keyword represented by the result
data.monthlyVolumesOrdered monthly search-volume records
data.monthlyVolumes[].monthMonth in YYYY-MM format
data.monthlyVolumes[].volumeSearch volume for the corresponding month

Billing

The current request cost follows the API configuration shown on this page.

  • Credits are deducted only after a valid successful response
  • Failed requests do not consume credits