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

# Ingest

> Ingest API 활용 베스트 프랙티스

## URL로 공개 기사 수집하기

가장 빠른 방법은 URL을 직접 전달하는 것입니다. API가 Mozilla Readability를 사용하여 콘텐츠를 자동으로 파싱합니다.

```json theme={null}
{ "url": "https://www.reuters.com/article/..." }
```

## 내부 문서는 파일 엔드포인트 사용

PDF, 보고서, 마크다운 문서는 `/api/v1/ingest/file` 엔드포인트를 사용하세요. PDF, Markdown, TXT 파일을 지원합니다.

```bash theme={null}
curl -X POST "https://api.factagora.com/api/v1/ingest/file" \
  -H "Authorization: Bearer fag_your_api_key" \
  -F "file=@quarterly-report.pdf" \
  -F "visibility=private"
```

## 민감한 데이터는 private으로 유지

수집된 콘텐츠는 기본적으로 `private`입니다. 이미 공개된 콘텐츠에 한해서만 `visibility=public`을 설정하세요. Private 콘텐츠는 토큰 소유자만 검색할 수 있습니다.

## 수집 후 지식 그래프 검색

수집 후 `fact-search`에 `source=ingest`를 사용하면 지식 그래프를 시맨틱 검색할 수 있습니다. 요청 형식은 [Ingest API 문서](/ko/api-reference/ingest)의 "수집된 콘텐츠 검색" 섹션을 참고하세요.

## ingest\_source\_id로 출처 추적

응답의 `ingest_source_id`는 추출된 모든 클레임과 예측을 소스 문서와 연결합니다. 출처 추적이 필요하다면 저장해두세요.

## Fact Checker와 결합

수집으로 클레임을 추출한 후 [Fact Checker](/ko/api-reference/fact-checker)에 전달하여 최신 뉴스로 검증하세요.

```
Ingest (클레임 추출) → Fact Checker (각 클레임 검증)
```