API REST — LP Builder v1

Versão 1.0 · disponível apenas no plano Agency · 100 req/dia por chave

Conceito

A API permite que seus sistemas (ou agentes de IA autorizados por você) gerem, leiam e editem landing pages programaticamente. Toda chamada é autenticada por uma chave de API que pertence à sua conta e enxerga apenas seus próprios recursos.

Autenticação

Crie a sua chave em LP Builder → Minha conta → API. A chave plena é mostrada uma única vez — copie e armazene em local seguro (cofre de segredos, variável de ambiente). Você pode revogar a qualquer momento; ao revogar, todas as chamadas com a chave passam a retornar 401.

Envie a chave no header X-API-Key:

X-API-Key: lpk_live_abcdef...

Escopos

Toda chave nova traz os três escopos: generate (criar páginas), read (listar/ler), write (editar/publicar/apagar). Em versões futuras será possível criar chaves com escopo restrito.

Base URL

https://builder.mantovanitec.com/api/v1

Endpoints

POST `/generate`

Cria uma nova landing page a partir de uma descrição em linguagem natural.

Body: { "description": "..." } (até 2000 caracteres).

Exemplo:

curl -X POST https://builder.mantovanitec.com/api/v1/generate \
  -H "X-API-Key: $LP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"Landing page para clínica odontológica em Bauru, foco em implantes, cores azul e branco"}'

Resposta:

{
  "id": "clxxx...",
  "slug": "landing-page-clinica-abcd",
  "title": "Clínica Odontológica — Bauru",
  "description": "...",
  "deployed": false,
  "url": null,
  "html": "<!DOCTYPE html>...",
  "tokensUsed": { "input": 350, "output": 4200 }
}

GET `/pages`

Lista todas as páginas da sua conta (sem HTML, para listagens leves).

curl https://builder.mantovanitec.com/api/v1/pages -H "X-API-Key: $LP_KEY"

GET `/pages/:id`

Retorna a página completa, incluindo HTML.

PATCH `/pages/:id`

Edita a página por instrução em linguagem natural (mantém o que não foi pedido para mudar). Cria automaticamente um snapshot de versão antes da edição.

Body: { "instruction": "..." }

curl -X PATCH https://builder.mantovanitec.com/api/v1/pages/clxxx \
  -H "X-API-Key: $LP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instruction":"Trocar o telefone do CTA para (14) 99999-9999"}'

PATCH `/pages/:id/marketing`

Configura Meta Pixel, Google Tag e CTA WhatsApp da página (escopo write). Os campos não enviados ficam inalterados; enviar "" remove. Após atualizar, chame /deploy de novo para injetar os snippets no HTML servido.

Body:

{
  "metaPixelId": "1234567890123456",         // 10-20 dígitos numéricos
  "googleTagId": "G-ABC123XYZ",              // G-XXX, AW-XXX ou GTM-XXX
  "whatsappNumber": "5514996570404",         // só dígitos, com DDI+DDD
  "whatsappMessage": "Olá! Vi seu anúncio." // até 500 chars
}

Comportamento do tracking ao publicar:

Meta Pixel é injetado no <head> e dispara PageView automaticamente. Use a Conversions API ou eventos custom via fbq('track', 'Lead') em CTAs.
Google Tag aceita GA4, Google Ads e GTM. GTM carrega o container completo; G-/AW- carregam gtag.js com config automático.
UTM passthrough: o script injetado captura UTMs e click-IDs (fbclid/gclid) da URL e do localStorage (cache 30d). Toda âncora <a href="wa.me/..."> é reescrita: a UTM original é concatenada no parâmetro ?text= entre colchetes — [origem: utm_source=meta | utm_campaign=...]. Funciona também com âncoras marcadas data-cta-whatsapp, que usam o número configurado em whatsappNumber.

POST `/pages/:id/deploy`

Publica a página em https://builder.mantovanitec.com/p/:slug/. Se houver configuração de marketing salva, os snippets são injetados no HTML servido (sem alterar o HTML armazenado no banco).

DELETE `/pages/:id`

Apaga a página (e remove do disco, se estiver publicada).

Códigos de status

Código	Significado
200 / 201	OK
400	Body inválido (campo faltando, descrição vazia, instrução vazia)
401	X-API-Key ausente, mal-formada ou revogada
403	Plano não é Agency, ou chave sem o escopo necessário
404	Página não encontrada ou não pertence à sua conta
429	Limite de 100 req/dia atingido
500	Erro interno

Limites e cobrança

Rate limit: 100 requisições / 24 h por chave (resposta 429 quando excede). Múltiplas chaves não burlam — somam.
Custos: chamadas a POST /generate e PATCH /pages/:id consomem créditos de IA (Claude) — incluso no plano Agency até o limite diário.
Limites do plano: deploys ilimitados, até 10 domínios próprios. Veja painel.

Privacidade e responsabilidade

Toda descrição enviada para /generate é processada pela Anthropic (Claude) para geração de HTML — não é usada para treino. Se você passa dados pessoais de terceiros (visitantes/clientes finais seus) via API, você é o controlador desses dados conforme LGPD e responsável por ter base legal válida. Veja a Política de Privacidade.

Suporte

Dúvidas técnicas: mantovani36@gmail.com. Privacidade: dpo@mantovanitec.com.

← Voltar ao LP Builder