API Documentation

Keyword Generator API

Generate related and question-based keyword ideas by seed keyword and country.

Test API

See the Keyword Generator API product page for discovery use cases and an interactive test. This reference covers the seed and country inputs, idea fields and billing.

Keyword Generator API product page →

Endpoint

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

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

Authentication

Authorization: Bearer YOUR_API_KEY

Request Parameters

ParameterTypeRequiredDescription
keywordstringYesSeed keyword, up to 200 characters
countrystringNoTwo-letter country code. Defaults to us

Example

GET /api/v1/keyword-generator?keyword=ai%20image&country=us
Authorization: Bearer YOUR_API_KEY

Response Example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "keyword-generator",
    "remainingCredits": 97,
    "query": {
      "keyword": "ai image",
      "country": "us"
    },
    "keyword": "ai image",
    "country": "us",
    "searchEngine": "Google",
    "withQuestionIdeas": true,
    "allIdeasTotal": 101963,
    "allIdeas": [
      {
        "country": "us",
        "difficultyLabel": "Hard",
        "keyword": "ai image generator",
        "rankOrder": 0,
        "updatedAt": "2026-08-06 23:52:31",
        "volumeLabel": "MoreThanHundredThousand"
      }
    ],
    "questionIdeasTotal": 7920,
    "questionIdeas": [
      {
        "country": "us",
        "difficultyLabel": "Hard",
        "keyword": "is this image ai",
        "rankOrder": 0,
        "updatedAt": "2026-08-07 14:23:04",
        "volumeLabel": "MoreThanOneThousand"
      }
    ]
  }
}

Response Fields

FieldDescription
data.allIdeasRanked related keyword ideas
data.allIdeasTotalTotal number of available related ideas
data.questionIdeasRanked question-based keyword ideas
data.questionIdeasTotalTotal number of available question ideas
data.allIdeas[].keywordRelated keyword
data.questionIdeas[].keywordQuestion-shaped keyword
data.allIdeas[].difficultyLabelDifficulty range for a related idea
data.questionIdeas[].difficultyLabelDifficulty range for a question idea
data.allIdeas[].volumeLabelVolume range for a related idea
data.questionIdeas[].volumeLabelVolume range for a question idea
data.allIdeas[].updatedAtUpdate time or null
data.questionIdeas[].updatedAtUpdate time or null

Billing

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

  • Credits are deducted only after a successful non-empty result
  • Failed requests do not consume credits