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

# 소개

> Factagora API 개요

## 개요

Factagora API는 Factagora 지식 그래프에 프로그래매틱하게 접근할 수 있게 해줍니다, 전 세계 뉴스와 연구 출처에서 추출된 팩트체크 클레임, 예측, 증거, 인과 관계를 지속적으로 업데이트하는 데이터베이스입니다. 드롭인 레이어로 설계되어, 이미 운영 중인 LLM·검색 스택 위에서 어떤 언어나 프레임워크로든 호출할 수 있습니다.

## Temporal Knowledge Graph 위에서 동작합니다

API 뒤에는 **Temporal Knowledge Graph(TKG)** 가 있습니다. Factagora는 정보를 흩어진 문서 조각으로 저장하지 않고, 각 사실을 **FactBlock** — 시간 정보가 기록되고 인과로 연결된 명제 — 으로 저장합니다. 이 설계 덕분에 지식 그래프는 대부분의 출처가 놓치는 두 가지 질문, 즉 어떤 사실이 **언제(when)** 참이었는지와 **왜(why)** 일어났는지에 특히 정확합니다.

<CardGroup cols={2}>
  <Card title="*언제(when)*에 정확" icon="clock">
    사실은 bi-temporal입니다. 각 사실은 이벤트가 발생한 시점과, 그 사실이 유효한 기간을 함께 기록합니다. 조회는 point-in-time 방식이라, 질문하는 시점에 유효했던 사실만 반환됩니다 — 이후의 정보가 과거 답변으로 새어 들어가지 않으므로, 시점에 민감한 추론이 사후편향(hindsight bias)에서 자유롭습니다.
  </Card>

  <Card title="*왜(why)*에 정확" icon="diagram-project">
    인과 관계는 1급 시민입니다. 사실들은 *causes*, *triggers*, *contributes to*, *prevents* 같은 타입이 있는 엣지로 연결되며, 이 엣지는 메커니즘·시차(lag)·확신도를 담고, 증거가 쌓이면 가설(hypothesis)에서 검증됨(verified)으로 승격됩니다. 단순 상관과 인과를 구분하므로, API는 사실이 단지 함께 나타난다는 것이 아니라 *왜* 연결되는지를 설명할 수 있습니다.
  </Card>
</CardGroup>

그 결과, 단지 *무엇이* 참인지뿐 아니라 *언제* 참이었고 *무엇이 그것을 일으켰는지*에 근거한 답을 얻을 수 있습니다 — AI 에이전트가 검증 가능한 근거를 바탕으로 타임라인과 인과관계를 추론할 수 있게 됩니다.

## Temporal Knowledge Graph 위에서 동작합니다

API 뒤에는 **Temporal Knowledge Graph(TKG)** 가 있습니다. Factagora는 정보를 흩어진 문서 조각으로 저장하지 않고, 각 사실을 **FactBlock** — 시간 정보가 기록되고 인과로 연결된 명제 — 으로 저장합니다. 이 설계 덕분에 지식 그래프는 대부분의 출처가 놓치는 두 가지 질문, 즉 어떤 사실이 **언제(when)** 참이었는지와 **왜(why)** 일어났는지에 특히 정확합니다.

<CardGroup cols={2}>
  <Card title="*언제(when)*에 정확" icon="clock">
    사실은 bi-temporal입니다. 각 사실은 이벤트가 발생한 시점과, 그 사실이 유효한 기간을 함께 기록합니다. 조회는 point-in-time 방식이라, 질문하는 시점에 유효했던 사실만 반환됩니다 — 이후의 정보가 과거 답변으로 새어 들어가지 않으므로, 시점에 민감한 추론이 사후편향(hindsight bias)에서 자유롭습니다.
  </Card>

  <Card title="*왜(why)*에 정확" icon="diagram-project">
    인과 관계는 1급 시민입니다. 사실들은 *causes*, *triggers*, *contributes to*, *prevents* 같은 타입이 있는 엣지로 연결되며, 이 엣지는 메커니즘·시차(lag)·확신도를 담고, 증거가 쌓이면 가설(hypothesis)에서 검증됨(verified)으로 승격됩니다. 단순 상관과 인과를 구분하므로, API는 사실이 단지 함께 나타난다는 것이 아니라 *왜* 연결되는지를 설명할 수 있습니다.
  </Card>
</CardGroup>

그 결과, 단지 *무엇이* 참인지뿐 아니라 *언제* 참이었고 *무엇이 그것을 일으켰는지*에 근거한 답을 얻을 수 있습니다 — AI 에이전트가 검증 가능한 근거를 바탕으로 타임라인과 인과관계를 추론할 수 있게 됩니다.

## Base URL

```
https://api.factagora.com
```

## 인증

모든 Factagora 엔드포인트는 API 키로 인증합니다. [무료 API 키를 발급받으세요.](https://factagora.com/ko/playground/tokens)

<Info>
  **별도로 발급할 필요 없이 바로 시작할 수 있습니다.** Factagora에 처음 로그인하면 기본 API 키가 자동으로 발급됩니다. [Settings → API Keys](https://factagora.com/ko/playground/tokens)에서 키를 복사하거나 추가 키를 생성하세요.
</Info>

```bash theme={null}
curl -X GET "https://api.factagora.com/api/v1/fact-search?q=bitcoin" \
  -H "Authorization: Bearer fag_YOUR_API_KEY"
```

API 키는 `fag_...` 형식을 따릅니다. 자세한 내용은 [인증](/ko/api-reference/authentication) 페이지를 참고하세요.

## 엔드포인트

<CardGroup cols={2}>
  <Card title="/fact-search" icon="newspaper" href="/ko/api-reference/fact-search">
    전 세계 출처에서 최근 뉴스 기사를 검색합니다.
  </Card>

  <Card title="/fact-check" icon="circle-check" href="/ko/api-reference/fact-checker">
    AI 판정과 뒷받침 증거로 클레임의 진위를 검증합니다.
  </Card>

  <Card title="/evidence" icon="magnifying-glass" href="/ko/api-reference/evidence-finder">
    특정 주제를 지지하거나 반박하는, 신뢰도 점수가 매겨진 증거를 찾습니다.
  </Card>

  <Card title="/deep-research" icon="book-open" href="/ko/api-reference/deep-research">
    주제에 대해 다중 출처를 활용한 종합 리서치를 실행합니다.
  </Card>

  <Card title="/timeseries" icon="chart-line" href="/ko/api-reference/timeseries">
    URL 또는 텍스트에서 시계열 데이터를 추출합니다.
  </Card>

  <Card title="/causality-graph" icon="diagram-project" href="/ko/api-reference/causality-graph">
    URL 또는 텍스트에서 인과 관계 그래프를 추출합니다.
  </Card>

  <Card title="/fingerprint/embed" icon="fingerprint" href="/ko/api-reference/fingerprint/fingerprint-embed">
    출처 추적을 위해 콘텐츠에 TKG 기반 워터마크를 삽입합니다.
  </Card>

  <Card title="/fingerprint/detect" icon="shield-check" href="/ko/api-reference/fingerprint/fingerprint-detect">
    콘텐츠가 이전에 fingerprinting된 출처와 매치되는지 탐지합니다.
  </Card>
</CardGroup>

## 응답 형식

모든 응답은 JSON입니다. 성공 응답은 `200`을 반환합니다. 오류는 `400`(검증) 또는 `401`(인증)을 반환합니다.

```json theme={null}
{
  "error": "Unauthorized",
  "message": "Missing Bearer token",
  "statusCode": 401
}
```