Use this file to discover all available pages before exploring further.
This page walks through each of the 6 Search APIs end-to-end, request, response, and how to read the result. For full parameter specs, head to the API Reference.
All endpoints use the same auth: Authorization: Bearer fag_your_api_key. Replace fag_your_api_key with your key from the Factagora dashboard.
GET /api/v1/news/search · 1 credit · Real-time semantic news search.Search news by meaning rather than keywords. Returns articles with publication date, source domain, and relevance score.
POST /api/v1/fact-checker · 2 credits · Claim verification.Sends a claim, returns a TRUE / FALSE / UNCERTAIN verdict with a confidence score and supporting sources from the Factagora knowledge base.
curl -X POST "https://api.factagora.com/api/v1/fact-checker" \ -H "Authorization: Bearer fag_your_api_key" \ -H "Content-Type: application/json" \ -d '{"claim": "The ECB raised interest rates in June 2024."}'
{ "claim": "The ECB raised interest rates in June 2024.", "verdict": "TRUE", "confidence": 0.92, "summary": "Multiple verified sources confirm the ECB raised its deposit rate by 25bp on June 6, 2024.", "sources": [ { "title": "ECB June 2024 monetary policy decision", "url": "https://factagora.com/claims/abc-123" } ]}
Treat confidence < 0.5 as UNCERTAIN even when the verdict is TRUE or FALSE. The verdict reflects the AI’s best guess; confidence reflects how strongly the evidence supports it.
POST /api/v1/evidence-finder · 2 credits · Evidence expansion and source discovery.Given a claim, surfaces multi-angle evidence, each result is typed (DATA, EXPERT, NEWS, FACT_CHECK), credibility-scored, and tagged with a stance (supports / contradicts / neutral).
{ "claim": "Carbon pricing reduces industrial emissions.", "results": [ { "summary": "OECD study finds a 5–15% reduction in covered-sector emissions following carbon-pricing introduction.", "source": "https://oecd.org/...", "type": "DATA", "credibility": 0.91, "stance": "supports" }, { "summary": "Industry economist argues short-term emissions decline is offset by carbon leakage.", "source": "https://example.com/...", "type": "EXPERT", "credibility": 0.74, "stance": "contradicts" } ]}
Use stance to balance perspectives. A claim that returns only supports-stance evidence may be under-explored, pull more results or refine the claim to surface counter-evidence.
POST /api/v1/deep-research · 2 credits · Cross-source research synthesis.Aggregates verified claims, news, and time-series events on a topic, then generates a structured report with sections and citations.
curl -X POST "https://api.factagora.com/api/v1/deep-research" \ -H "Authorization: Bearer fag_your_api_key" \ -H "Content-Type: application/json" \ -d '{"query": "Impact of US tariffs on global semiconductor supply chains"}'
{ "query": "Impact of US tariffs on global semiconductor supply chains", "summary": "US tariffs on advanced chips have accelerated supply-chain regionalization, with notable shifts in Taiwan, Korea, and ASEAN fab investments.", "sections": [ { "title": "Background", "content": "..." }, { "title": "Current State", "content": "..." }, { "title": "Key Debates", "content": "..." }, { "title": "Conclusion", "content": "..." } ], "timeseries": { "title": "Major tariff and policy events", "dataPoints": [ { "date": "2022-10-07", "event": "US export controls on advanced chips to China" } ] }, "sources": [ { "title": "...", "url": "..." } ]}
Treat the summary as a draft, not a final answer. Deep Research synthesizes from multiple sources but does not replace human judgment for high-stakes decisions, always review the cited sources.
POST /api/v1/timeseries · 3 credits · Time-based information flow.Extracts a chronological sequence of events from a URL or uploaded document (PDF/Markdown).
POST /api/v1/causality-graph · 3 credits · Cause-and-effect analysis.Extracts a directed graph of causes and effects from a URL or document. Nodes are concepts/events; edges are causal relationships.
