> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Übersicht über die LanderLab-API

> Erfahren Sie, wie die LanderLab-REST-API funktioniert, wie Sie sich authentifizieren und welche Ressourcen Sie programmatisch verwalten können – von Landingpages und Leads bis zu A/B-Tests und Analysen.

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](/de/mcp/overview) 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:

```text theme={null}
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.

```text theme={null}
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.

<Note>
  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](/de/mcp/generate-api-key).
</Note>

### 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](https://json-schema.org/specification-links#draft-7) 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:

```text theme={null}
https://backend-v2.landerlab.workers.dev/api/v2/openapi.json
```

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

```text theme={null}
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:

```text theme={null}
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](/de/mcp/overview).