Skip to main content

​
Overview

The Factagora API gives you programmatic access to the Factagora knowledge graph, a continuously updated database of fact-checked claims, predictions, evidence, and causal relationships extracted from global news and research sources. It’s designed as a drop-in layer: call it from any language or framework, on top of the LLM and retrieval stack you already run.

​
Built on a Temporal Knowledge Graph

Behind the API is a Temporal Knowledge Graph (TKG). Instead of storing loose document chunks, Factagora stores each fact as a FactBlock, a time-stamped, causally linked proposition. This design makes the knowledge graph especially precise about two questions most sources get wrong: when something was true, and why it happened.

Accurate about *when*

Facts are bi-temporal: each one records when an event occurred and the window during which it stays valid. Queries are point-in-time, so the API returns only the facts that were valid at the moment you ask about. Later information never leaks backward into an earlier answer, which keeps time-sensitive reasoning free of hindsight bias.

Accurate about *why*

Causal relationships are first-class. Facts are connected by typed links, such as causes, triggers, contributes to, and prevents, that capture the mechanism, the time lag, and a confidence level, and that are promoted from hypothesis to verified as evidence accumulates. Correlation is kept distinct from causation, so the API can explain why facts connect, not just that they co-occur.
The result: answers that are grounded not only in what is true, but in when it was true and what caused it, so AI agents can reason about timelines and cause-and-effect with verifiable support.

​
Base URL

​
Authentication

All Factagora endpoints are authenticated using API keys. Get your free API key.
You don’t need to create one to get started. A default API key is issued automatically the first time you sign in to Factagora. Visit Settings → API Keys to copy it or create additional keys.
API keys follow the format fag_.... See Authentication for details.

​
Endpoints

/fact-search

Search recent news articles from global sources.

/fact-check

Verify the truthfulness of a claim with AI verdicts and supporting evidence.

/evidence

Find credibility-scored evidence supporting or contradicting any topic.

/deep-research

Run comprehensive multi-source research on a topic.

/timeseries

Extract timeseries data from a URL or text.

/causality-graph

Extract a causal relationship graph from a URL or text.

/fingerprint/embed

Embed a TKG-based watermark into content for provenance tracking.

/fingerprint/detect

Detect whether content matches a previously fingerprinted source.

​
Response Format

All responses are JSON. Successful responses return 200. Errors return 400 (validation) or 401 (authentication).