Visão geral da API do LanderLab - Landerlab Documentation

A API do LanderLab oferece acesso programático a toda a sua conta. Você pode criar e publicar landers, obter dados de leads, ler análises, gerenciar variantes de teste A/B, configurar integrações e muito mais, tudo via HTTP. Se você prefere trabalhar em linguagem natural em vez de escrever chamadas de API manualmente, o servidor MCP conecta seu assistente de IA diretamente ao LanderLab usando a mesma API por trás. Ele faz login com a sua conta do LanderLab, então nenhuma chave de API é necessária.

URL base

Todas as requisições da API vão para:

https://api.landerlab.dev

A versão atual da API é a v2. Todos os endpoints têm o prefixo /api/v2/.

Autenticação

A API usa autenticação por chave de API. Inclua sua chave no cabeçalho X-API-Key em todas as requisições.

X-API-Key: ll_live_YOUR_KEY_HERE

Sua chave começa com ll_live_ e está vinculada à sua organização. Todas as requisições ficam restritas à organização à qual a chave pertence, então, na maioria das chamadas, você não precisa informar um ID de organização separadamente.

As chaves de API são exibidas apenas uma vez, no momento da criação. Se você perder a sua, precisará gerar uma nova. Veja Gerar uma chave de API para conferir o passo a passo.

Respostas de erro

Todos os endpoints retornam códigos de status HTTP padrão.

Código	Significado
`200`	Sucesso
`400`	Requisição inválida (parâmetros inválidos ou limite do plano atingido)
`401`	Não autorizado (chave de API ausente ou inválida)
`403`	Proibido (a chave não tem acesso a este recurso)
`404`	Não encontrado

As respostas de erro incluem uma string error no corpo da resposta com a descrição do problema.

Grupos de recursos

A API é organizada nos grupos de recursos a seguir. Cada grupo corresponde a uma seção da referência da API.

Espaços de trabalho

Liste, crie e renomeie espaços de trabalho dentro da sua organização. Os espaços de trabalho são o contêiner de nível mais alto para landers, leads e domínios.

Endpoint	Descrição
`GET /api/v2/organizations/{organizationId}/workspaces/get`	Lista todos os espaços de trabalho
`POST /api/v2/organizations/{organizationId}/workspaces/create`	Cria um espaço de trabalho
`POST /api/v2/workspaces/{workspaceId}/rename`	Renomeia um espaço de trabalho

Landers

Gerencie landing pages: liste, crie, renomeie, publique, despublique e exclua. A publicação exige um domínio e um caminho e retornará 400 se os limites do plano forem excedidos ou se o caminho já estiver em uso.

Endpoint	Descrição
`GET /api/v2/workspaces/{workspaceId}/landers/get`	Lista os landers de um espaço de trabalho
`POST /api/v2/workspaces/{workspaceId}/landers/create`	Cria um lander
`POST /api/v2/landers/{landerId}/publish`	Publica um lander
`POST /api/v2/landers/{landerId}/unpublish`	Despublica um lander
`DELETE /api/v2/landers/{landerId}`	Exclui um lander e todas as suas variantes

Excluir um lander remove permanentemente todas as variantes, arquivos e integrações associados.

Teste A/B (variantes)

Cada lander tem uma ou mais variantes. A variante master (principal) é a que recebe o tráfego quando o teste A/B está desativado. Quando o teste A/B está ativado, o tráfego é dividido entre as variantes de acordo com os pesos que você definir.

Endpoint	Descrição
`GET /api/v2/landers/{landerId}/variants`	Lista todas as variantes
`POST /api/v2/variants/{variantId}/clone`	Clona uma variante
`POST /api/v2/landers/{landerId}/ab-testing/enable`	Ativa o teste A/B
`POST /api/v2/landers/{landerId}/ab-testing/disable`	Desativa o teste A/B
`POST /api/v2/landers/{landerId}/ab-testing/weights`	Define os pesos da divisão de tráfego
`POST /api/v2/variants/{variantId}/set-master`	Promove uma variante a master
`DELETE /api/v2/variants/{variantId}`	Exclui uma variante

Não é possível excluir a variante master. Primeiro, promova outra variante a master.

Editor

Carregue e salve o conteúdo HTML e as configurações de uma variante específica. Ao salvar o HTML, a extração de imagens em base64 e o versionamento são feitos automaticamente.

Endpoint	Descrição
`GET /api/v2/variants/{variantId}/editor/load`	Carrega HTML, configurações, formulários e metadados
`POST /api/v2/variants/{variantId}/editor/save`	Salva o conteúdo HTML
`POST /api/v2/variants/{variantId}/editor/settings`	Salva as configurações da variante (integrações, SEO, rastreamento)

Leads

Obtenha leads no nível do espaço de trabalho ou da organização. Os leads são paginados e podem ser filtrados por intervalo de datas, status (complete ou partial), lander e termo de busca. O tamanho máximo de página é de 1000 por requisição.

Endpoint	Descrição
`GET /api/v2/workspaces/{workspaceId}/leads/get`	Lista os leads de um espaço de trabalho
`GET /api/v2/organizations/{organizationId}/leads/get`	Lista os leads de toda a organização
`GET /api/v2/landers/{landerId}/lead-schema`	Obtém o JSON Schema dos leads de um lander
`POST /api/v2/landers/lead-schema`	Obtém o JSON Schema de vários landers

Os endpoints de schema de leads retornam um JSON Schema Draft-07 que descreve todos os campos possíveis que um lead desse lander pode conter, incluindo campos de formulário, respostas de quiz, campos do sistema e campos de integração.

Análises

Um único endpoint flexível atende a todas as necessidades de análise. Filtre por espaço de trabalho, lander ou variante. O filtro mais específico prevalece: se você informar variantIds, os filtros de espaço de trabalho e de lander serão ignorados.

Endpoint	Descrição
`POST /api/v2/organizations/{organizationId}/analytics/get`	Obtém análises com intervalo de datas, fuso horário e agrupamento opcional

Parâmetros obrigatórios: startDate, endDate, timezone (formato IANA, por exemplo, America/New_York). Filtros opcionais: workspaceIds, landerIds, variantIds. Agrupar por: date, lander, variant ou workspace. O padrão é date.

Domínios

Liste domínios no nível do espaço de trabalho ou da organização.

Endpoint	Descrição
`GET /api/v2/workspaces/{workspaceId}/domains/get`	Lista os domínios de um espaço de trabalho
`GET /api/v2/organizations/{organizationId}/domains/get`	Lista todos os domínios da organização

Pastas

Organize landers em pastas dentro de um espaço de trabalho.

Endpoint	Descrição
`GET /api/v2/workspaces/{workspaceId}/folders`	Lista todas as pastas
`POST /api/v2/workspaces/{workspaceId}/folders/create`	Cria uma pasta
`POST /api/v2/folders/{folderId}/rename`	Renomeia uma pasta

Integrações

Crie e liste integrações no nível da organização e, depois, ative ou desative cada uma por lander. Integrações baseadas em OAuth (Mailchimp, HubSpot, Google Sheets, AWeber) exigem um fluxo OAuth interativo e não podem ser criadas diretamente pela API.

Endpoint	Descrição
`GET /api/v2/organizations/{organizationId}/integrations`	Lista todas as integrações
`POST /api/v2/organizations/{organizationId}/integrations/create`	Cria uma integração
`POST /api/v2/lander-integrations/{id}/enable`	Ativa uma integração de lander
`POST /api/v2/lander-integrations/{id}/disable`	Desativa uma integração de lander
`DELETE /api/v2/lander-integrations/{id}`	Remove uma integração de um lander

Especificação OpenAPI e documentação interativa

A especificação completa em OpenAPI 3.1 está disponível em:

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

A documentação interativa da API (com um testador de requisições integrado) está em:

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

Como usar a API com um assistente de IA (MCP)

Se você quer gerenciar sua conta do LanderLab em linguagem natural em vez de escrever chamadas de API, o servidor MCP do LanderLab é construído sobre a mesma API e oferece mais de 30 ferramentas para qualquer assistente de IA compatível com MCP, incluindo Claude, ChatGPT, Cursor e Windsurf. A URL do servidor MCP é:

https://api.landerlab.dev/mcp

Ele se autentica por meio de um login no navegador, e não pelo cabeçalho X-API-Key, então nenhuma chave de API é necessária. Veja Conecte assistentes de IA via MCP para conferir as instruções de configuração.

​URL base

​Autenticação

​Respostas de erro

​Grupos de recursos

​Espaços de trabalho

​Landers

​Teste A/B (variantes)

​Editor

​Leads

​Análises

​Domínios

​Pastas

​Integrações

​Especificação OpenAPI e documentação interativa

​Como usar a API com um assistente de IA (MCP)

URL base

Autenticação

Respostas de erro

Grupos de recursos

Espaços de trabalho

Landers

Teste A/B (variantes)

Editor

Leads

Análises

Domínios

Pastas

Integrações

Especificação OpenAPI e documentação interativa

Como usar a API com um assistente de IA (MCP)