Skip to main content
​
2026-06-29 · Collections API

​
New: Collections API

Build a per-brand private knowledge graph by ingesting multiple URLs into one unified TKG (Temporal Knowledge Graph), then query it with grounded answers and Q&A verification.

​
How it works

  1. Create a collection for a brand (e.g. Hyundai UK)
  2. Ingest URLs: each page is extracted into claims, predictions, and causal edges that accumulate in one unified TKG
  3. Ask questions grounded only in that corpus (/answer)
  4. Verify existing Q&A pairs against the knowledge graph (/qa-verify)

​
New endpoints

​
Key behaviors

  • Synchronous ingestion: POST /ingest processes URLs and returns results per URL including claims_count and predictions_count. Each URL takes 10–30 seconds.
  • Unified TKG: all ingested URLs share one knowledge graph per collection. Same-title entities are merged automatically.
  • Semantic search: /answer and /qa-verify use pgvector to retrieve the most relevant chunks before generating answers, improving accuracy over naive RAG.
  • Grounded flag: if the collection does not contain enough information to answer, grounded: false is returned instead of hallucinating.
  • Tenant isolation: collections are scoped to personal access tokens. A master key cannot access collection endpoints.

​
Q&A verification verdicts

​
2026-06-23 · Unified source parameter
POST /api/v1/evidence-finder, POST /api/v1/fact-checker, and GET /api/v1/fact-search now share a consistent source parameter for controlling which data sources are used.

​
source parameter

Affected endpoints:Backward compatibility: fact-search previously accepted source=news. This value continues to work as an alias for source=default.
​
2026-06-18 · Ingest API

​
New: Ingest API

Two new endpoints that let you extract structured knowledge from any content source and store it in your personal Temporal Knowledge Graph.

​
POST /api/v1/ingest

Ingest a URL or raw text. Automatically extracts:
  • Claims: falsifiable factual statements
  • Predictions: future-oriented statements with measurable outcomes
  • Causal edges: relationships between claims and predictions (CAUSES, SUPPORTS, CONTRADICTS, etc.)
  • Vector chunks: semantic search index for the full content

​
POST /api/v1/ingest/file

Upload a PDF, Markdown, or TXT file directly for ingestion.

​
GET /api/v1/fact-search?source=ingest

Search your personal ingested knowledge graph. Returns chunks, claims, and predictions matching your query. Requires a personal access token, so only your own content is returned.
​
2026-06-08 · Bug fixes and improvements

​
Bug Fixes and Improvements

This release includes minor bug fixes and internal improvements across the API.
​
2026-06-05 · Fact Search Rename

​
Fact Search Rename

Renamed the News Search endpoint to Fact Search to better reflect the scope of the API.

​
Changed

  • GET /api/v1/news/search has been renamed to GET /api/v1/fact-search
Migration: Update any hardcoded endpoint paths from /api/v1/news/search to /api/v1/fact-search. Query parameters and response schema are unchanged.