AI visibility·GET$0.22

/v1/top-cited-pages

Which pages of a domain AI engines cite most, from an aggregated index of AI answers.

Not a live prompt run — an index of observed AI answers, so it reflects what has actually been cited rather than one answer today. Per page you get mentions, AI search volume, and per-engine and per-language splits, plus totals for the domain. Off-domain URLs that merely discuss the target are filtered out.

It answers the content agent's first question: what already works on this site — write more of that.

Parameters#

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/top-cited-pages?domain=example.com&limit=3

Response#

200 with the JSON below (trimmed) and the settlement signature in the PAYMENT-RESPONSE header. Every paid response also carries price and cluster.

{
  "domain": "example.com",
  "pages": [
    { "page": "https://example.com/docs/getting-started", "mentions": 412, "aiSearchVolume": 38900,
      "engines": [ { "key": "google", "mentions": 380 }, { "key": "chat_gpt", "mentions": 32 } ],
      "languages": [ { "key": "en", "mentions": 401 }, { "key": "de", "mentions": 11 } ] },
    { "page": "https://example.com/pricing", "mentions": 97, "aiSearchVolume": 6100, "engines": [ "…" ], "languages": [ "…" ] },
    { "page": "https://example.com/blog/compare", "mentions": 54, "aiSearchVolume": 2400, "engines": [ "…" ], "languages": [ "…" ] }
  ],
  "totalCitedPages": 128,
  "domainTotals": { "mentions": 1930, "aiSearchVolume": 141200, "engines": [ "…" ], "languages": [ "…" ] },
  "source": "dataforseo_llm_mentions",
  "price": "$0.22",
  "cluster": "mainnet"
}

Errors#

Any non-200 cancels the payment — errors are free.

MCP tool#

The same call from Claude, Codex or Cursor once citable-mcp is installed. Arguments mirror the parameters above.

citable_top_cited_pages(domain, limit?)   $0.22

Source & latency#

Pairs with#