Что это
Lemlist API дает программе доступ к кампаниям и контактам в Lemlist. Через него можно читать данные, управлять разрешенными операциями и получать события для интеграций. Например, собрать внутренний отчет по лидам без ручного копирования из интерфейса.
API не является языковой моделью. Если нужен черновик письма или анализ ответа, эти задачи выполняет отдельная модель либо соответствующий настроенный компонент продукта. Доступ к API не означает, что рассылку можно запускать без проверки адресатов и содержания.
Начинайте с чтения учебной кампании. Перед операциями записи предусмотрите согласование, защиту от повторного добавления контактов и обработку отказа от рассылки. Сначала нужно убедиться, что интеграция правильно читает данные, и лишь затем разрешать ей отправку.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Данные кампаний и контактов доступны для программной интеграции.
- У списка лидов есть фильтр состояния и ограничение размера ответа.
- Webhooks позволяют подключать обработку событий вместо постоянного опроса.
- Заголовки лимитов помогают планировать запросы и повторные попытки.
Ограничения
- Нужны аккаунт и доступ к API по условиям сервиса.
- Операции записи могут затронуть реальные кампании; права и согласование проверяются отдельно.
- Количество запросов ограничено; при повторе нельзя создавать дубли и повторные отправки.
- Ключ и данные контактов требуют защиты; доставляемость писем не гарантируется успешным API-запросом.
Как использовать
1. Подготовка. Выберите учебную кампанию с несколькими тестовыми контактами и без запланированной отправки. Запишите ее campaignId и ожидаемые состояния лидов.
2. Настройка. В Settings > Integrations получите ключ и сохраните его в окружении серверного приложения. Настройте HTTP Basic Auth: имя пользователя пустое, пароль - API-ключ. В заголовке используется Basic с Base64 от строки :KEY, а не Bearer.
3. Первый результат. Выполните GET https://api.lemlist.com/api/campaigns/{campaignId}/leads/?limit=5, подставив свой ID. Получите список ID и состояний лидов; не вызывайте запуск кампании или добавление контактов.
4. Проверка. Сверьте записи с выбранной кампанией в интерфейсе. Пустой список не равен ошибке авторизации: проверьте ID и фильтры. Обработайте неуспешные статусы и ограничение запросов, учитывая Retry-After. Затем подключайте отчет или CRM; запись включайте только после проверки дублей и отписок.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Проверяйте API-доступ и лимиты своего аккаунта Lemlist. Поиск и обогащение данных могут учитывать кредиты отдельно от обычной работы с кампанией. Доступность из России и оплата российскими картами здесь не подтверждены.
Когда не подходит
- Автоматически запускать непроверенную рассылку
- Игнорировать отписки и дубли контактов
- Выдавать полный ключ браузерному виджету
Альтернативы
Apollo API стоит рассмотреть для работы с данными контактов и продаж. Brevo API - для коммуникаций в экосистеме Brevo. HubSpot CRM API - для интеграции с CRM HubSpot. Они не читают кампании Lemlist вместо его API.
