Обзор API LanderLab - LanderLab Docs

API LanderLab даёт программный доступ ко всему вашему аккаунту. Через HTTP можно создавать и публиковать лендинги, получать данные лидов, читать аналитику, управлять вариантами A/B-тестов, настраивать интеграции и многое другое. Если вы предпочитаете работать обычными словами, а не писать вызовы API вручную, MCP-сервер подключает вашего AI-ассистента напрямую к LanderLab через тот же API. Вход выполняется через аккаунт LanderLab, поэтому API-ключ не нужен.

Базовый URL

Все запросы к API отправляются на:

https://api.landerlab.dev

Текущая версия API — v2. Все эндпоинты начинаются с префикса /api/v2/.

Аутентификация

API использует аутентификацию по API-ключу. Передавайте ключ в заголовке X-API-Key в каждом запросе.

X-API-Key: ll_live_YOUR_KEY_HERE

Ключ начинается с ll_live_ и привязан к вашей организации. Все запросы ограничены организацией, которой принадлежит ключ, поэтому в большинстве вызовов ID организации отдельно передавать не нужно.

API-ключи показываются только один раз при создании. Если вы потеряли ключ, нужно сгенерировать новый. Шаги см. в разделе Генерация API-ключа.

Ответы с ошибками

Все эндпоинты возвращают стандартные HTTP-коды состояния.

Код	Значение
`200`	Успех
`400`	Неверный запрос (некорректные параметры или достигнут лимит тарифа)
`401`	Не авторизован (API-ключ отсутствует или недействителен)
`403`	Доступ запрещён (у ключа нет доступа к этому ресурсу)
`404`	Не найдено

Ответы с ошибками содержат в теле строку error с описанием проблемы.

Группы ресурсов

API организован по следующим группам ресурсов. Каждая группа соответствует разделу в справочнике API.

Рабочие пространства

Просмотр, создание и переименование рабочих пространств в вашей организации. Рабочие пространства — контейнер верхнего уровня для лендингов, лидов и доменов.

Эндпоинт	Описание
`GET /api/v2/organizations/{organizationId}/workspaces/get`	Список всех рабочих пространств
`POST /api/v2/organizations/{organizationId}/workspaces/create`	Создать рабочее пространство
`POST /api/v2/workspaces/{workspaceId}/rename`	Переименовать рабочее пространство

Лендинги

Управление лендингами: просмотр списка, создание, переименование, публикация, снятие с публикации и удаление. Для публикации нужны домен и путь; если превышены лимиты тарифа или путь уже занят, вернётся ошибка 400.

Эндпоинт	Описание
`GET /api/v2/workspaces/{workspaceId}/landers/get`	Список лендингов в рабочем пространстве
`POST /api/v2/workspaces/{workspaceId}/landers/create`	Создать лендинг
`POST /api/v2/landers/{landerId}/publish`	Опубликовать лендинг
`POST /api/v2/landers/{landerId}/unpublish`	Снять лендинг с публикации
`DELETE /api/v2/landers/{landerId}`	Удалить лендинг со всеми его вариантами

При удалении лендинга все связанные варианты, файлы и интеграции удаляются безвозвратно.

A/B-тестирование (варианты)

У каждого лендинга есть один или несколько вариантов. Основной (master) вариант получает трафик, когда A/B-тестирование выключено. Когда A/B-тестирование включено, трафик распределяется между вариантами согласно заданным весам.

Эндпоинт	Описание
`GET /api/v2/landers/{landerId}/variants`	Список всех вариантов
`POST /api/v2/variants/{variantId}/clone`	Клонировать вариант
`POST /api/v2/landers/{landerId}/ab-testing/enable`	Включить A/B-тестирование
`POST /api/v2/landers/{landerId}/ab-testing/disable`	Выключить A/B-тестирование
`POST /api/v2/landers/{landerId}/ab-testing/weights`	Задать веса распределения трафика
`POST /api/v2/variants/{variantId}/set-master`	Сделать вариант основным
`DELETE /api/v2/variants/{variantId}`	Удалить вариант

Удалить основной вариант нельзя. Сначала назначьте основным другой вариант.

Редактор

Загрузка и сохранение HTML-содержимого и настроек конкретного варианта. При сохранении HTML изображения в base64 извлекаются, а версии создаются автоматически.

Эндпоинт	Описание
`GET /api/v2/variants/{variantId}/editor/load`	Загрузить HTML, настройки, формы и метаданные
`POST /api/v2/variants/{variantId}/editor/save`	Сохранить HTML-содержимое
`POST /api/v2/variants/{variantId}/editor/settings`	Сохранить настройки варианта (интеграции, SEO, отслеживание)

Лиды

Получение лидов на уровне рабочего пространства или организации. Лиды выдаются постранично и фильтруются по диапазону дат, статусу (complete или partial), лендингу и поисковому запросу. Максимальный размер страницы — 1000 записей за запрос.

Эндпоинт	Описание
`GET /api/v2/workspaces/{workspaceId}/leads/get`	Список лидов рабочего пространства
`GET /api/v2/organizations/{organizationId}/leads/get`	Список лидов по всей организации
`GET /api/v2/landers/{landerId}/lead-schema`	Получить JSON Schema лидов лендинга
`POST /api/v2/landers/lead-schema`	Получить JSON Schema для нескольких лендингов

Эндпоинты схемы лидов возвращают JSON Schema Draft-07, описывающую все возможные поля лида с этого лендинга: поля форм, ответы квизов, системные поля и поля интеграций.

Аналитика

Один гибкий эндпоинт покрывает все задачи аналитики. Фильтровать можно по рабочему пространству, лендингу или варианту. Побеждает самый конкретный фильтр: если передать variantIds, фильтры по рабочему пространству и лендингу игнорируются.

Эндпоинт	Описание
`POST /api/v2/organizations/{organizationId}/analytics/get`	Получить аналитику с диапазоном дат, часовым поясом и необязательной группировкой

Обязательные параметры: startDate, endDate, timezone (формат IANA, например America/New_York). Необязательные фильтры: workspaceIds, landerIds, variantIds. Группировка: date, lander, variant или workspace. По умолчанию — date.

Домены

Просмотр доменов на уровне рабочего пространства или организации.

Эндпоинт	Описание
`GET /api/v2/workspaces/{workspaceId}/domains/get`	Список доменов рабочего пространства
`GET /api/v2/organizations/{organizationId}/domains/get`	Список всех доменов организации

Папки

Организация лендингов по папкам внутри рабочего пространства.

Эндпоинт	Описание
`GET /api/v2/workspaces/{workspaceId}/folders`	Список всех папок
`POST /api/v2/workspaces/{workspaceId}/folders/create`	Создать папку
`POST /api/v2/folders/{folderId}/rename`	Переименовать папку

Интеграции

Создание и просмотр интеграций на уровне организации, а затем включение или отключение их для отдельных лендингов. Интеграции на основе OAuth (Mailchimp, HubSpot, Google Sheets, AWeber) требуют интерактивной авторизации OAuth и не могут быть созданы напрямую через API.

Эндпоинт	Описание
`GET /api/v2/organizations/{organizationId}/integrations`	Список всех интеграций
`POST /api/v2/organizations/{organizationId}/integrations/create`	Создать интеграцию
`POST /api/v2/lander-integrations/{id}/enable`	Включить интеграцию лендинга
`POST /api/v2/lander-integrations/{id}/disable`	Отключить интеграцию лендинга
`DELETE /api/v2/lander-integrations/{id}`	Удалить интеграцию с лендинга

Спецификация OpenAPI и интерактивная документация

Полная спецификация OpenAPI 3.1 доступна по адресу:

https://backend-v2.landerlab.workers.dev/api/v2/openapi.json

Интерактивная документация API (со встроенным тестером запросов) находится здесь:

https://api.landerlab.dev/api/v2/docs

Работа с API через AI-ассистента (MCP)

Если вы хотите управлять аккаунтом LanderLab обычными словами, а не писать вызовы API, MCP-сервер LanderLab построен на том же API и предоставляет более 30 инструментов любому MCP-совместимому AI-ассистенту, включая Claude, ChatGPT, Cursor и Windsurf. URL MCP-сервера:

https://api.landerlab.dev/mcp

Авторизация проходит через вход в браузере, а не через заголовок X-API-Key, поэтому API-ключ не требуется. Инструкции по настройке см. в разделе Подключение AI-ассистентов через MCP.

​Базовый URL

​Аутентификация

​Ответы с ошибками

​Группы ресурсов

​Рабочие пространства

​Лендинги

​A/B-тестирование (варианты)

​Редактор

​Лиды

​Аналитика

​Домены

​Папки

​Интеграции

​Спецификация OpenAPI и интерактивная документация

​Работа с API через AI-ассистента (MCP)

Базовый URL

Аутентификация

Ответы с ошибками

Группы ресурсов

Рабочие пространства

Лендинги

A/B-тестирование (варианты)

Редактор

Лиды

Аналитика

Домены

Папки

Интеграции

Спецификация OpenAPI и интерактивная документация

Работа с API через AI-ассистента (MCP)