Keyword researchGET$0.005
/v1/keyword-suggest
The phrasings real people type: autocomplete expansions and questions for a seed — deduped and ranked, no search volume.
Expands one seed roughly 55 ways across Google, YouTube and Bing autocomplete, then dedupes and ranks what comes back. Questions are split out from plain expansions so an agent can go straight to the ones worth answering on a page.
Each item carries a score relative to the top of its list and a matchesSeed flag. A keyword that drifted from the seed is a signal that there is no demand for the literal phrase — treat it as an answer, not an idea.
Parameters#
| Name | Description | |
|---|---|---|
seed | required | keyword to expand (1–80 chars) |
lang | optional | language code, default en (id supported with localized question words) |
country | optional | country code, default us |
depth | optional | 0 seed only · 1 + questions and modifiers · 2 (default) + a–z sweep |
limit | optional | max keywords per list, default 100, max 300 |
sources | optional | comma list of google,youtube,bing (default all) |
Request#
Plain GET. Without a payment header the response is a 402 carrying the price; an x402 client pays and retries on its own — see the quickstart.
GET https://citable.run/v1/keyword-suggest?seed=solana+rpc&depth=1&limit=8
Response#
200 with the JSON below (trimmed) and the settlement signature in the PAYMENT-RESPONSE header. Every paid response also carries price and cluster.
{
"seed": "solana rpc",
"lang": "en",
"country": "us",
"depth": 1,
"suggestions": [
{ "keyword": "solana rpc url", "score": 1, "sources": ["google", "bing"], "type": "expansion", "matchesSeed": true },
{ "keyword": "solana rpc and chain id", "score": 0.99, "sources": ["google"], "type": "expansion", "matchesSeed": true },
{ "keyword": "solana rpc for metamask", "score": 0.79, "sources": ["google"], "type": "expansion", "matchesSeed": true }
],
"questions": [
{ "keyword": "is solana rpc free", "score": 1, "sources": ["google"], "type": "question", "matchesSeed": true },
{ "keyword": "what is solana rpc", "score": 0.38, "sources": ["google"], "type": "question", "matchesSeed": true },
{ "keyword": "what is solana used for", "score": 0.28, "sources": ["google"], "type": "question", "matchesSeed": false }
],
"counts": { "suggestions": 8, "questions": 8, "requests": 29, "cacheHits": 0, "failed": 0 },
"sources": { "google": { "ok": 27, "failed": 0 }, "youtube": { "ok": 1, "failed": 0 }, "bing": { "ok": 1, "failed": 0 } },
"fetchedAt": "2026-08-24T20:43:12.919Z",
"price": "$0.005",
"cluster": "mainnet"
}Errors#
Any non-200 cancels the payment — errors are free.
| Status | Code | When |
|---|---|---|
| 400 | invalid_seed | seed missing or longer than 80 chars |
| 502 | upstream_failed | no autocomplete source answered — nothing is charged |
MCP tool#
The same call from Claude, Codex or Cursor once citable-mcp is installed. Arguments mirror the parameters above.
citable_keyword_suggest(seed, lang?, country?, depth?, limit?, sources?) $0.005Source & latency#
| Data source | Typical latency |
|---|---|
| Public autocomplete (Google, YouTube, Bing), fetched and ranked in-house | ~1–3 s |
Note