Keyword Search Volume API
Query monthly search-volume history for an exact keyword.
Endpoint
GET https://api.goanyapi.com/api/v1/keyword-search-volumeWith 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.
- Call
GET /api/v1/keyword-suggestions?keyword=ai&page=0. - Select an exact value from
data.keywords, such asai image. - Call
GET /api/v1/keyword-search-volume?keyword=ai%20image.
Authentication
Authorization: Bearer YOUR_API_KEYRequest Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Exact 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_KEYThen select one returned suggestion and query its monthly search volume:
GET /api/v1/keyword-search-volume?keyword=ai%20image
Authorization: Bearer YOUR_API_KEYResponse 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
| Field | Description |
|---|---|
data.endpoint | Fixed value: keyword-search-volume |
data.costCredits | Credits consumed by this request |
data.remainingCredits | Credits remaining after this request |
data.query.keyword | Normalized request keyword |
data.keyword | Exact keyword represented by the result |
data.monthlyVolumes | Ordered monthly search-volume records |
data.monthlyVolumes[].month | Month in YYYY-MM format |
data.monthlyVolumes[].volume | Search 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