Developer Documentation

curl -X POST https://omniscient.news/api/fact-check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "claim_input": {
      "highlighted_span": "The Great Wall of China is visible from space.",
      "page_url": "https://example.com/article",
      "page_title": "Space myths debunked"
    }
  }'

const response = await fetch("https://omniscient.news/api/fact-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OMNISCIENT_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    claim_input: {
      highlighted_span: "The Great Wall of China is visible from space.",
      page_url: "https://example.com/article",
      page_title: "Space myths debunked",
    },
  }),
});

const result = await response.json();
console.log(result.trustScore);  // 0–100
console.log(result.verdict);     // "DISPUTED" | "SUPPORTED" | "UNSUPPORTED"
console.log(result.citations);   // [...source URLs]

import requests

response = requests.post(
    "https://omniscient.news/api/fact-check",
    headers={
        "Authorization": f"Bearer {API_KEY}",
        "Content-Type": "application/json",
    },
    json={
        "claim_input": {
            "highlighted_span": "The Great Wall is visible from space.",
            "page_url": "https://example.com/article",
            "page_title": "Space myths debunked",
        }
    }
)

data = response.json()
print(data["trustScore"])   # 0–100
print(data["verdict"])     # "DISPUTED" | "SUPPORTED"
print(data["citations"])   # [{url, title}, ...]

// npm install @omniscient/sdk
import { OmniscientClient } from "@omniscient/sdk";

const client = new OmniscientClient({
  apiKey: process.env.OMNISCIENT_API_KEY,
});

const result = await client.factCheck({
  claim: "The Great Wall of China is visible from space.",
  pageUrl: "https://example.com/article",
});

console.log(result.trustScore);   // 0–100
console.log(result.verdict);      // "DISPUTED"
console.log(result.citations);    // [...source URLs]
console.log(result.models);       // per-model breakdown

Authorization: Bearer omni_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

curl https://omniscient.news/api/fact-check/omni-a1b2c3-d4e5f6 \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "period": "2026-03",
  "requestsUsed": 1284,
  "requestsLimit": null,    // null = unlimited (Always-On plan)
  "plan": "always_on_pro",
  "resetDate": "2026-04-01T00:00:00Z"
}

{
  "claim_input": {
    "highlighted_span": "Bitcoin uses more energy than Argentina.",
    "page_url": "https://bbc.com/news/technology-56012952",
    "page_title": "Bitcoin's energy use in numbers",
    "full_text": "Critics argue that Bitcoin uses more energy than Argentina, raising environmental concerns..."
  }
}

{
  "referenceId": "omni-a1b2c3-d4e5f6",
  "trustScore":  68,
  "verdict":     "PARTIALLY SUPPORTED",
  "consensus":   "Two of three models support this claim with caveats.",
  "claimType":   "STATISTICAL CLAIM",
  "models": {
    "gpt4o_mini": {
      "verdict": "SUPPORTED",
      "score":   72,
      "summary": "Cambridge Centre data confirms this figure as of 2021..."
    },
    "perplexity": {
      "verdict": "SUPPORTED",
      "score":   70,
      "summary": "Estimates vary by year; broadly accurate as a comparison..."
    },
    "gemini": {
      "verdict": "DISPUTED",
      "score":   61,
      "summary": "More recent data shows efficiency improvements..."
    }
  },
  "citations": [
    { "url": "https://ccaf.io/cbnsi/cbeci",          "title": "Cambridge Bitcoin Electricity Consumption Index" },
    { "url": "https://iea.org/reports/bitcoin-energy", "title": "IEA: Bitcoin energy report" }
  ],
  "processingMs": 2140
}

npm install @omniscient/sdk
# or
pnpm add @omniscient/sdk

import { OmniscientClient, FactCheckResult } from "@omniscient/sdk";

const client = new OmniscientClient({
  apiKey: process.env.OMNISCIENT_API_KEY!,
  timeout: 10_000,   // ms, default 8000
  retries: 2,          // auto-retry on 5xx
});

// Fact-check a claim
const result: FactCheckResult = await client.factCheck({
  claim: "The Eiffel Tower is 330 metres tall.",
  pageUrl: "https://example.com/article",
});

// Access per-model data
for (const [model, data] of Object.entries(result.models)) {
  console.log(`${model}: ${data.verdict} (${data.score})`);
}

// Retrieve a cached result
const cached = await client.getResult(result.referenceId);

// Check quota
const usage = await client.getUsage();
console.log(`Used: ${usage.requestsUsed} this period`);

{
  "error":   "RATE_LIMIT_EXCEEDED",
  "message": "You have exceeded 60 requests per minute. Retry after 38 seconds.",
  "retryAfter": 38
}