Ingest

{
  "ingest_source_id": "cec6ad87-b783-4b4e-a6f4-65130b5e17a8",
  "tkg_id": "a6c36ed6-36e3-4f87-8855-e88484f3a08f",
  "source_title": "Iran to Gain Major Financial Relief Under Interim Deal With US",
  "claims": [
    {
      "title": "이란, 임시 협정 하에 즉시 석유 수출 허용",
      "description": "이란은 미국과의 임시 협정 하에 즉시 석유 수출을 시작할 수 있게 됩니다.",
      "category": "economics",
      "claim_date": "2026-06-17"
    }
  ],
  "predictions": [
    {
      "title": "임시 협정 이후 영구 평화 협상 진행",
      "description": "테헤란의 핵 활동을 다루기 위한 영구 평화 협상이 진행될 예정입니다.",
      "category": "politics",
      "deadline": null
    }
  ],
  "edges": [
    {
      "from_title": "이란, 임시 협정 하에 즉시 석유 수출 허용",
      "to_title": "임시 협정 이후 영구 평화 협상 진행",
      "edge_type": "TRIGGERS",
      "confidence": 0.7,
      "mechanism": "석유 수출 허가가 광범위한 평화 협상을 가능하게 하는 전제 조건입니다."
    }
  ],
  "general_length": 562,
  "chunks_count": 1
}

POST

api

ingest

{
  "ingest_source_id": "cec6ad87-b783-4b4e-a6f4-65130b5e17a8",
  "tkg_id": "a6c36ed6-36e3-4f87-8855-e88484f3a08f",
  "source_title": "Iran to Gain Major Financial Relief Under Interim Deal With US",
  "claims": [
    {
      "title": "이란, 임시 협정 하에 즉시 석유 수출 허용",
      "description": "이란은 미국과의 임시 협정 하에 즉시 석유 수출을 시작할 수 있게 됩니다.",
      "category": "economics",
      "claim_date": "2026-06-17"
    }
  ],
  "predictions": [
    {
      "title": "임시 협정 이후 영구 평화 협상 진행",
      "description": "테헤란의 핵 활동을 다루기 위한 영구 평화 협상이 진행될 예정입니다.",
      "category": "politics",
      "deadline": null
    }
  ],
  "edges": [
    {
      "from_title": "이란, 임시 협정 하에 즉시 석유 수출 허용",
      "to_title": "임시 협정 이후 영구 평화 협상 진행",
      "edge_type": "TRIGGERS",
      "confidence": 0.7,
      "mechanism": "석유 수출 허가가 광범위한 평화 협상을 가능하게 하는 전제 조건입니다."
    }
  ],
  "general_length": 562,
  "chunks_count": 1
}

외부 콘텐츠(URL, 텍스트, 파일)를 수집하여 구조화된 지식(클레임, 예측, 인과 엣지)을 개인 TKG(Temporal Knowledge Graph)에 자동으로 추출·저장합니다. 추출된 지식은 시맨틱 검색을 위해 벡터 임베딩으로도 저장됩니다.

엔드포인트

메서드	경로	입력
`POST`	`/api/v1/ingest`	`url` 또는 `content`가 포함된 JSON 바디
`POST`	`/api/v1/ingest/file`	`file`이 포함된 `multipart/form-data`

POST /api/v1/ingest

요청 바디

string

수집할 URL. url 또는 content 중 하나는 필수입니다.

string

수집할 원본 텍스트 (최대 20,000자). url 또는 content 중 하나는 필수입니다.

string

기본값:"private"

접근 제어 설정. private은 기본값이며 본인만 접근 가능하고, public은 공개 접근을 허용합니다.

cURL

curl -X POST "https://api.factagora.com/api/v1/ingest" \
  -H "Authorization: Bearer fa_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/quarterly-report"}'

Python

import requests

resp = requests.post(
    "https://api.factagora.com/api/v1/ingest",
    headers={"Authorization": "Bearer fa_your_api_key"},
    json={"url": "https://example.com/quarterly-report"},
)
data = resp.json()

TypeScript

const resp = await fetch("https://api.factagora.com/api/v1/ingest", {
  method: "POST",
  headers: {
    Authorization: "Bearer fa_your_api_key",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com/quarterly-report" }),
});
const data = await resp.json();

POST /api/v1/ingest/file

요청 바디 (multipart/form-data)

file

필수

수집할 PDF, Markdown, 또는 TXT 파일.

string

기본값:"private"

접근 제어 설정. private 또는 public.

curl -X POST "https://api.factagora.com/api/v1/ingest/file" \
  -H "Authorization: Bearer fa_your_api_key" \
  -F "file=@report.pdf" \
  -F "visibility=private"

응답

string

수집된 소스 문서의 고유 ID.

string

이 문서를 위해 생성된 TKG 그래프 ID.

string

소스 콘텐츠에서 추출된 제목.

array

콘텐츠에서 추출된 검증 가능한 사실 진술 목록.

표시 Claim 필드

string

간결한 클레임 제목

string

전체 클레임 내용

string

도메인 카테고리 (economics, technology, politics 등)

string

클레임이 참조하는 날짜 (YYYY-MM-DD), 언급된 경우

array

콘텐츠에서 추출된 미래 예측 목록.

표시 Prediction 필드

string

간결한 예측 제목

string

전체 예측 내용

string

도메인 카테고리

string

미래 마감일 (YYYY-MM-DD), 언급된 경우

array

추출된 클레임과 예측 간의 인과 관계.

표시 Edge 필드

string

소스 노드 제목

string

타겟 노드 제목

string

관계 타입: CAUSES, SUPPORTS, CONTRADICTS, TRIGGERS, CONTRIBUTING_FACTOR, PREVENTS, CONCURRENT_SIGNAL, QUALIFIES, DEPENDS_ON, DERIVED_FROM, SUPERSEDES

number

신뢰도 점수 (0.0–1.0)

string

인과 관계에 대한 간략한 설명

number

벡터 청크로 저장된 원본 콘텐츠의 문자 수.

number

시맨틱 검색을 위해 저장된 벡터 청크 수.

{
  "ingest_source_id": "cec6ad87-b783-4b4e-a6f4-65130b5e17a8",
  "tkg_id": "a6c36ed6-36e3-4f87-8855-e88484f3a08f",
  "source_title": "Iran to Gain Major Financial Relief Under Interim Deal With US",
  "claims": [
    {
      "title": "이란, 임시 협정 하에 즉시 석유 수출 허용",
      "description": "이란은 미국과의 임시 협정 하에 즉시 석유 수출을 시작할 수 있게 됩니다.",
      "category": "economics",
      "claim_date": "2026-06-17"
    }
  ],
  "predictions": [
    {
      "title": "임시 협정 이후 영구 평화 협상 진행",
      "description": "테헤란의 핵 활동을 다루기 위한 영구 평화 협상이 진행될 예정입니다.",
      "category": "politics",
      "deadline": null
    }
  ],
  "edges": [
    {
      "from_title": "이란, 임시 협정 하에 즉시 석유 수출 허용",
      "to_title": "임시 협정 이후 영구 평화 협상 진행",
      "edge_type": "TRIGGERS",
      "confidence": 0.7,
      "mechanism": "석유 수출 허가가 광범위한 평화 협상을 가능하게 하는 전제 조건입니다."
    }
  ],
  "general_length": 562,
  "chunks_count": 1
}

수집된 콘텐츠 검색

GET /api/v1/fact-search에 source=ingest 파라미터를 사용하여 개인 지식 그래프를 검색하세요:

curl "https://api.factagora.com/api/v1/fact-search?q=석유+수출+이란&source=ingest" \
  -H "Authorization: Bearer fa_your_api_key"

결과에는 개인 지식 그래프의 청크, 클레임, 예측이 포함됩니다.

개요

Endpoints

Best Practices

엔드포인트

POST /api/v1/ingest

요청 바디

POST /api/v1/ingest/file

요청 바디 (multipart/form-data)

응답

수집된 콘텐츠 검색

​엔드포인트

​POST /api/v1/ingest

​요청 바디

​POST /api/v1/ingest/file

​요청 바디 (multipart/form-data)

​응답

​수집된 콘텐츠 검색

엔드포인트

POST /api/v1/ingest

요청 바디

POST /api/v1/ingest/file

요청 바디 (multipart/form-data)

응답

수집된 콘텐츠 검색