Keyword Suggestions API
Get paginated keyword suggestions before querying exact search volumes.
Endpoint
GET https://api.goanyapi.com/api/v1/keyword-suggestionsWith the current configuration, each successful request costs 1 credit.
Use this API first to discover candidate keywords. Select an exact keyword from the returned suggestions, then pass it to the Keyword Search Volume API to retrieve its monthly search-volume history.
Authentication
Authorization: Bearer YOUR_API_KEYRequest Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Keyword fragment, from 1 to 200 characters |
page | integer | No | Zero-based page from 0 to 100000; defaults to 0 |
Additional query parameters are rejected.
Example
GET /api/v1/keyword-suggestions?keyword=ai&page=0
Authorization: Bearer YOUR_API_KEYResponse Example
{
"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"
]
}
}Response Fields
| Field | Description |
|---|---|
data.endpoint | Fixed value: keyword-suggestions |
data.costCredits | Credits consumed by this request |
data.remainingCredits | Credits remaining after this request |
data.query.keyword | Normalized keyword fragment |
data.query.page | Normalized zero-based request page |
data.page | Current zero-based response page |
data.size | Number of suggestions returned on this page |
data.total | Total number of matching suggestions |
data.totalPages | Total number of available pages |
data.hasNext | Whether another suggestions page is available |
data.keywords | Ordered list of matching keyword strings |
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