Keyword Research API
Give us a domain and get back a researched keyword list for its niche — each with estimated search volume, competition, and search intent.
keywords:readOne request, structured JSON back
curl -X POST https://instarankseo.com/api/v1/keywords \
-H "X-API-Key: isk_your_key_here" \
-H "Content-Type: application/json" \
-d '{"domain": "example.com", "count": 200}'{
"success": true,
"domain": "example.com",
"primaryKeyword": "...",
"count": 30,
"keywords": [
{ "keyword": "...", "volume": 90500, "competition": "high",
"intent": "commercial", "cluster": null }
],
"meta": { "creditsUsed": 25, "creditsRemaining": 18974, "apiVersion": "1.0" }
}Parameters
| Field | Type | Required | Description |
|---|---|---|---|
| domain | string | required | Target domain (hostname or URL). |
| count | integer | optional | Max keywords to return, 1–200 (default 30). Above 50 is expanded in deduped 50-keyword batches. |
| country | string | optional | 2-letter ISO country code to localize the research. |
Built for builders
Domain in, keywords out
No seed list required — point it at any domain and it infers the niche and returns the keywords that matter for it.
Volume, competition, intent
Every keyword is scored with estimated monthly search volume, a low/medium/high competition band, and its search intent (commercial, informational, navigational, transactional).
Scales to 200, deduped
Ask for up to 200 keywords and the API expands the list in 50-keyword batches, excluding everything it has already produced so every keyword in the response is distinct.
Pricing & limits
Price
$0.025 per 50 keywords
25 credits per 50 keywords
Billed from one credit wallet. Failed upstream calls are refunded automatically.
Rate limits
- Free10 / min
- SEO+60 / min
- Agency120 / min
Surfaced as X-RateLimit-* headers on every response.
Errors
Every non-2xx shares one envelope with a machine-readable code, a retryable flag, and a requestId for tracing.
Send an Idempotency-Key header to retry POSTs safely without double-charging.
One call replaces hours of manual keyword research and a stack of seed-list spreadsheets — pass a domain, get a ranked, intent-tagged keyword set, up to 200 deep.
Last updated:
Keyword Research API FAQ
Common questions about the Keyword Research API — pricing, auth, and what it returns.
How does the Keyword Research API work?
You send a domain and it researches the keywords relevant to that site's niche, returning each one with estimated monthly search volume, a competition band (low, medium, or high), and the search intent. You do not need to supply a seed keyword list.
What does it cost?
Twenty-five credits per 50 keywords ($0.025 at the standard rate). A run is billed by batch: up to 50 keywords is 25 credits, up to 100 is 50 credits, up to 200 is 100 credits. If the research returns no usable results the credits are refunded automatically.
How many keywords do I get?
Up to the count you request (1–200, default 30). Counts above 50 are expanded in deduped 50-keyword batches, so larger requests stay distinct and on-topic. If the niche is narrow the API may return fewer than requested once it runs out of genuinely new keywords — it never pads the list with duplicates. Results are ordered so the most central, high-value terms come first.
What do competition and intent mean?
Competition is a low / medium / high band reflecting how hard the keyword is to rank for. Intent classifies why someone searches it — commercial, informational, navigational, or transactional — so you can prioritize terms that match your goals.
Which scope does it need?
The keywords:read scope on your API key. Send the key in the X-API-Key header on every request.