> ## Documentation Index
> Fetch the complete documentation index at: https://docs.factagora.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Evidence Finder

> Find credibility-scored evidence for any claim

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

<ParamField body="claim" type="string" required>
  The claim or topic to find evidence for. Max 500 characters.
</ParamField>

<ParamField body="limit" type="number" default="5">
  Maximum number of results to return. Range: 1–20.
</ParamField>

<ParamField body="language" type="string">
  Filter news source language for evidence retrieval. Examples: `english`, `korean`
</ParamField>

<ParamField body="country" type="string">
  Filter news source country code for evidence retrieval. Examples: `US`, `KR`
</ParamField>

<ParamField body="sortBy" type="string" default="relevance">
  Sort order for news-based evidence sources. Options: `relevance`, `date`
</ParamField>

<ParamField body="source" type="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)
</ParamField>

<ParamField body="from" type="string">
  Start of date range (ISO 8601) for news-based evidence. Example: `2025-01-01T00:00:00Z`
</ParamField>

<ParamField body="to" type="string">
  End of date range (ISO 8601) for news-based evidence. Example: `2025-05-01T23:59:59Z`
</ParamField>

## Response

<ResponseField name="claim" type="string">
  The claim that was searched.
</ResponseField>

<ResponseField name="results" type="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.

  <Expandable title="Evidence item fields">
    <ResponseField name="title" type="string">
      Title of the news article or source.
    </ResponseField>

    <ResponseField name="summary" type="string">
      AI-generated explanation of how this source relates to the claim.
    </ResponseField>

    <ResponseField name="snippet" type="string">
      Original text excerpt from the source. Empty string when no excerpt is available.
    </ResponseField>

    <ResponseField name="source" type="string">
      Source URL.
    </ResponseField>

    <ResponseField name="publishedAt" type="string">
      Publication date of the source in ISO 8601 format. May be absent for some sources.
    </ResponseField>

    <ResponseField name="type" type="string">
      Evidence type: `DATA`, `EXPERT`, `NEWS`, or `FACT_CHECK`
    </ResponseField>

    <ResponseField name="credibility" type="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.
    </ResponseField>

    <ResponseField name="stance" type="string">
      Whether the source supports or challenges the claim. One of: `SUPPORTS`, `CONTRADICTS`, `NEUTRAL`
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  <Expandable title="Meta fields">
    <ResponseField name="total" type="number">Total number of evidence items found before the `limit` was applied.</ResponseField>
    <ResponseField name="executionTimeMs" type="number">Total response time in milliseconds, including database search and AI inference</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.factagora.com/api/v1/evidence-finder" \
    -H "Authorization: Bearer fag_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{"claim": "Bitcoin price will exceed 200000 dollars in 2025", "limit": 5}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "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
    }
  }
  ```
</ResponseExample>