Evidence Finder

{
  "claim": "Bitcoin price will exceed 200000 dollars in 2025",
  "results": [
    {
      "title": "Bitcoin surges past $100,000 as institutional demand accelerates",
      "summary": "Reuters reports a surge in institutional Bitcoin purchases in early 2025, which analysts cite as a key demand driver toward higher price targets.",
      "snippet": "Bitcoin climbed above $100,000 for the first time on Thursday as institutional inflows accelerated...",
      "source": "https://www.reuters.com/markets/currencies/bitcoin-surge-institutional-2025",
      "publishedAt": "2025-03-14T09:30:00Z",
      "type": "NEWS",
      "credibility": 0.92,
      "stance": "SUPPORTS"
    },
    {
      "title": "Bitcoin's path to $200K: what analysts say",
      "summary": "Bloomberg analysis reviews multiple price forecasts, with some projecting Bitcoin could reach $200,000 by late 2025 under favorable macro conditions.",
      "snippet": "",
      "source": "https://www.bloomberg.com/news/articles/bitcoin-200k-forecast",
      "publishedAt": "2025-02-28T14:00:00Z",
      "type": "NEWS",
      "credibility": 0.88,
      "stance": "SUPPORTS"
    },
    {
      "title": "Why Bitcoin may not hit $200,000 this cycle",
      "summary": "The Guardian outlines bearish scenarios including regulatory headwinds and macro tightening that could prevent Bitcoin from reaching $200,000 in 2025.",
      "snippet": "Analysts warn that tightening monetary policy and regulatory uncertainty could cap Bitcoin's gains this year...",
      "source": "https://www.theguardian.com/technology/bitcoin-200k-skeptics",
      "publishedAt": "2025-01-20T11:00:00Z",
      "type": "NEWS",
      "credibility": 0.88,
      "stance": "CONTRADICTS"
    }
  ],
  "meta": {
    "total": 8,
    "executionTimeMs": 4821
  }
}

POST

api

evidence-finder

{
  "claim": "Bitcoin price will exceed 200000 dollars in 2025",
  "results": [
    {
      "title": "Bitcoin surges past $100,000 as institutional demand accelerates",
      "summary": "Reuters reports a surge in institutional Bitcoin purchases in early 2025, which analysts cite as a key demand driver toward higher price targets.",
      "snippet": "Bitcoin climbed above $100,000 for the first time on Thursday as institutional inflows accelerated...",
      "source": "https://www.reuters.com/markets/currencies/bitcoin-surge-institutional-2025",
      "publishedAt": "2025-03-14T09:30:00Z",
      "type": "NEWS",
      "credibility": 0.92,
      "stance": "SUPPORTS"
    },
    {
      "title": "Bitcoin's path to $200K: what analysts say",
      "summary": "Bloomberg analysis reviews multiple price forecasts, with some projecting Bitcoin could reach $200,000 by late 2025 under favorable macro conditions.",
      "snippet": "",
      "source": "https://www.bloomberg.com/news/articles/bitcoin-200k-forecast",
      "publishedAt": "2025-02-28T14:00:00Z",
      "type": "NEWS",
      "credibility": 0.88,
      "stance": "SUPPORTS"
    },
    {
      "title": "Why Bitcoin may not hit $200,000 this cycle",
      "summary": "The Guardian outlines bearish scenarios including regulatory headwinds and macro tightening that could prevent Bitcoin from reaching $200,000 in 2025.",
      "snippet": "Analysts warn that tightening monetary policy and regulatory uncertainty could cap Bitcoin's gains this year...",
      "source": "https://www.theguardian.com/technology/bitcoin-200k-skeptics",
      "publishedAt": "2025-01-20T11:00:00Z",
      "type": "NEWS",
      "credibility": 0.88,
      "stance": "CONTRADICTS"
    }
  ],
  "meta": {
    "total": 8,
    "executionTimeMs": 4821
  }
}

Search for evidence related to a claim from real news sources. Returns AI-analyzed, credibility-scored sources categorized by type, each with a stance indicating whether the source supports, contradicts, or is neutral toward the claim.

Request Body

string

required

The claim or topic to find evidence for. Max 500 characters.

number

default:"5"

Maximum number of results to return. Range: 1–20.

string

Filter news source language for evidence retrieval. Examples: english, korean

string

Filter news source country code for evidence retrieval. Examples: US, KR

string

default:"relevance"

Sort order for news-based evidence sources. Options: relevance, date

string

default:"default"

Data source for evidence. Options:

default: public news sources only (default)
ingest: personal ingested knowledge base only (requires personal access token)
all: news + personal ingested knowledge base combined (requires personal access token)

string

Start of date range (ISO 8601) for news-based evidence. Example: 2025-01-01T00:00:00Z

string

End of date range (ISO 8601) for news-based evidence. Example: 2025-05-01T23:59:59Z

Response

string

The claim that was searched.

array

List of evidence items. When sortBy is relevance (default), items are ordered by search relevance. When sortBy is date, items are ordered by publication date descending.

Show Evidence item fields

string

Title of the news article or source.

string

AI-generated explanation of how this source relates to the claim.

string

Original text excerpt from the source. Empty string when no excerpt is available.

string

Source URL.

string

Publication date of the source in ISO 8601 format. May be absent for some sources.

string

Evidence type: DATA, EXPERT, NEWS, or FACT_CHECK

number

AI-generated confidence score for how strongly this source supports or contradicts the claim. Higher values mean the source directly and clearly addresses the claim. Range: 0–1.

string

Whether the source supports or challenges the claim. One of: SUPPORTS, CONTRADICTS, NEUTRAL

object

Show Meta fields

number

Total number of evidence items found before the limit was applied.

number

Total response time in milliseconds, including database search and AI inference

cURL

curl -X POST "https://api.factagora.com/api/v1/evidence-finder" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"claim": "Carbon pricing reduces industrial emissions.", "limit": 5}'

Python

resp = requests.post(
    "https://api.factagora.com/api/v1/evidence-finder",
    headers={"Authorization": "Bearer fa_your_api_key"},
    json={"claim": "Carbon pricing reduces industrial emissions.", "limit": 5},
)
data = resp.json()

TypeScript

const resp = await fetch("https://api.factagora.com/api/v1/evidence-finder", {
  method: "POST",
  headers: {
    Authorization: "Bearer fa_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    claim: "Carbon pricing reduces industrial emissions.",
    limit: 5,
  }),
});
const data = await resp.json();

{
  "claim": "Bitcoin price will exceed 200000 dollars in 2025",
  "results": [
    {
      "title": "Bitcoin surges past $100,000 as institutional demand accelerates",
      "summary": "Reuters reports a surge in institutional Bitcoin purchases in early 2025, which analysts cite as a key demand driver toward higher price targets.",
      "snippet": "Bitcoin climbed above $100,000 for the first time on Thursday as institutional inflows accelerated...",
      "source": "https://www.reuters.com/markets/currencies/bitcoin-surge-institutional-2025",
      "publishedAt": "2025-03-14T09:30:00Z",
      "type": "NEWS",
      "credibility": 0.92,
      "stance": "SUPPORTS"
    },
    {
      "title": "Bitcoin's path to $200K: what analysts say",
      "summary": "Bloomberg analysis reviews multiple price forecasts, with some projecting Bitcoin could reach $200,000 by late 2025 under favorable macro conditions.",
      "snippet": "",
      "source": "https://www.bloomberg.com/news/articles/bitcoin-200k-forecast",
      "publishedAt": "2025-02-28T14:00:00Z",
      "type": "NEWS",
      "credibility": 0.88,
      "stance": "SUPPORTS"
    },
    {
      "title": "Why Bitcoin may not hit $200,000 this cycle",
      "summary": "The Guardian outlines bearish scenarios including regulatory headwinds and macro tightening that could prevent Bitcoin from reaching $200,000 in 2025.",
      "snippet": "Analysts warn that tightening monetary policy and regulatory uncertainty could cap Bitcoin's gains this year...",
      "source": "https://www.theguardian.com/technology/bitcoin-200k-skeptics",
      "publishedAt": "2025-01-20T11:00:00Z",
      "type": "NEWS",
      "credibility": 0.88,
      "stance": "CONTRADICTS"
    }
  ],
  "meta": {
    "total": 8,
    "executionTimeMs": 4821
  }
}

Overview

Endpoints

Best Practices

Request Body

Response

​Request Body

​Response

Request Body

Response