API REST · Webhooks · JSON

API de extracción de documentos

Una API REST fiable para extraer datos estructurados de PDFs, emails y documentos. Defina su esquema una vez y obtenga JSON consistente cada vez, con webhooks, reintentos y compatibilidad GDPR integrados.

Suba un documento y obtenga JSON estructurado

Solicitud

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

Respuesta

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

Construida para producción, no para prototipos

Esquema garantizado

Defina su esquema de salida una vez. Cada documento devuelve exactamente la misma estructura JSON: sin variaciones de formato ni sorpresas de parsing en producción.

Entrega por webhook

Los resultados se envían a su endpoint en cuanto termina la extracción. Reintentos automáticos con backoff exponencial, sin necesidad de polling.

Fallback multi-engine

Text LLM → Vision LLM → AI OCR. Documentos escaneados, PDFs basados en imagen y texto manuscrito se gestionan automáticamente sin configuración adicional.

GDPR por defecto

Cifrado AES-256, retención de datos configurable, sin entrenamiento con sus datos, procesamiento basado en la UE disponible. Cumplimiento integrado, no añadido después.

Postprocesamiento en Python

Ejecute código Python personalizado sobre los datos extraídos antes de entregarlos: normalice valores, aplique reglas de negocio, enriquezca campos o filtre resultados.

60+ idiomas

Extraiga datos de documentos en cualquier idioma. La IA entiende el contexto y el significado de los campos, no solo patrones de caracteres, por lo que la precisión se mantiene entre idiomas.

Cómo funciona la API

1

Defina su esquema de extracción

Describa los campos que quiere extraer en lenguaje natural: nombre de campo, tipo y breve descripción. Sin plantillas, sin datos de entrenamiento. Airparser usa esto para indicar a la IA qué extraer y cómo formatearlo.

2

Suba documentos por API o email

Envíe documentos por POST a /api/v1/inboxes/:id/documents mediante multipart upload o base64. O reenvíe emails a su dirección de bandeja de Airparser: los adjuntos se parsean automáticamente.

3

Reciba JSON estructurado

Los resultados se entregan a su URL webhook como payload JSON que coincide con su esquema. O consulte el endpoint del documento. O exporte a Google Sheets, Airtable, HubSpot o cualquier app conectada por Zapier.

Tipos de documentos soportados

Todos los formatos, selección automática de engine

PDF

Nativo y escaneado

Email

Cuerpo y adjuntos

Imágenes

JPG, PNG, TIFF

Word / DOCX

Todas las versiones

CSV / Excel

Tablas y hojas

HTML

Páginas web y emails

Manuscrito

Mediante Vision LLM

Texto plano

TXT, RTF, MD

Casos de uso comunes de la API

Pipeline de procesamiento de facturas
Reenvíe facturas de proveedores a su bandeja de Airparser o súbalas por API. Extraiga número de factura, fecha, proveedor, líneas de detalle y totales como JSON estructurado. Envíelo a su software contable por webhook o integración directa con QuickBooks, Xero o Google Sheets.
Cribado de CVs
Parsee CVs entrantes y extraiga nombre del candidato, datos de contacto, habilidades, experiencia laboral y educación como datos estructurados. Envíelos a su ATS o CRM por webhook. Funciona con CVs en PDF, DOCX y texto plano en cualquier idioma.
Captura de leads desde formularios y emails
Extraiga información de leads desde emails de consulta, notificaciones de formularios de contacto o documentos subidos. Normalice los datos y envíe leads estructurados a HubSpot, Salesforce o su CRM preferido por webhook.
Documentos de transporte y logística
Parsee conocimientos de embarque, albaranes, declaraciones aduaneras y confirmaciones de entrega. Extraiga IDs de envío, orígenes, destinos, cantidades y estado en JSON estructurado para su plataforma logística.
Herramienta documental para agentes IA (vía MCP)
Conecte Airparser a Claude, Cursor o cualquier agente IA compatible con MCP como herramienta de extracción de documentos. Su agente puede subir documentos y recibir datos estructurados sin construir lógica de parsing personalizada, con extracción plenamente compatible con GDPR dentro de cualquier workflow agentic.

Empiece a extraer en minutos

Prueba gratuita: 20 documentos/mes incluidos. Sin tarjeta requerida.

Claves API disponibles inmediatamente después del registro.

Preguntas frecuentes sobre la API

¿Listo para hacer crecer tu negocio? Todo empieza aquí.