Analysis & auditGET$0.008
/v1/serp
The raw Google results page — organic results with snippets, People-Also-Ask and related searches.
rank-check answers "where am I"; this answers "what does the page look like". Organic results with title, URL, domain and snippet, plus the People-Also-Ask questions and related searches when the vendor surfaces them — PAA feeds the keyword skills directly. Cached 1 hour; SERPs move faster than rank profiles.
Parameters#
| Name | Description | |
|---|---|---|
keyword | required | search query (1–120 chars) |
gl | optional | country code, default us |
hl | optional | language code, default en |
num | optional | results depth, 10–50 (default 10) |
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/serp?keyword=seo+api
Response#
200 with the JSON below (trimmed) and the settlement signature in the PAYMENT-RESPONSE header. Every paid response also carries price and cluster.
{
"keyword": "seo api",
"gl": "us",
"hl": "en",
"results": [
{ "position": 1, "domain": "dataforseo.com", "url": "https://dataforseo.com/", "title": "DataForSEO: Powerful API Stack For Data-Driven SEO Tools", "snippet": "Discover DataForSEO APIs …" }
],
"peopleAlsoAsk": [ "What is an SEO API?", "Is there a free SEO API?" ],
"relatedSearches": [ "seo api free", "best seo api" ],
"source": "serper",
"price": "$0.008",
"cluster": "mainnet"
}Errors#
Any non-200 cancels the payment — errors are free.
| Status | Code | When |
|---|---|---|
| 400 | invalid_keyword | keyword missing or longer than 120 chars |
| 502 | upstream_failed | the data source did not answer — nothing is charged |
| 503 | not_configured | this deployment has no credentials for the source — nothing is charged |
MCP tool#
The same call from Claude, Codex or Cursor once citable-mcp is installed. Arguments mirror the parameters above.
citable_serp(keyword, gl?, hl?, num?) $0.008Source & latency#
| Data source | Typical latency |
|---|---|
| Serper or DataForSEO SERP (licensed live feeds) | ~2–6 s |