For your product
Clarity™ for platforms

Put Clarity™ inside your website or product

Your readers get the same reading Clarity™ gives on its own site: what matters first, every figure checked, questions answered with the lines they come from, in twelve languages. You add one line, or call one endpoint.

Try it live for 14 days Talk to us on WhatsApp

How to start, in four steps

  1. Ask for a test key. Message us with your website. You get a pk_test_ key for pages and a sk_test_ key for servers. Test keys return a sample reading, work on localhost and your staging site, and cost nothing.
  2. Add the embed to a page. Paste one line before </body>. A "Make sense of this" button appears and reads the page it sits on.
  3. Build against the API, if you need it. Same keys, same response shape as live.
  4. Go live. Choose a plan, tell us your domains, and swap the test keys for live ones. Nothing else changes.

The website embed

Reads the page it is placed on. Works on any site: plain HTML, WordPress, Webflow, Shopify, React or anything else that can include a script.

<script src="https://clarity.craydesignz.com/embed.js" data-key="pk_live_your_key" data-reader-token="TOKEN_FROM_YOUR_SERVER" defer></script>

Reader tokens are an extra lock you can switch on in your console. Once on, your server asks for a reader token for each page it serves, using your secret key, and writes it into data-reader-token. A token lasts 30 minutes. With it on, a copied publishable key is useless anywhere else. Keep it off if your pages are static and have no server; your domain list and spending limits still guard the key. Test keys never need one.

curl -X POST https://clarity.craydesignz.com/v1/reader-token \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"reader":"user-123"}'

Options

AttributeWhat it does
data-keyYour publishable key. It only works on the domains registered for it.
data-reader-tokenThe reader token your server asked for, when reader tokens are on for your live key. It lasts 30 minutes.
data-targetA CSS selector for the part of the page to read, for example #report. Default: the main content.
data-labelThe button text. Default: "Make sense of this report".
data-langThe starting language: en, pcm, yo, ig, ha, efi, tw, sw, fr, es, zh, hi. Readers can still change it.
data-readerWho the reader is, for example "an investor" or "a tenant". Clarity™ frames the reading for them.
data-floatingauto (default), always or never for the floating button. Any element with data-clarity also opens the panel.

The server API

For reading documents inside your own product. Keep the secret key on your server, never in a page or an app.

Read a document

curl https://clarity.craydesignz.com/v1/read \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "The full document text...", "reader": "a small business owner"}'

# or let Clarity™ fetch a public page
  -d '{"url": "https://example.com/annual-report"}'

Returns { "digest": { ... }, "cached": false, "usage": { ... } }. The digest holds the one line summary, quick, clear and deep readings, the figures that matter, findings with their basis, what to watch, options for the reader, a glossary and more. Reading the same text again is instant and uses nothing more.

Ask a question

curl https://clarity.craydesignz.com/v1/ask \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"text": "The full document text...", "question": "What do I owe and when?", "language": "yo"}'

Check your usage

curl https://clarity.craydesignz.com/v1/usage -H "Authorization: Bearer sk_live_your_key"

Errors

StatusMeaning
401The key is missing or not recognised.
403The key cannot do this: it is paused, the domain is not registered, or it does not include what you asked for (error not_in_plan, with the product named). A key reaches only the products switched on for it; ask us and we add one.
402This month's lumens are used up. Top up or move to a larger plan.
413The document is too large (about 60,000 words).
429Slow down: a daily or per minute limit was reached.
502, 503The reading engine is busy. Try again shortly.

Plans for platforms

Lumens work the same way as on Clarity™ itself: a reading starts from 4 lumens (5 from 22 November 2026, as announced), a question from 2, and opening anything already read uses no lumens.

Test
Free
3 sites · server API

Sandbox keys for building. Works on localhost and your staging site and returns a sample reading, so testing costs nothing.

Starter
$49 a month
3,000 lumens a month · 1 site

Clarity™ on one website: a "Make sense of this" button on any page your readers open.

Growth
$199 a month
12,000 lumens a month · 5 sites · server API

Up to five sites, plus the server API so your own product can read documents with Clarity™.

Scale
Let us talk
Volume, sites and support agreed with you

High volume, your own terms, a named contact and an agreed response time.

Try it live, with your own documents

A live trial gives your team real readings for 14 days: 300 lumens, the website embed and the server API, on up to 3 of your domains. Tell us who you are and we send your keys, usually within a day.

Fair use and safety

Clarity™ · clarity.craydesignz.com · llms.txt for AI agents