메인 콘텐츠로 건너뛰기
POST
/
api
/
v1
/
ingest
curl -X POST "https://api.factagora.com/api/v1/ingest" \
  -H "Authorization: Bearer fag_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.reuters.com/article/...", "visibility": "private"}'

{
  "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, 텍스트, 파일)를 인제스트하여 구조화된 지식(claims, predictions, 인과 엣지)을 개인 TKG(Temporal Knowledge Graph)에 자동으로 추출·저장합니다. 추출된 지식은 시맨틱 검색을 위해 벡터 임베딩으로도 저장됩니다.

​
엔드포인트

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

​
POST /api/v1/ingest

​
요청 바디

​
url
string
인제스트할 URL. url 또는 content 중 하나는 필수입니다.
​
content
string
인제스트할 원본 텍스트 (최대 20,000자). url 또는 content 중 하나는 필수입니다.
​
visibility
string
기본값:"private"
접근 제어 설정. private (기본값) — 본인만 접근 가능. public — 공개 접근 허용.
curl -X POST "https://api.factagora.com/api/v1/ingest" \
  -H "Authorization: Bearer fag_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.reuters.com/article/...", "visibility": "private"}'

​
POST /api/v1/ingest/file

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

​
file
file
필수
인제스트할 PDF, Markdown, 또는 TXT 파일.
​
visibility
string
기본값:"private"
접근 제어 설정. private 또는 public.
curl -X POST "https://api.factagora.com/api/v1/ingest/file" \
  -H "Authorization: Bearer fag_your_api_key" \
  -F "file=@report.pdf" \
  -F "visibility=private"

​
응답

​
ingest_source_id
string
인제스트된 소스 문서의 고유 ID.
​
tkg_id
string
이 문서를 위해 생성된 TKG 그래프 ID.
​
source_title
string
소스 콘텐츠에서 추출된 제목.
​
claims
array
콘텐츠에서 추출된 검증 가능한 사실 진술 목록.
​
predictions
array
콘텐츠에서 추출된 미래 예측 목록.
​
edges
array
추출된 claims와 predictions 간의 인과 관계.
​
general_length
number
벡터 청크로 저장된 원본 콘텐츠의 문자 수.
​
chunks_count
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 fag_your_api_key"
결과에는 개인 지식 그래프의 청크, claim, prediction이 포함됩니다.