DE
Contact
  • AI
  • API

From check to API: klarava as a GEO interface

Majd Edriss
Majd Edriss 2 min read

klarava’s free check answers a one-time question for a single site: does the AI understand you? But agencies and developers kept asking something else: can we run this automatically, across many sites, and pull it into our own tools? That is not a job for a form, but for an interface. So klarava now also has an API.

Why an API

The check is made for people: one site, one look, one result. An API is made for machines. An agency scoring 200 client sites. A dashboard that shows “AI visibility” as a metric. A CI pipeline that fails a build the moment a deploy breaks AI-crawler access. The same analysis, just automatable and integrable.

What it returns

One request returns up to three layers as clean JSON:

  • Technical GEO (deterministic): can a machine fetch, read and extract the site? AI-crawler access, schema, server vs. JavaScript rendering, answer structure, sitemap, hreflang.
  • Brand Clarity (deterministic): can a complete, sourced, current picture of the provider be built from it? With concrete findings on what is structurally missing and how to fix it.
  • AI analysis (optional, via LLM): how well does a language model actually understand the content?

The first two layers use no AI, so they are fast and reproducible on every call.

Why two deterministic scores

This is the key design decision. Deterministic means it only checks the presence of structure, things like schema, links or dates. No guessing, no AI cost, the same result every time. The language model judges what a rule cannot: whether the content is actually clear. Keeping the two apart makes the result transparent and repeatable, and that matters when someone pays for it.

An honest word on the build

Nothing magical, but solidly built. The API runs dependency-light in Node on a small dedicated server (the managed hosting behind the free tool is not meant for commercial API traffic), with automatic TLS and restarts. Billing, authentication and quotas are handled by the RapidAPI marketplace; my side only verifies that each call really arrives through the gateway.

My takeaway

The check stays free. The API is the same engine for everyone who wants to measure AI readiness at scale or inside their own product. If that is you: the klarava API. If you just want to check a single site, the free check still does exactly that, and I wrote about it here.

← Back to blog