REST API · Webhooki · JSON

Document Extraction API

Niezawodne REST API do wyodrębniania ustrukturyzowanych danych z PDF, e-maili i dokumentów. Zdefiniuj schemat raz i zawsze otrzymuj spójne dane wyjściowe JSON, z wbudowanymi webhookami, ponowieniami i zgodnością z RODO.

Prześlij dokument, otrzymaj ustrukturyzowany JSON

Żądanie

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

Odpowiedź

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
      }
    ]
  }
}

Zbudowane dla produkcji, nie dla prototypów

Gwarantowany schemat

Zdefiniuj swój schemat danych wyjściowych raz. Każdy dokument zwraca dokładnie tę samą strukturę JSON: bez odchyleń formatu, bez niespodzianek parsowania w produkcji.

Dostarczanie przez webhook

Wyniki są wysyłane do Twojego endpointu, gdy tylko ekstrakcja się zakończy. Automatyczne ponowienia z wykładniczym opóźnieniem: bez potrzeby pollingu.

Wielosilnikowy fallback

Tekstowy LLM → wizyjny LLM → AI OCR. Zeskanowane dokumenty, PDF oparte na obrazach i odręczny tekst są obsługiwane automatycznie bez dodatkowej konfiguracji.

Domyślnie RODO

Szyfrowanie AES-256, konfigurowalne przechowywanie danych, brak trenowania na Twoich danych, dostępne przetwarzanie w UE. Wbudowana zgodność, nie dodana później.

Post-processing w Pythonie

Uruchom niestandardowy kod Python na wyodrębnionych danych przed dostarczeniem: normalizuj wartości, stosuj reguły biznesowe, wzbogacaj pola lub filtruj wyniki.

Ponad 60 języków

Wyodrębniaj dane z dokumentów w dowolnym języku. AI rozumie kontekst i znaczenie pól, nie tylko wzorce znaków, więc dokładność utrzymuje się między językami.

Jak działa API

1

Zdefiniuj swój schemat ekstrakcji

Opisz w języku naturalnym pola, które chcesz wyodrębnić: nazwę pola, typ i krótki opis. Bez szablonów, bez danych treningowych. Airparser wykorzystuje te informacje, aby poinstruować AI, co wyodrębnić i jak to sformatować.

2

Prześlij dokumenty przez API lub e-mail

Wykonaj POST dokumentów do /api/v1/inboxes/:id/documents przez przesyłanie multipart lub base64. Lub przekaż e-maile na swój adres skrzynki odbiorczej Airparser: załączniki są analizowane automatycznie.

3

Otrzymaj ustrukturyzowany JSON

Wyniki są dostarczane do Twojego URL webhooka jako ładunek JSON odpowiadający schematowi. Lub możesz odpytać endpoint dokumentu. Lub eksportować do Google Sheets, Airtable, HubSpot lub dowolnej aplikacji połączonej przez Zapier.

Obsługiwane typy dokumentów

Każdy format, automatyczny wybór silnika

PDF

Natywne i zeskanowane

E-mail

Treść i załączniki

Obrazy

JPG, PNG, TIFF

Word / DOCX

Wszystkie wersje

CSV / Excel

Tabele i arkusze

HTML

Strony internetowe i e-maile

Odręczne

Przez Vision LLM

Zwykły tekst

TXT, RTF, MD

Częste przypadki użycia API

Potok przetwarzania faktur
Przekaż faktury od dostawców do swojej skrzynki odbiorczej Airparser lub wyślij je przez API. Wyodrębnij numer faktury, datę, dostawcę, pozycje i sumy jako ustrukturyzowany JSON. Dostarcz je do oprogramowania księgowego przez webhook lub bezpośrednią integrację z QuickBooks, Xero czy Google Sheets.
Weryfikacja CV i życiorysów
Analizuj przychodzące CV i wyodrębnij imię kandydata, dane kontaktowe, umiejętności, doświadczenie zawodowe i wykształcenie jako ustrukturyzowane dane. Wyślij je do swojego ATS lub CRM przez webhook. Działa z CV w PDF, DOCX i zwykłym tekście w dowolnym języku.
Przechwytywanie leadów z formularzy i e-maili
Wyodrębniaj informacje o leadach z e-maili z zapytaniami, powiadomień formularzy kontaktowych lub przesłanych dokumentów. Normalizuj dane i wysyłaj ustrukturyzowane leady do HubSpot, Salesforce lub swojego CRM przez webhook.
Dokumenty wysyłkowe i logistyczne
Analizuj listy przewozowe, listy pakowania, deklaracje celne i potwierdzenia dostawy. Wyodrębnij ID wysyłki, miejsca pochodzenia, cele, ilości i status w ustrukturyzowanym JSON dla swojej platformy logistycznej.
Narzędzie dokumentowe dla agenta AI (przez MCP)
Połącz Airparser z Claude, Cursor lub dowolnym agentem AI kompatybilnym z MCP jako narzędzie do ekstrakcji dokumentów. Twój agent może przesyłać dokumenty i otrzymywać ustrukturyzowane dane bez budowania niestandardowej logiki parsowania: w pełni zgodna z RODO ekstrakcja w ramach dowolnego przepływu pracy agentowego.

Zacznij wyodrębniać dane w kilka minut

Bezpłatny okres próbny: 20 dokumentów/miesiąc w zestawie. Karta kredytowa niewymagana.

Klucze API dostępne od razu po rejestracji.

Często zadawane pytania o API

Gotowy, by rozwijać swoją firmę? Zacznij tutaj.