Ranked keywords API: every keyword a domain ranks for, with position and volume

seo.ranked_keywords

live

The keywords a domain ranks for on Google, with position, volume, CPC and estimated traffic per 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

Provider	Status
DataForSEO	live

Billing

Unit: per_search · unmatched results billed: no
Priced per search plus a small per-keyword 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.ranked_keywords",
    "input": { "domain": "..." },
    "routing": {"provider": "auto"}
  }'

Input schema

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

Normalized output fields

domain · total · keywords

Used in these guides

SEO opportunity research →Competitor SEO teardown →