Marketing
Páginas de aterrizaje
Crea, edita y publica páginas de aterrizaje desde tu sistema o desde un agente. Es el mismo motor del editor visual: lo que haces por API se ve igual en el editor y al revés.
| GET | /v1/landing-pages | Lista las páginas (filtra con status=draft, published o unpublished). |
| GET | /v1/landing-pages/templates | Plantillas disponibles para crear una página. |
| GET | /v1/landing-pages/{id} | Una página con su documento completo (include_document=false para omitirlo). |
| POST | /v1/landing-pages | Crea una página desde plantilla, escrita por la IA o con tu propio documento. |
| PATCH | /v1/landing-pages/{id} | Cambia título, dirección, ajustes o el borrador completo. |
| POST | /v1/landing-pages/{id}/publish | Publica el borrador actual. |
| POST | /v1/landing-pages/{id}/unpublish | Quita la página de internet; el borrador se conserva. |
| GET | /v1/landing-pages/{id}/analytics | Visitas, contactos, clics a WhatsApp, pagos y fuentes (days=7, 30 o 90). |
| DELETE | /v1/landing-pages/{id} | Borra la página y la quita de internet. |
Crear una página
Manda una de tres: template, ai_description o document. Sin ninguna, se crea una página en blanco con los colores y la letra de tu marca.
| Campo | Descripción |
|---|---|
| title | Nombre interno de la página. También es el título de la pestaña si no defines uno en SEO. |
| slug | Parte final de la dirección (promo-verano). Si ya existe, se agrega un número. |
| template | Clave de una plantilla de /v1/landing-pages/templates. |
| ai_description | Qué debe lograr la página. La IA elige las secciones y escribe los textos con los datos reales de tu negocio (productos, horarios, WhatsApp). Necesita una llave de IA conectada o la prueba gratuita. |
| document | Documento JSON del editor (secciones, elementos, tema y SEO), como lo devuelve GET. |
| locale | es, en o pt_BR. Por defecto, el idioma de tu cuenta. |
| publish | true para publicarla al crearla. |
Petición
curl -X POST "https://recaudo.app/api/v1/landing-pages" \
-H "Authorization: Bearer sk_live_tu_secret_key" \
-H "Content-Type: application/json" \
-d '{
"title": "Promo limpieza dental",
"ai_description": "Limpieza dental a $499 en Monterrey, agenda por WhatsApp",
"publish": true
}'
Respuesta
{
"object": "landing_page",
"data": {
"id": "8f1c2d3e-4a5b-4c6d-8e7f-9a0b1c2d3e4f",
"object": "landing_page",
"title": "Promo limpieza dental",
"slug": "promo-limpieza-dental",
"status": "published",
"locale": "es",
"template": "ai",
"url": "https://tu-negocio.recaudo.app/p/promo-limpieza-dental",
"is_home": true,
"revision": 1,
"has_unpublished_changes": false,
"settings": {},
"published_at": "2026-11-20T18:30:02+00:00",
"document": { "version": 1, "locale": "es", "theme": { … }, "meta": { … }, "sections": [ … ] }
}
}
Formulario con uno de tus formularios
El elemento form puede usar sus propios campos (source=page, el formulario rápido) o uno de tus formularios del módulo Formularios (source=lead_form). Con lead_form la página pinta los campos de ese formulario con el diseño de la página y guarda cada respuesta en él.
| Campo | Descripción |
|---|---|
| props.source | page (por defecto) o lead_form. |
| props.lead_form_id | UUID de un formulario publicado de tu cuenta. Si no es de tu cuenta, POST y PATCH responden 422 con code lead_form_not_found. |
Petición
{
"id": "e4k2m9q7xa",
"type": "form",
"props": {
"source": "lead_form",
"lead_form_id": "3b6f0c1e-9d2a-4e5b-8c7d-1a2b3c4d5e6f",
"submit_label": "Quiero mi cotización",
"success_message": "¡Gracias! Te escribimos hoy mismo."
},
"items": [],
"layout": { … },
"style": { … }
}
- Corre lo mismo que un envío en la página del formulario: crea o actualiza al cliente, aplica sus listas y etiquetas, guarda la aceptación de términos, llama a su webhook y dispara "Formulario enviado" (form.submitted) con landing_page_id y UTM.
- La página conserva su conteo de contactos, la atribución (UTM, fbclid, gclid) y manda un solo evento Lead a Meta con el mismo event_id que el píxel.
- Los campos llegan como f[field_0], f[field_1]… en el orden del formulario; si pide términos, también f[accept_terms]=1.
- Si despublicas el formulario, la página muestra un aviso y el envío responde 422 con un mensaje claro.
- Documento: es JSON, nunca HTML. Cada elemento tiene type, props, style por dispositivo (desktop, tablet, mobile) y layout en columnas de la cuadrícula. Lo más fácil es leerlo con GET, cambiar lo que necesitas y mandarlo completo con PATCH.
- Revisiones: cada PATCH con document sube revision. Si mandas revision y alguien guardó después (en el editor o por API), responde 409 y no pisa sus cambios.
- Seguridad: el texto enriquecido pasa por una lista de etiquetas permitidas, las ligas solo aceptan http, https, mailto y tel, y los scripts se quitan. Los campos que no se reconocen se ignoran.
- Límites del plan: publicar una página más de las que permite tu plan responde 403 con code limit_pages.
- Errores de IA: ai_unavailable (no hay llave de IA conectada), ai_limit (se acabó la prueba gratuita) y ai_failed (la IA no respondió bien; intenta de nuevo).
- Contactos: cada formulario enviado crea o actualiza al cliente, dispara el evento lead.created a tus webhooks y el disparador "Formulario de página de aterrizaje enviado" de tus automatizaciones, con UTM, fbclid y gclid.
- MCP: las mismas acciones están como herramientas (create_landing_page, publish_landing_page, get_landing_page_analytics…).
¿Te sirvió esta página?
Gracias por avisarnos.