REST API · 웹훅 · JSON

문서 추출 API

PDF, 이메일, 문서에서 구조화된 데이터를 추출하는 신뢰할 수 있는 REST API입니다. 스키마를 한 번 정의하면 매번 일관된 JSON 출력을 받을 수 있습니다 — 웹훅, 재시도, GDPR 준수가 내장되어 있습니다.

문서를 업로드하고 구조화된 JSON을 받으세요

요청

BASH
curl -X POST https://api.airparser.com/inboxes/INBOX_ID/upload-sync \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]"

응답

JSON
{
  "doc_id": "64abc123def456...",
  "parsing_in_progress": false,
  "status": "parsed",
  "name": "invoice.pdf",
  "content_type": "application/pdf",
  "created_at": "2026-03-10T12:00:00.000Z",
  "processed_at": "2026-03-10T12:00:04.321Z",
  "json": {
    "invoice_number": "INV-2024-0042",
    "invoice_date": "2024-03-15",
    "vendor_name": "Acme Supplies Ltd",
    "total_amount": 1284.50,
    "currency": "USD",
    "due_date": "2024-04-14",
    "line_items": [
      {
        "description": "Office supplies",
        "quantity": 3,
        "unit_price": 428.17,
        "total": 1284.50
      }
    ]
  }
}

프로토타이핑이 아닌 프로덕션을 위해 구축됨

보장된 스키마

출력 스키마를 한 번 정의하세요. 모든 문서는 정확히 동일한 JSON 구조를 반환합니다 — 형식 변형도, 프로덕션에서의 분석 예상치 못한 문제도 없습니다.

웹훅 전달

추출이 완료되는 즉시 엔드포인트로 결과가 전송됩니다. 지수 백오프를 통한 자동 재시도 — 폴링이 필요 없습니다.

다중 엔진 폴백

텍스트 LLM → 비전 LLM → AI OCR. 스캔 문서, 이미지 기반 PDF, 손글씨 텍스트가 추가 설정 없이 자동으로 처리됩니다.

기본으로 GDPR

AES-256 암호화, 조정 가능한 데이터 보관, 데이터로 학습하지 않음, EU 기반 처리 가능. 규정 준수가 나중에 추가된 것이 아니라 내장되어 있습니다.

Python 후처리

전달되기 전에 추출된 데이터에서 맞춤 Python 코드를 실행하세요 — 값을 정규화하고, 비즈니스 규칙을 적용하고, 필드를 강화하거나 결과를 필터링하세요.

60개 이상 언어

모든 언어의 문서에서 데이터를 추출하세요. AI는 단순한 문자 패턴이 아닌 맥락과 필드 의미를 이해하므로 언어에 관계없이 정확도가 유지됩니다.

API 작동 방식

1

추출 스키마 정의

추출하려는 필드를 일반 언어로 설명하세요 — 필드명, 유형, 간단한 설명. 템플릿도, 학습 데이터도 필요 없습니다. Airparser는 이를 사용하여 무엇을 추출하고 어떻게 서식화할지 AI에 지시합니다.

2

API나 이메일로 문서 업로드

멀티파트 업로드나 base64를 통해 /api/v1/inboxes/:id/documents 로 문서를 POST하세요. 또는 이메일을 Airparser 수신함 주소로 전달하세요 — 첨부파일이 자동으로 분석됩니다.

3

구조화된 JSON 수신

결과는 스키마와 일치하는 JSON 페이로드로 웹훅 URL에 전달됩니다. 또는 문서 엔드포인트를 폴링하세요. 또는 Google 시트, Airtable, HubSpot 또는 Zapier에 연결된 모든 앱으로 내보내세요.

지원되는 문서 유형

모든 형식, 자동 엔진 선택

PDF

네이티브 및 스캔본

이메일

본문 및 첨부파일

이미지

JPG, PNG, TIFF

Word / DOCX

모든 버전

CSV / Excel

테이블 및 시트

HTML

웹 페이지 및 이메일

손글씨

비전 LLM을 통해

일반 텍스트

TXT, RTF, MD

일반적인 API 사용 사례

송장 처리 파이프라인
공급업체 송장을 Airparser 수신함으로 전달하거나 API를 통해 POST하세요. 송장 번호, 날짜, 공급업체, 항목, 총액을 구조화된 JSON으로 추출하세요. 웹훅이나 QuickBooks, Xero, Google 시트와의 직접 통합을 통해 회계 소프트웨어로 전달하세요.
이력서/CV 심사
수신되는 CV를 분석하여 지원자 이름, 연락처, 기술, 경력, 학력을 구조화된 데이터로 추출하세요. 웹훅을 통해 ATS나 CRM으로 전달하세요. PDF, DOCX, 일반 텍스트 이력서를 모든 언어로 처리합니다.
양식 및 이메일로부터의 잠재 고객 확보
문의 이메일, 문의 양식 알림 또는 업로드된 문서에서 잠재 고객 정보를 추출하세요. 데이터를 정규화하고 웹훅을 통해 구조화된 잠재 고객을 HubSpot, Salesforce 또는 원하는 CRM으로 전달하세요.
배송 및 물류 문서
선하증권, 포장 명세서, 통관 신고서, 배송 확인서를 분석하세요. 물류 플랫폼을 위해 배송 ID, 출발지, 목적지, 항목 수, 상태를 구조화된 JSON으로 추출하세요.
AI 에이전트 문서 도구(MCP를 통해)
Airparser를 Claude, Cursor 또는 모든 MCP 호환 AI 에이전트에 문서 추출 도구로 연결하세요. 에이전트는 맞춤 분석 로직을 구축하지 않고도 문서를 업로드하고 구조화된 데이터를 받을 수 있습니다 — 모든 에이전틱 워크플로우 내에서 완전히 GDPR을 준수하는 추출입니다.

몇 분 안에 추출을 시작하세요

무료 체험 — 월 20건의 문서 포함. 신용카드 불필요.

가입 후 즉시 API 키를 사용할 수 있습니다.

API 자주 묻는 질문

비즈니스를 성장시킬 준비가 되셨나요? 여기서 시작하세요.