API REST · Webhooks · JSON

API de extração de documentos

Uma API REST confiável para extrair dados estruturados de PDFs, e-mails e documentos. Defina seu esquema uma vez, obtenha uma saída JSON consistente sempre — com webhooks, reenvios e conformidade com o GDPR incorporados.

Envie um documento, obtenha JSON estruturado

Solicitação

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

Resposta

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

Construído para produção, não para prototipagem

Esquema garantido

Defina seu esquema de saída uma vez. Cada documento retorna exatamente a mesma estrutura JSON — sem variações de formato, sem surpresas de análise em produção.

Entrega por webhook

Os resultados são enviados ao seu endpoint no momento em que a extração é concluída. Reenvios automáticos com backoff exponencial — sem necessidade de polling.

Fallback multi-motor

LLM de texto → LLM de visão → OCR com IA. Documentos digitalizados, PDFs baseados em imagem e texto manuscrito são tratados automaticamente sem configuração extra.

GDPR por padrão

Criptografia AES-256, retenção de dados configurável, nenhum treinamento com seus dados, processamento baseado na UE disponível. Conformidade incorporada, não adicionada depois.

Pós-processamento em Python

Execute código Python personalizado nos dados extraídos antes da entrega — normalize valores, aplique regras de negócio, enriqueça campos ou filtre resultados.

Mais de 60 idiomas

Extraia dados de documentos em qualquer idioma. A IA entende o contexto e o significado dos campos — não apenas padrões de caracteres — então a precisão se mantém entre idiomas.

Como a API funciona

1

Defina seu esquema de extração

Descreva os campos que deseja extrair em linguagem simples — nome do campo, tipo e uma breve descrição. Sem modelos, sem dados de treinamento. A Airparser usa isso para instruir a IA sobre o que extrair e como formatá-lo.

2

Envie documentos via API ou e-mail

Faça POST de documentos para /api/v1/inboxes/:id/documents via upload multipart ou base64. Ou reencaminhe e-mails para o endereço da sua bandeja Airparser — os anexos são analisados automaticamente.

3

Receba JSON estruturado

Os resultados são entregues à URL do seu webhook como um payload JSON correspondente ao seu esquema. Ou consulte o endpoint do documento. Ou exporte para Google Sheets, Airtable, HubSpot, ou qualquer app conectado ao Zapier.

Tipos de documentos suportados

Todo formato, seleção automática de motor

PDF

Nativo e digitalizado

E-mail

Corpo e anexos

Imagens

JPG, PNG, TIFF

Word / DOCX

Todas as versões

CSV / Excel

Tabelas e planilhas

HTML

Páginas web e e-mails

Manuscrito

Via LLM de visão

Texto simples

TXT, RTF, MD

Casos de uso comuns da API

Pipeline de processamento de faturas
Reencaminhe faturas de fornecedores para sua bandeja Airparser ou envie-as via API com POST. Extraia número da fatura, data, fornecedor, itens de linha e totais como JSON estruturado. Entregue ao seu software de contabilidade via webhook ou integração direta com QuickBooks, Xero ou Google Sheets.
Triagem de currículos
Analise currículos recebidos e extraia nome do candidato, dados de contato, habilidades, histórico profissional e formação como dados estruturados. Envie ao seu ATS ou CRM via webhook. Funciona com currículos em PDF, DOCX e texto simples em qualquer idioma.
Captura de leads de formulários e e-mails
Extraia informações de leads de e-mails de consulta, notificações de formulários de contato ou documentos enviados. Normalize os dados e envie leads estruturados para HubSpot, Salesforce ou o CRM da sua escolha via webhook.
Documentos de envio e logística
Analise conhecimentos de embarque, romaneios, declarações alfandegárias e confirmações de entrega. Extraia IDs de remessa, origens, destinos, contagens de itens e status em JSON estruturado para sua plataforma de logística.
Ferramenta de documentos para agentes de IA (via MCP)
Conecte a Airparser ao Claude, Cursor ou qualquer agente de IA compatível com MCP como uma ferramenta de extração de documentos. Seu agente pode enviar documentos e receber dados estruturados sem construir lógica de análise personalizada — extração totalmente compatível com o GDPR dentro de qualquer fluxo de trabalho agêntico.

Comece a extrair em minutos

Teste grátis — 20 documentos/mês incluídos. Nenhum cartão de crédito necessário.

Chaves de API disponíveis imediatamente após o cadastro.

Perguntas frequentes sobre a API

Pronto para expandir seu negócio? É aqui que você começa.