API Documentation

Keyword Suggestions API

Get paginated keyword suggestions before querying exact search volumes.

Test API

Endpoint

GET https://api.goanyapi.com/api/v1/keyword-suggestions

With 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_KEY

Request Parameters

ParameterTypeRequiredDescription
keywordstringYesKeyword fragment, from 1 to 200 characters
pageintegerNoZero-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_KEY

Response 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

FieldDescription
data.endpointFixed value: keyword-suggestions
data.costCreditsCredits consumed by this request
data.remainingCreditsCredits remaining after this request
data.query.keywordNormalized keyword fragment
data.query.pageNormalized zero-based request page
data.pageCurrent zero-based response page
data.sizeNumber of suggestions returned on this page
data.totalTotal number of matching suggestions
data.totalPagesTotal number of available pages
data.hasNextWhether another suggestions page is available
data.keywordsOrdered 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