Keyword Difficulty (KD) API Documentation

See the Keyword Difficulty API product page for competition research use cases and an interactive test. This reference covers request inputs, result fields and billing.

Keyword Difficulty API product page →

Endpoint

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

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

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

Authentication

Authorization: Bearer YOUR_API_KEY

Request Parameters

Parameter	Type	Required	Description
`keyword`	string	Yes	Target keyword, up to 200 characters, e.g. `ai`
`country`	string	No	Two-letter country code. Defaults to `us`

Example

GET /api/v1/keyword-difficulty?keyword=ai&country=us
Authorization: Bearer YOUR_API_KEY

Response Example

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "keyword-difficulty",
    "remainingCredits": 97,
    "query": {
      "keyword": "ai",
      "country": "us"
    },
    "keyword": "ai",
    "country": "us",
    "difficulty": 95,
    "shortage": 1391,
    "lastUpdate": "2026-08-09 05:00:20",
    "serp": {
      "results": [
        {
          "type": "organic",
          "position": 1,
          "positionWithMetrics": 1,
          "title": "Artificial intelligence",
          "url": "https://en.wikipedia.org/wiki/Artificial_intelligence",
          "displayUrl": "https://en.wikipedia.org  wiki  Artificial_intelligence",
          "metrics": {
            "rank": 15,
            "domainRating": 97,
            "urlRating": 37,
            "traffic": 583603,
            "keywords": 946,
            "topKeyword": "artificial intelligence",
            "topVolume": 740000,
            "httpCode": 200
          },
          "siteLinks": []
        },
        {
          "type": "questions",
          "position": 3,
          "questions": [
            {
              "title": "Which AI is free to use?"
            }
          ]
        }
      ]
    }
  }
}

Response Fields

Field	Description
`data.endpoint`	Fixed value: `keyword-difficulty`
`data.costCredits`	Credits consumed under the current API configuration
`data.remainingCredits`	Remaining credits after deduction
`data.keyword`	Normalized queried keyword
`data.country`	Search country included in the result
`data.difficulty`	Keyword Difficulty (KD) score
`data.shortage`	Shortage value included in the result
`data.lastUpdate`	Data update time
`data.serp.results`	Normalized SERP entries
`data.serp.results[].type`	`organic`, `ai_overview`, `questions`, or another result type

Organic entries may include position, title, URL, display URL, site links, and SEO metrics. AI Overview entries may include description and cited links. Question entries contain normalized question titles and optional links.

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

Keyword Difficulty (KD) API

On this page