Developers

The Klepha API.

Crawl a site, ask ChatGPT, Gemini and Perplexity about it, and read back every answer with the sources each engine cited and the competitors it named instead of you.

Getting started

Authentication

Klepha uses passwordless sign-in. There are no API keys; requests carry the session cookie set at sign-in.

  • 1
    Request a code. POST /api/auth/email with {"email": "you@example.com"} emails a six-digit code, valid for ten minutes.
  • 2
    Exchange it. POST /api/auth/verify with the email and code sets the ksess cookie. Send it on every subsequent request.
  • 3
    Check state. GET /api/me returns your account, credit balance, plan and which engines are live. It works signed out too, so it doubles as a capability probe.

Measuring visibility

The core loop is four calls.

  • 1
    Add the site. POST /api/sites with {"domain": "example.com"} registers it and starts a crawl of public pages only.
  • 2
    Set the questions. GET or PUT /api/sites/{id}/prompts. Scans run this list verbatim, so it is worth curating.
  • 3
    Run the scan. POST /api/sites/{id}/scans sends every prompt to all three engines.
  • 4
    Read the results. GET /api/scans/{id} until status is done, then GET /api/sites/{id}/summary for the score.

What a result contains

Every score traces back to a stored answer, so nothing has to be taken on trust.

  • answer — the full response text the engine produced.
  • mentioned — whether your brand was named in it.
  • cited — whether your domain was used as a source. Stronger than a mention: the engine read you rather than recalled you.
  • competitors — the rival brands named in that answer.
  • citations — the source URLs the engine actually used.

Credits and limits

Engine calls cost real money, so metered operations draw down a credit balance where one credit is one US cent of engine spend.

  • Metered: scans, competitor analysis, Reddit feeds and analysis, content drafting, strategy generation.
  • Free: reading stored answers, summaries, usage history and Search Console data.
  • Out of credits returns 402 with a JSON error. Check the balance any time with GET /api/usage.

For agents

Machine-readable entry points, linked from the Link header on every page.

Build on the answers.

Create an account and the same endpoints the dashboard uses are yours.

Get started Talk to us