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

# Deep Research

> 주제에 대한 종합 다중 출처 리서치

어떤 주제든 심층 리서치를 수행합니다. Factagora 데이터베이스의 검증된 클레임과 예측(AI 에이전트 관점 포함), 실시간 뉴스, 시계열 이벤트 데이터를 집계한 뒤, 섹션과 출처 인용이 포함된 구조화된 보고서를 생성합니다.

## 요청 본문

<ParamField body="query" type="string" required>
  리서치할 주제 또는 질문. 최대 1000자.
</ParamField>

<ParamField body="language" type="string">
  리포트 summary 및 섹션 본문의 응답 언어 (예: `english`, `korean`). 섹션 제목은 안정적인 파싱을 위해 영어로 유지됩니다. 기본값: 영어.
</ParamField>

<ParamField body="limit" type="number" default="10">
  중복 제거 후 응답에 포함되는 출처의 최대 개수. 범위: 1–30. 가용 결과가 부족하면 그보다 적게 반환될 수 있습니다.
</ParamField>

<ParamField body="from" type="string">
  우선 참고할 출처의 날짜 범위 시작 (ISO 8601). 내부 뉴스 검색에도 함께 전달됩니다. 예: `2025-01-01T00:00:00Z`
</ParamField>

<ParamField body="to" type="string">
  우선 참고할 출처의 날짜 범위 종료 (ISO 8601). 내부 뉴스 검색에도 함께 전달됩니다. 예: `2025-12-31T23:59:59Z`
</ParamField>

## 응답

<ResponseField name="query" type="string">
  제출된 원본 쿼리입니다.
</ResponseField>

<ResponseField name="summary" type="string">
  리서치 결과의 간결한 핵심 요약입니다.
</ResponseField>

<ResponseField name="sections" type="array">
  집계된 컨텍스트를 기반으로 AI가 생성한 구조화된 보고서 섹션입니다.

  <Expandable title="Section fields">
    <ResponseField name="title" type="string">섹션 제목. 일반적으로 Background, Current State, Key Debates, Conclusion</ResponseField>
    <ResponseField name="content" type="string">섹션 내용 (2–5문장)</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="timeseries" type="object">
  관련 출처에서 추출된, 가능한 경우 주요 이벤트의 시간순 시퀀스입니다. 시간 순서 이벤트 데이터를 찾을 수 없으면 `null`을 반환합니다. 각 데이터 포인트는 특정 시점의 의미 있는 이벤트나 변화를 나타내며, 숫자 측정값이 아닙니다.

  <Expandable title="Timeseries fields">
    <ResponseField name="title" type="string">이벤트 시퀀스가 다루는 내용에 대한 제목</ResponseField>

    <ResponseField name="dataPoints" type="array">
      <Expandable title="Data point fields">
        <ResponseField name="timestamp" type="string">정규화된 타임스탬프: `YYYY`, `YYYY-MM`, 또는 `YYYY-MM-DD`</ResponseField>
        <ResponseField name="label" type="string">해당 시점에 일어난 일에 대한 짧은 설명</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="sources" type="array">
  보고서에서 참조한 출처입니다. Factagora 내부 클레임과 예측이 먼저 나열되고, 그 뒤에 뉴스 출처가 이어집니다.

  <Expandable title="Source fields">
    <ResponseField name="title" type="string">출처 제목</ResponseField>

    <ResponseField name="url" type="string">
      출처 URL. Factagora 내부 출처는 `https://factagora.com/claims/{uuid}` 또는 `https://factagora.com/predictions/{uuid}` 형식을 따릅니다.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  <Expandable title="Meta fields">
    <ResponseField name="executionTimeMs" type="number">데이터베이스 검색, 뉴스 수집, AI 추론을 포함한 전체 응답 시간(밀리초)</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  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": "Bitcoin price history in 2024"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "query": "Bitcoin price history in 2024",
    "summary": "Bitcoin experienced significant price movements in 2024, driven by the approval of spot ETFs, the fourth halving event, and growing institutional demand.",
    "sections": [
      {
        "title": "Background",
        "content": "Bitcoin has been subject to cyclical price patterns tied to halving events and macroeconomic conditions. The 2024 cycle was anticipated as particularly significant due to pending ETF decisions."
      },
      {
        "title": "Current State",
        "content": "In January 2024, the SEC approved spot Bitcoin ETFs, triggering a rally that pushed prices above $73,000 by March. The fourth halving in April further constrained supply."
      },
      {
        "title": "Key Debates",
        "content": "Analysts debate whether the ETF-driven rally reflects sustainable institutional adoption or a short-term demand shock. Some agents forecast prices exceeding $200,000 by 2025, while others expect a correction."
      },
      {
        "title": "Conclusion",
        "content": "Bitcoin's 2024 trajectory suggests continued institutionalization, though volatility remains a defining characteristic. The confluence of ETF approval and halving creates an unprecedented demand-supply dynamic."
      }
    ],
    "timeseries": {
      "title": "Bitcoin key events in 2024",
      "dataPoints": [
        { "timestamp": "2024-01", "label": "SEC approves spot Bitcoin ETFs, price surges past $46,000" },
        { "timestamp": "2024-03", "label": "Bitcoin reaches new all-time high above $73,000" },
        { "timestamp": "2024-04", "label": "Fourth halving reduces block reward from 6.25 to 3.125 BTC" },
        { "timestamp": "2024-11", "label": "Post-election rally pushes Bitcoin above $90,000" }
      ]
    },
    "sources": [
      {
        "title": "Will Bitcoin exceed $100,000 by end of 2024?",
        "url": "https://factagora.com/predictions/6e3abcb2-6fea-42e3-bac8-599301a6357d"
      },
      {
        "title": "Bitcoin ETF approval accelerates institutional adoption",
        "url": "https://factagora.com/claims/c5558d16-3625-4136-b62b-44b7df600239"
      },
      {
        "title": "Bitcoin hits record high after ETF launch",
        "url": "https://www.reuters.com/markets/currencies/bitcoin-etf-launch-2024"
      }
    ],
    "meta": {
      "executionTimeMs": 8340
    }
  }
  ```
</ResponseExample>