Übersicht über die LanderLab-API - Landerlab Documentation

Die LanderLab-API gibt Ihnen programmatischen Zugriff auf Ihr gesamtes Konto. Sie können Lander erstellen und veröffentlichen, Lead-Daten abrufen, Analysen auslesen, A/B-Test-Varianten verwalten, Integrationen konfigurieren und mehr – alles über HTTP. Wenn Sie lieber in natürlicher Sprache arbeiten, statt rohe API-Aufrufe zu schreiben, verbindet der MCP-Server Ihren KI-Assistenten über dieselbe zugrunde liegende API direkt mit LanderLab. Er meldet sich mit Ihrem LanderLab-Konto an, ein API-Schlüssel ist also nicht erforderlich.

Basis-URL

Alle API-Anfragen gehen an:

https://api.landerlab.dev

Die aktuelle API-Version ist v2. Jeder Endpunkt hat das Präfix /api/v2/.

Authentifizierung

Die API nutzt die Authentifizierung per API-Schlüssel. Geben Sie Ihren Schlüssel bei jeder Anfrage im Header X-API-Key an.

X-API-Key: ll_live_YOUR_KEY_HERE

Ihr Schlüssel beginnt mit ll_live_ und ist an Ihre Organisation gebunden. Alle Anfragen sind auf die Organisation beschränkt, zu der der Schlüssel gehört – bei den meisten Aufrufen müssen Sie daher keine separate Organisations-ID übergeben.

API-Schlüssel werden nur einmal bei der Erstellung angezeigt. Wenn Sie Ihren verlieren, müssen Sie einen neuen erzeugen. Die Schritte finden Sie unter Einen API-Schlüssel erzeugen.

Fehlerantworten

Alle Endpunkte geben Standard-HTTP-Statuscodes zurück.

Code	Bedeutung
`200`	Erfolg
`400`	Ungültige Anfrage (unzulässige Parameter oder Tariflimit erreicht)
`401`	Nicht autorisiert (fehlender oder ungültiger API-Schlüssel)
`403`	Verboten (der Schlüssel hat keinen Zugriff auf diese Ressource)
`404`	Nicht gefunden

Fehlerantworten enthalten im Body eine Zeichenfolge error mit einer Beschreibung des Problems.

Ressourcengruppen

Die API ist um die folgenden Ressourcengruppen herum organisiert. Jede Gruppe entspricht einem Abschnitt der API-Referenz.

Workspaces

Listen, erstellen und benennen Sie Workspaces innerhalb Ihrer Organisation um. Workspaces sind der oberste Container für Lander, Leads und Domains.

Endpunkt	Beschreibung
`GET /api/v2/organizations/{organizationId}/workspaces/get`	Alle Workspaces auflisten
`POST /api/v2/organizations/{organizationId}/workspaces/create`	Einen Workspace erstellen
`POST /api/v2/workspaces/{workspaceId}/rename`	Einen Workspace umbenennen

Lander

Verwalten Sie Landingpages: auflisten, erstellen, umbenennen, veröffentlichen, Veröffentlichung aufheben und löschen. Für das Veröffentlichen sind eine Domain und ein Pfad erforderlich; es wird ein 400 zurückgegeben, wenn Tariflimits überschritten sind oder der Pfad bereits belegt ist.

Endpunkt	Beschreibung
`GET /api/v2/workspaces/{workspaceId}/landers/get`	Lander in einem Workspace auflisten
`POST /api/v2/workspaces/{workspaceId}/landers/create`	Einen Lander erstellen
`POST /api/v2/landers/{landerId}/publish`	Einen Lander veröffentlichen
`POST /api/v2/landers/{landerId}/unpublish`	Die Veröffentlichung eines Landers aufheben
`DELETE /api/v2/landers/{landerId}`	Einen Lander samt aller Varianten löschen

Das Löschen eines Landers entfernt alle zugehörigen Varianten, Dateien und Integrationen dauerhaft.

A/B-Tests (Varianten)

Jeder Lander hat eine oder mehrere Varianten. Die Master-Variante ist diejenige, die Traffic erhält, wenn A/B-Tests deaktiviert sind. Bei aktivierten A/B-Tests wird der Traffic gemäß den von Ihnen festgelegten Gewichtungen auf die Varianten verteilt.

Endpunkt	Beschreibung
`GET /api/v2/landers/{landerId}/variants`	Alle Varianten auflisten
`POST /api/v2/variants/{variantId}/clone`	Eine Variante klonen
`POST /api/v2/landers/{landerId}/ab-testing/enable`	A/B-Tests aktivieren
`POST /api/v2/landers/{landerId}/ab-testing/disable`	A/B-Tests deaktivieren
`POST /api/v2/landers/{landerId}/ab-testing/weights`	Gewichtungen der Traffic-Verteilung festlegen
`POST /api/v2/variants/{variantId}/set-master`	Eine Variante zur Master-Variante machen
`DELETE /api/v2/variants/{variantId}`	Eine Variante löschen

Die Master-Variante kann nicht gelöscht werden. Machen Sie zuvor eine andere Variante zur Master-Variante.

Editor

Laden und speichern Sie HTML-Inhalt und Einstellungen einer bestimmten Variante. Beim Speichern von HTML werden das Extrahieren von Base64-Bildern und die Versionierung automatisch erledigt.

Endpunkt	Beschreibung
`GET /api/v2/variants/{variantId}/editor/load`	HTML, Einstellungen, Formulare und Metadaten laden
`POST /api/v2/variants/{variantId}/editor/save`	HTML-Inhalt speichern
`POST /api/v2/variants/{variantId}/editor/settings`	Varianteneinstellungen speichern (Integrationen, SEO, Tracking)

Leads

Rufen Sie Leads auf Workspace- oder Organisationsebene ab. Leads werden seitenweise ausgeliefert und lassen sich nach Zeitraum, Status (complete oder partial), Lander und Suchbegriff filtern. Die maximale Seitengröße beträgt 1000 pro Anfrage.

Endpunkt	Beschreibung
`GET /api/v2/workspaces/{workspaceId}/leads/get`	Leads eines Workspace auflisten
`GET /api/v2/organizations/{organizationId}/leads/get`	Leads der gesamten Organisation auflisten
`GET /api/v2/landers/{landerId}/lead-schema`	Das JSON-Schema für die Leads eines Landers abrufen
`POST /api/v2/landers/lead-schema`	Das JSON-Schema für mehrere Lander abrufen

Die Lead-Schema-Endpunkte geben ein JSON-Schema nach Draft-07 zurück, das alle möglichen Felder beschreibt, die ein Lead dieses Landers enthalten kann – darunter Formularfelder, Quiz-Antworten, Systemfelder und Integrationsfelder.

Analysen

Ein einziger flexibler Endpunkt deckt alle Analyseanforderungen ab. Filtern Sie nach Workspace, Lander oder Variante. Der spezifischste Filter gewinnt: Wenn Sie variantIds übergeben, werden Workspace- und Lander-Filter ignoriert.

Endpunkt	Beschreibung
`POST /api/v2/organizations/{organizationId}/analytics/get`	Analysen mit Zeitraum, Zeitzone und optionaler Gruppierung abrufen

Erforderliche Parameter: startDate, endDate, timezone (IANA-Format, z. B. America/New_York). Optionale Filter: workspaceIds, landerIds, variantIds. Gruppieren nach: date, lander, variant oder workspace. Standard ist date.

Domains

Listen Sie Domains auf Workspace- oder Organisationsebene auf.

Endpunkt	Beschreibung
`GET /api/v2/workspaces/{workspaceId}/domains/get`	Domains in einem Workspace auflisten
`GET /api/v2/organizations/{organizationId}/domains/get`	Alle Domains der gesamten Organisation auflisten

Ordner

Organisieren Sie Lander innerhalb eines Workspace in Ordnern.

Endpunkt	Beschreibung
`GET /api/v2/workspaces/{workspaceId}/folders`	Alle Ordner auflisten
`POST /api/v2/workspaces/{workspaceId}/folders/create`	Einen Ordner erstellen
`POST /api/v2/folders/{folderId}/rename`	Einen Ordner umbenennen

Integrationen

Erstellen und listen Sie Integrationen auf Organisationsebene und aktivieren oder deaktivieren Sie sie anschließend pro Lander. OAuth-basierte Integrationen (Mailchimp, HubSpot, Google Sheets, AWeber) erfordern einen interaktiven OAuth-Ablauf und können nicht direkt über die API angelegt werden.

Endpunkt	Beschreibung
`GET /api/v2/organizations/{organizationId}/integrations`	Alle Integrationen auflisten
`POST /api/v2/organizations/{organizationId}/integrations/create`	Eine Integration erstellen
`POST /api/v2/lander-integrations/{id}/enable`	Eine Lander-Integration aktivieren
`POST /api/v2/lander-integrations/{id}/disable`	Eine Lander-Integration deaktivieren
`DELETE /api/v2/lander-integrations/{id}`	Eine Integration von einem Lander entfernen

OpenAPI-Spezifikation und interaktive Dokumentation

Die vollständige OpenAPI-3.1-Spezifikation finden Sie unter:

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

Die interaktive API-Dokumentation (mit integriertem Request-Tester) finden Sie unter:

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

Die API mit einem KI-Assistenten nutzen (MCP)

Wenn Sie Ihr LanderLab-Konto in natürlicher Sprache verwalten möchten, statt API-Aufrufe zu schreiben: Der LanderLab-MCP-Server basiert auf derselben API und stellt jedem MCP-kompatiblen KI-Assistenten über 30 Tools bereit – darunter Claude, ChatGPT, Cursor und Windsurf. Die MCP-Server-URL lautet:

https://api.landerlab.dev/mcp

Die Authentifizierung erfolgt über eine Anmeldung im Browser statt über den Header X-API-Key, ein API-Schlüssel ist also nicht erforderlich. Eine Einrichtungsanleitung finden Sie unter KI-Assistenten über MCP verbinden.

​Basis-URL

​Authentifizierung

​Fehlerantworten

​Ressourcengruppen

​Workspaces

​Lander

​A/B-Tests (Varianten)

​Editor

​Leads

​Analysen

​Domains

​Ordner

​Integrationen

​OpenAPI-Spezifikation und interaktive Dokumentation

​Die API mit einem KI-Assistenten nutzen (MCP)

Basis-URL

Authentifizierung

Fehlerantworten

Ressourcengruppen

Workspaces

Lander

A/B-Tests (Varianten)

Editor

Leads

Analysen

Domains

Ordner

Integrationen

OpenAPI-Spezifikation und interaktive Dokumentation

Die API mit einem KI-Assistenten nutzen (MCP)