Как получить API-ключ?

Зарегистрируйте бесплатный аккаунт Airparser на app.airparser.com. Ваш API-ключ доступен сразу в разделе «Настройки → API». Бесплатный тариф включает 20 документов в месяц — банковская карта не требуется.

Как выглядит ответ API?

API возвращает объект JSON с полем 'doc_id', 'status', полями метаданных (name, content_type, created_at, processed_at) и объектом 'json', содержащим извлечённые поля. Точная структура 'json' соответствует схеме, определённой для вашего инбокса — названия полей, типы и вложенность согласованы для всех документов.

Как работают вебхуки?

Настройте URL вебхука в настройках инбокса. Когда документ завершает обработку, Airparser отправляет POST-запрос на ваш URL с полной полезной нагрузкой JSON. Неудачные доставки автоматически повторяются с экспоненциальной задержкой. Историю доставки можно просмотреть, а повтор запустить вручную из дашборда.

Можно ли обрабатывать сканированные или основанные на изображениях PDF?

Да. Airparser автоматически определяет, содержит ли PDF выделяемый текст или является изображением. Для документов на основе изображений он автоматически направляется в Vision LLM или ИИ-OCR движок — настройка с вашей стороны не требуется.

Есть ли ограничение по частоте запросов?

Ограничения по частоте запросов зависят от тарифа. Все тарифы поддерживают пакетную загрузку документов. Для сценариев с большими объёмами (тысячи документов в день) свяжитесь с нами по адресу support@airparser.com, чтобы обсудить выделенные мощности.

Можно ли использовать API для агентного ИИ-процесса?

Да — двумя способами. Во-первых, REST API легко вызывать из любого кода. Во-вторых, у Airparser есть сервер MCP (Model Context Protocol), поэтому Claude, Cursor и другие ИИ-агенты могут вызывать его напрямую как инструмент без написания кода интеграции.

Где хранятся мои данные? Соответствует ли это GDPR?

Airparser хранит данные на защищённой облачной инфраструктуре с шифрованием AES-256 при хранении и TLS при передаче. Мы никогда не используем ваши документы или извлечённые данные для обучения ИИ-моделей. Срок хранения данных настраивается для каждого инбокса — документы окончательно удаляются по истечении выбранного периода. Мы соответствуем GDPR.

REST API · Вебхуки · JSON

API извлечения данных из документов

Надёжный REST API для извлечения структурированных данных из PDF, писем и документов. Определите схему один раз, получайте согласованный вывод JSON каждый раз — со встроенными вебхуками, повторами и соответствием GDPR.

Получить API-ключ бесплатно →Смотреть документацию API

Загрузите документ, получите структурированный 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 → vision LLM → ИИ-OCR. Сканированные документы, PDF на основе изображений и рукописный текст обрабатываются автоматически без дополнительной настройки.

GDPR по умолчанию

Шифрование AES-256, настраиваемый срок хранения данных, отсутствие обучения на ваших данных, доступна обработка в ЕС. Соответствие встроено, а не добавлено сверху.

Пост-обработка на Python

Запускайте кастомный код Python над извлечёнными данными перед доставкой — нормализуйте значения, применяйте бизнес-правила, обогащайте поля или фильтруйте результаты.

60+ языков

Извлекайте данные из документов на любом языке. ИИ понимает контекст и смысл полей — а не только символьные паттерны, — поэтому точность сохраняется на всех языках.

Как работает API

Определите схему извлечения

Опишите нужные поля обычным языком — название поля, тип и краткое описание. Без шаблонов, без обучающих данных. Airparser использует это, чтобы указать ИИ, что извлекать и как форматировать.

Загружайте документы через API или email

Отправляйте документы через POST на /api/v1/inboxes/:id/documents через multipart-загрузку или base64. Или пересылайте письма на адрес инбокса Airparser — вложения обрабатываются автоматически.

Получайте структурированный JSON

Результаты доставляются на URL вашего вебхука в виде полезной нагрузки JSON, соответствующей вашей схеме. Либо опрашивайте эндпоинт документа. Либо экспортируйте в Google Sheets, Airtable, HubSpot или любое приложение, подключённое через Zapier.

Поддерживаемые типы документов

Любой формат, автоматический выбор движка

PDF

Нативные и сканированные

Тело и вложения

Изображения

JPG, PNG, TIFF

Word / DOCX

Все версии

CSV / Excel

Таблицы и листы

HTML

Веб-страницы и письма

Рукописные

Через Vision LLM

Обычный текст

TXT, RTF, MD

Частые сценарии использования API

Конвейер обработки счетов

Пересылайте счета от поставщиков на инбокс Airparser или отправляйте их через API. Извлекайте номер счёта, дату, поставщика, позиции и суммы как структурированный JSON. Доставляйте в бухгалтерское ПО через вебхук или прямую интеграцию с QuickBooks, Xero или Google Sheets.

Отбор резюме / CV

Обрабатывайте входящие CV, извлекая имя кандидата, контактные данные, навыки, опыт работы и образование как структурированные данные. Отправляйте в вашу ATS или CRM через вебхук. Работает с резюме в PDF, DOCX и обычном тексте на любом языке.

Сбор лидов из форм и писем

Извлекайте информацию о лидах из писем с запросами, уведомлений контактных форм или загруженных документов. Нормализуйте данные и отправляйте структурированных лидов в HubSpot, Salesforce или вашу CRM через вебхук.

Документы доставки и логистики

Обрабатывайте товарно-транспортные накладные, упаковочные листы, таможенные декларации и подтверждения доставки. Извлекайте ID отправлений, пункты отправления и назначения, количество товаров и статус в структурированный JSON для вашей логистической платформы.

Инструмент документов для ИИ-агентов (через MCP)

Подключите Airparser к Claude, Cursor или любому MCP-совместимому ИИ-агенту как инструмент извлечения документов. Ваш агент может загружать документы и получать структурированные данные без разработки кастомной логики парсинга — полностью GDPR-совместимое извлечение внутри любого агентного процесса.

Начните извлекать данные за минуты

Бесплатный пробный период — 20 документов в месяц включено. Банковская карта не требуется.

API-ключи доступны сразу после регистрации.

Получить API-ключ →Читать документацию