Subscribe Sign in

Quickstart

Five minutes from no key to a scored article.

1. Get a key

Choose Pay as you go on the pricing page. After checkout the key is shown once: copy it somewhere safe.

2. Score some text

curl https://mundaneread.com/v1/niralscore \
  -H "Authorization: Bearer $MUNDANE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Furious residents slammed the council over the shocking decision."}'

3. Read the answer

score is 0 (plain) to 100 (loaded). components lists every indicator with its weight and contribution, and evidence gives the exact words, with their offsets, that moved it.

4. In JavaScript

const res = await fetch('https://mundaneread.com/v1/neutralize', {
  method: 'POST',
  headers: { authorization: 'Bearer ' + process.env.MUNDANE_KEY, 'content-type': 'application/json' },
  body: JSON.stringify({ text }),
});
const { text: calm, changes } = await res.json();

5. In Python

import os, requests
r = requests.post("https://mundaneread.com/v1/bias/all",
    headers={"Authorization": f"Bearer {os.environ['MUNDANE_KEY']}"},
    json={"text": text})
print(r.json())

Next

Errors · Rate limits · How each indicator works