API Documentation

Authentication

All API requests require an Agency plan and a valid API key. Include the key as a Bearer token in the Authorization header:

Authorization: Bearer kwdens_your_api_key_here

Generate API keys from your Account page. Keys are shown once on creation. Store them securely.

Rate Limits

API requests count against your Agency plan's monthly query quota (1,500 queries/month). Each API call consumes one query.

When the limit is exceeded, requests return 429 Too Many Requests with details about your usage.

Error Responses

Analyze variant density for a keyword. Returns estimated volume distribution across close keyword variants using Google Ads + Trends data.

{
  "keyword": "project management software",
  "baseLanguage": "en"
}

{
  "keyword": "project management software",
  "variants": [
    {
      "variant": "project management software",
      "groupedVolume": 12100,
      "estimatedVolume": 5800,
      "densityPercent": 48,
      "confidence": "High",
      "kwdensScore": 72,
      "trend3m": 5.2,
      "trend12m": 12.1
    }
  ],
  "hasMoreVariants": false
}

curl -X POST https://kwdens.com/api/v1/density/variants \
  -H "Authorization: Bearer kwdens_your_key" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"project management software","baseLanguage":"en"}'

Analyze geographic density for a keyword. Returns search volume, CPC, and competition by country.

{
  "keyword": "project management software",
  "countries": ["US", "GB", "DE", "FR", "IN", "BR", "JP"]
}

{
  "keyword": "project management software",
  "countries": [
    {
      "country": "United States",
      "countryCode": "US",
      "volume": 33100,
      "cpc": 14.50,
      "competition": "High",
      "trend": 3.2,
      "kwdensScore": 65
    }
  ],
  "hasMoreCountries": false
}

curl -X POST https://kwdens.com/api/v1/density/geographic \
  -H "Authorization: Bearer kwdens_your_key" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"project management software","countries":["US","GB","DE"]}'

Analyze cross-language density. Returns semantic equivalents of your keyword in other languages with volume data.

{
  "keyword": "project management software",
  "baseLanguage": "en",
  "targetLanguages": ["es", "de", "fr", "pt", "ja"]
}

{
  "keyword": "project management software",
  "baseLanguage": "en",
  "equivalents": [
    {
      "language": "Spanish",
      "languageCode": "es",
      "equivalent": "software de gestion de proyectos",
      "country": "Spain",
      "countryCode": "ES",
      "volume": 8100,
      "cpc": 3.20,
      "competition": "Medium",
      "trend": 8.5,
      "kwdensScore": 68,
      "isOpportunity": true
    }
  ],
  "hasMoreLanguages": false
}

curl -X POST https://kwdens.com/api/v1/density/languages \
  -H "Authorization: Bearer kwdens_your_key" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"project management software","baseLanguage":"en","targetLanguages":["es","de","fr"]}'