Keyword Research API endpoint

POST /v1/keywordsAbout Keyword Research

Search volume, CPC, competition and optional related ideas for one seed keyword. Billed once per call by outcome, not per model, from the same balance.

Overview

Monthly search volume, CPC, competition, and (with ideas: true) LLM-curated related keyword ideas for a seed term. This is a classic-SEO data tool, not a multi-model AI-search fan-out, so it is billed once per call, by outcome rather than per model.

Reference

POST/v1/keywords

$0.03 to $0.12 · by outcome: $0.03 for zero or unavailable volume, $0.09 for positive volume, and $0.12 with related ideas.

Parameters

seedstringrequired

Seed keyword to fetch search volume, CPC, and competition for.

countrystringoptional

ISO-2 country code for localized metrics. Defaults to "us". Default: "us".

languagestringoptional

Optional ISO-2 language code. Defaults to the country's primary search language, so country "de" searches in German. Only multilingual markets accept an override: us (en, es), ca (en, fr), in (en, hi). Every other country has a single search language and rejects anything else.

ideasbooleanoptional

Leave false for volume, CPC, and competition on the seed only. Set true only when related, alternative, or long-tail keyword ideas are requested. Default: false.

Parameter	Type	Description
seedrequired	string	Seed keyword to fetch search volume, CPC, and competition for.
countryoptional	string	ISO-2 country code for localized metrics. Defaults to "us". Default: "us".
languageoptional	string	Optional ISO-2 language code. Defaults to the country's primary search language, so country "de" searches in German. Only multilingual markets accept an override: us (en, es), ca (en, fr), in (en, hi). Every other country has a single search language and rejects anything else.
ideasoptional	boolean	Leave false for volume, CPC, and competition on the seed only. Set true only when related, alternative, or long-tail keyword ideas are requested. Default: false.

Request

curl https://www.cite42.dev/api/v1/keywords \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed":"AI-powered CRM","ideas":true}'

Response

{
  "requestedKeyword": "AI-powered CRM",
  "keyword": "AI-powered CRM",
  "status": "exact",
  "volume": 4400,
  "cpc": 3.12,
  "competition": 0.41,
  "competitionLevel": "MEDIUM",
  "ideas": [
    {
      "keyword": "AI CRM for startups",
      "volume": 8100,
      "cpc": 2.84,
      "competition": 0.38,
      "competitionLevel": "MEDIUM"
    }
  ],
  "requestId": "…",
  "billing": {
    "cost": {
      "microCredits": 12000,
      "usd": "0.12"
    },
    "balance": {
      "microCredits": 1336000,
      "usd": "13.36"
    }
  }
}