Keywords batch

Check search volume, CPC, and competition for two to 50 seed keywords in one request.

Overview

Send two to 50 distinct keywords with one country and language. The response includes one result for each requested keyword, even when its volume is unavailable. The batch costs $0.09 when any keyword has positive volume, or $0.03 when none does. Related ideas are available through the single-keyword endpoint.

Reference

POST/v1/keywords/batch

$0.03 to $0.09 · by outcome: lower price when none of the two to 50 seeds has positive volume.

Parameters

`country`optional	string	ISO-2 country code for localized metrics. Defaults to "us". Default: `"us"`.
`language`optional	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.
`seeds`required	string[]	Two to 50 distinct seed keywords to check in one provider request.

Request

curl https://www.cite42.dev/api/v1/keywords/batch \
  -X POST \
  -H "Authorization: Bearer $CITE42_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seeds":["ai visibility tracking","ai sentiment tracking"]}'

Response

{
  "results": [
    {
      "requestedKeyword": "ai visibility tracking",
      "keyword": "ai visibility tracking",
      "status": "exact",
      "volume": 480,
      "cpc": 3.12,
      "competition": 0.41,
      "competitionLevel": "MEDIUM"
    },
    {
      "requestedKeyword": "ai sentiment tracking",
      "keyword": "ai sentiment tracking",
      "status": "no_data",
      "volume": null,
      "cpc": null,
      "competition": null,
      "competitionLevel": null
    }
  ],
  "requestId": "…",
  "billing": {
    "cost": {
      "microCredits": 9000,
      "usd": "0.09"
    },
    "balance": {
      "microCredits": 1336000,
      "usd": "13.36"
    }
  }
}