← Catalog

Keyword volume and difficulty API: search volume, CPC and ideas for a seed

seo.keywords

live

Search volume and keyword ideas for a seed keyword.

live coverage

DataForSEO: all inputs ✓

✓ marks a combination proven with a real provider call. Others are wired and unit-tested; their first live run verifies them.

Providers

ProviderStatus
DataForSEO live

Billing

Unit: per_search · unmatched results billed: no
Priced per search plus a small per-idea amount, scaling with limit (default 20). The exact quote is reserved before execution. If the provider's actual cost overruns the estimate, the run bills the overrun at the same per-call rate, capped by the hold.

The exact quote is returned by /v1/inspect before every call and held with headroom on execution. The quote is the price floor: if the provider's actual cost overruns it, the run bills the overrun at the same rate, never above the hold. The unused part of every hold is released.

Run it

curl https://api.jell.run/v1/run \
  -H "Authorization: Bearer $JELL_API_KEY" \
  -d '{
    "capability": "seo.keywords",
    "input": { "keyword": "..." },
    "routing": {"provider": "auto"}
  }'

Input schema

{
  "properties": {
    "keyword": {
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "limit": {
      "type": "integer"
    },
    "location": {
      "description": "City and country (\"Lisbon, Portugal\"), a country (\"France\") or a DataForSEO location code; default United States",
      "type": "string"
    }
  },
  "required": [
    "keyword"
  ],
  "type": "object"
}

Normalized output fields

keyword · volume · cpc · competition · ideas

Used in these guides

SEO opportunity research →