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"
}

curl -X POST https://omniscient.news/api/v1/factcheck \
  -H "X-Omniscient-Key: omni_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "The Earth is approximately 4.54 billion years old.",
    "lang": "en",
    "webhook_url": "https://yoursite.com/hooks/omniscient"
  }'

{
  "object": "fact_check",
  "api_version": "v1",
  "text": "The Earth is approximately 4.54 billion years old.",
  "lang": "en",
  "verdict": "SUPPORTED",         // SUPPORTED | DISPUTED | MIXED | INSUFFICIENT_EVIDENCE | NOT_APPLICABLE
  "fact_score": 96,              // 0–100 consensus confidence score
  "span_type": "FACT",            // FACT | OPINION | MIXED | TRIVIAL_COMMON_KNOWLEDGE
  "consensus_level": "full",     // full | partial | split
  "reasoning": "All three models confirmed...",
  "evidence_summary": "Retrieved evidence from NASA, USGS, and Nature...",
  "claims": [ /* per-claim breakdown */ ],
  "citations": [
    "https://solarsystem.nasa.gov/solar-system/our-solar-system/in-depth/",
    "https://www.usgs.gov/faqs/how-old-earth"
  ],
  "model_results": [
    { "model": "ChatGPT (GPT-4o Mini)", "verdict": "SUPPORTED", "fact_score": 97, "success": true },
    { "model": "Perplexity AI",        "verdict": "SUPPORTED", "fact_score": 95, "success": true },
    { "model": "Google Gemini 2.5 Flash", "verdict": "SUPPORTED", "fact_score": 96, "success": true }
  ],
  "credits_remaining": 149,
  "latency_ms": 2340
}

curl https://omniscient.news/api/v1/me \
  -H "X-Omniscient-Key: omni_YOUR_API_KEY"

{
  "object": "api_key_info",
  "api_version": "v1",
  "credits_remaining": 149,
  "email": "you@yourcompany.com",
  "docs": "https://omniscient.news/developer"
}

{
  "event": "fact_check.complete",
  "data": { /* same payload as the API response */ }
}

https://omniscient.news/obs-overlay?key=omni_YOUR_KEY&lang=en&dur=10

{
  "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
}