Come ottengo una API key?

Registrati per un account Airparser gratuito su app.airparser.com. La tua API key è disponibile subito in Settings → API. Il piano gratuito include 20 documenti/mese, senza carta di credito.

Com'è fatta la risposta dell'API?

L'API restituisce un oggetto JSON con 'doc_id', 'status', campi metadata (name, content_type, created_at, processed_at) e un oggetto 'json' contenente i campi estratti. La struttura esatta di 'json' corrisponde allo schema definito per la tua inbox: nomi campo, tipi e nesting sono coerenti su tutti i documenti.

Come funzionano i webhooks?

Configura un webhook URL nelle impostazioni della inbox. Quando un documento termina il parsing, Airparser invia una richiesta POST al tuo URL con il payload JSON completo. Le consegne fallite vengono ritentate automaticamente con exponential backoff. Puoi vedere la cronologia delle consegne e ritentare manualmente dalla dashboard.

Posso analizzare PDF scansionati o basati su immagini?

Sì. Airparser rileva automaticamente se un PDF contiene testo selezionabile o è basato su immagini. Per documenti basati su immagini passa automaticamente al motore Vision LLM o AI OCR, senza configurazione da parte tua.

Esiste un rate limit?

I rate limit dipendono dal piano. Tutti i piani supportano upload batch di documenti. Per uso ad alto volume, migliaia di documenti al giorno, contattaci a support@airparser.com per discutere capacità dedicata.

Posso usare l'API per un workflow di agentic AI?

Sì, in due modi. Primo, la REST API è semplice da chiamare da qualsiasi codice. Secondo, Airparser ha un server MCP (Model Context Protocol), così Claude, Cursor e altri AI agent possono chiamarlo direttamente come tool senza scrivere codice di integrazione.

Dove vengono archiviati i miei dati? È conforme al GDPR?

Airparser archivia i dati in infrastruttura cloud sicura con crittografia AES-256 a riposo e TLS in transito. Non usiamo mai i tuoi documenti o i dati estratti per addestrare modelli IA. La conservazione dati è configurabile per inbox: i documenti vengono eliminati definitivamente dopo il periodo scelto. Siamo conformi al GDPR.

REST API · Webhooks · JSON

Document Extraction API

Una REST API affidabile per estrarre dati strutturati da PDF, e-mail e documenti. Definisci lo schema una volta e ottieni sempre output JSON coerente, con webhooks, retry e conformità GDPR integrati.

Ottieni una API key gratis →Vedi documentazione API

Carica un documento, ottieni JSON strutturato

Richiesta

BASH

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

Risposta

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

Costruita per la produzione, non per prototipi

Schema garantito

Definisci il tuo schema di output una volta. Ogni documento restituisce esattamente la stessa struttura JSON: nessuna variazione di formato, nessuna sorpresa di parsing in produzione.

Consegna via webhook

I risultati vengono inviati al tuo endpoint appena l'estrazione termina. Retry automatici con exponential backoff: nessun polling richiesto.

Fallback multi-motore

LLM testo → LLM visione → AI OCR. Documenti scansionati, PDF basati su immagini e testo manoscritto sono gestiti automaticamente senza configurazione extra.

GDPR di default

Crittografia AES-256, conservazione dati configurabile, nessun training sui tuoi dati, elaborazione basata in UE disponibile. Compliance integrata, non aggiunta dopo.

Post-processing Python

Esegui codice Python personalizzato sui dati estratti prima della consegna: normalizza valori, applica regole di business, arricchisci campi o filtra risultati.

60+ lingue

Estrai dati da documenti in qualsiasi lingua. L'IA comprende contesto e significato dei campi, non solo pattern di caratteri, quindi l'accuratezza regge tra le lingue.

Come funziona l'API

Definisci il tuo schema di estrazione

Descrivi in linguaggio naturale i campi che vuoi estrarre: nome del campo, tipo e breve descrizione. Nessun template, nessun dato di training. Airparser usa queste informazioni per istruire l'IA su cosa estrarre e come formattarlo.

Carica documenti via API o e-mail

POSTa documenti a /api/v1/inboxes/:id/documents tramite upload multipart o base64. Oppure inoltra e-mail al tuo indirizzo inbox Airparser: gli allegati vengono analizzati automaticamente.

Ricevi JSON strutturato

I risultati vengono consegnati al tuo webhook URL come payload JSON corrispondente allo schema. Oppure puoi interrogare l'endpoint documento. Oppure esportare verso Google Sheets, Airtable, HubSpot o qualsiasi app collegata a Zapier.

Tipi di documenti supportati

Ogni formato, selezione automatica del motore

PDF

Nativi e scansionati

E-mail

Corpo e allegati

Immagini

JPG, PNG, TIFF

Word / DOCX

Tutte le versioni

CSV / Excel

Tabelle e fogli

HTML

Pagine web ed e-mail

Manoscritti

Via Vision LLM

Testo semplice

TXT, RTF, MD

Casi d'uso API comuni

Pipeline di elaborazione fatture

Inoltra le fatture dei fornitori alla tua inbox Airparser o inviale via API. Estrai numero fattura, data, fornitore, righe e totali come JSON strutturato. Consegnali al software contabile via webhook o integrazione diretta con QuickBooks, Xero o Google Sheets.

Screening di CV e resume

Analizza CV in arrivo ed estrai nome candidato, contatti, competenze, esperienza lavorativa e istruzione come dati strutturati. Inviali al tuo ATS o CRM via webhook. Funziona con resume PDF, DOCX e testo semplice in qualsiasi lingua.

Lead capture da moduli ed e-mail

Estrai informazioni sui lead da e-mail di richiesta, notifiche di form di contatto o documenti caricati. Normalizza i dati e invia lead strutturati a HubSpot, Salesforce o al tuo CRM via webhook.

Documenti di spedizione e logistica

Analizza polizze di carico, packing list, dichiarazioni doganali e conferme di consegna. Estrai ID spedizione, origini, destinazioni, quantità e stato in JSON strutturato per la tua piattaforma logistica.

Tool documentale per AI agent (via MCP)

Collega Airparser a Claude, Cursor o qualsiasi AI agent compatibile MCP come tool di estrazione documentale. Il tuo agent può caricare documenti e ricevere dati strutturati senza costruire logica di parsing personalizzata: estrazione pienamente conforme al GDPR dentro qualsiasi workflow agentico.

Inizia a estrarre in pochi minuti

Prova gratuita: 20 documenti/mese inclusi. Nessuna carta di credito richiesta.

API key disponibili subito dopo la registrazione.

Ottieni API key →Leggi la documentazione