> ## 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

> 어떤 클레임이든 신뢰도 점수가 매겨진 증거를 찾기

실시간 뉴스 출처에서 클레임과 관련된 증거를 검색합니다. 출처가 클레임을 지지하는지, 반박하는지, 중립인지 나타내는 입장과 함께, AI가 분석하고 신뢰도 점수를 매긴 출처를 유형별로 분류해 반환합니다.

## 요청 본문

<ParamField body="claim" type="string" required>
  증거를 찾을 클레임 또는 주제. 최대 500자.
</ParamField>

<ParamField body="limit" type="number" default="5">
  반환할 결과의 최대 개수. 범위: 1–20.
</ParamField>

<ParamField body="language" type="string">
  증거 수집 시 뉴스 출처 언어 필터. 예: `english`, `korean`
</ParamField>

<ParamField body="country" type="string">
  증거 수집 시 뉴스 출처 국가 코드 필터. 예: `US`, `KR`
</ParamField>

<ParamField body="sortBy" type="string" default="relevance">
  뉴스 기반 증거의 정렬 순서. 옵션: `relevance`, `date`
</ParamField>

<ParamField body="source" type="string" default="default">
  검색할 데이터 소스. 옵션:

  * `default` — 공개 뉴스 소스만 (기본값)
  * `ingest` — 개인 인제스트 지식 베이스만 (개인 액세스 토큰 필요)
  * `all` — 뉴스 + 개인 인제스트 지식 베이스 합산 (개인 액세스 토큰 필요)
</ParamField>

<ParamField body="from" type="string">
  뉴스 기반 증거의 날짜 범위 시작 (ISO 8601). 예: `2025-01-01T00:00:00Z`
</ParamField>

<ParamField body="to" type="string">
  뉴스 기반 증거의 날짜 범위 종료 (ISO 8601). 예: `2025-05-01T23:59:59Z`
</ParamField>

## 응답

<ResponseField name="claim" type="string">
  검색에 사용된 클레임입니다.
</ResponseField>

<ResponseField name="results" type="array">
  증거 항목 목록입니다. `sortBy`가 `relevance`(기본값)이면 검색 관련도 순, `date`이면 최신순으로 정렬됩니다.

  <Expandable title="Evidence item fields">
    <ResponseField name="title" type="string">
      뉴스 기사 또는 출처의 제목입니다.
    </ResponseField>

    <ResponseField name="summary" type="string">
      이 출처가 클레임과 어떻게 관련되는지 AI가 생성한 설명입니다.
    </ResponseField>

    <ResponseField name="snippet" type="string">
      출처 원문 발췌입니다. 발췌가 없으면 빈 문자열입니다.
    </ResponseField>

    <ResponseField name="source" type="string">
      출처 URL입니다.
    </ResponseField>

    <ResponseField name="publishedAt" type="string">
      출처의 발행일시(ISO 8601). 일부 출처에는 없을 수 있습니다.
    </ResponseField>

    <ResponseField name="type" type="string">
      증거 유형: `DATA`, `EXPERT`, `NEWS`, `FACT_CHECK`
    </ResponseField>

    <ResponseField name="credibility" type="number">
      이 출처가 클레임을 얼마나 강하게 지지하거나 반박하는지에 대해 AI가 산출한 신뢰도 점수입니다. 값이 높을수록 출처가 클레임을 직접적이고 명확하게 다룬다는 의미입니다. 범위: 0–1.
    </ResponseField>

    <ResponseField name="stance" type="string">
      출처가 클레임을 지지하는지 또는 반박하는지 여부. `SUPPORTS`, `CONTRADICTS`, `NEUTRAL` 중 하나입니다.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  <Expandable title="Meta fields">
    <ResponseField name="total" type="number">`limit` 적용 전 검색된 전체 증거 수</ResponseField>
    <ResponseField name="executionTimeMs" type="number">데이터베이스 검색과 AI 추론을 포함한 전체 응답 시간(밀리초)</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>