Datenformate und Export

Stand: 06.11.2026

Dieses Register beschreibt, welche Daten ein Kunde aus Cleverpage mitnehmen kann, in welchem Format und auf welchem Weg. Es ist das Online-Register nach Ziffer 3.2 des Annex zum Anbieterwechsel in unseren AGB und gilt auch, wenn jemand nicht wechselt, sondern nur eine eigene Kopie haben möchte.

Die Website als ZIP-Archiv

Jede Website lässt sich jederzeit vollständig exportieren, kostenlos und so oft wie nötig:

  • in der Oberfläche unter Einstellungen → Erweitert → Website exportieren;
  • über die API mit GET https://app.cleverpage.ai/api/v1/projects/<projekt>/export.zip.

Exportieren dürfen die Personen der Organisation. Personen, die nur zu einer einzelnen Website eingeladen sind, sehen die Komponenten nicht und exportieren deshalb nicht.

Das Archiv enthält die Quelle der Website:

  • Einstellungen der Website, Menü, Sprachen, Weiterleitungen, Formulardefinitionen: site.json, JSON
  • Seiten mit allen Inhalten und Übersetzungen: pages/<name>.json, JSON
  • Komponenten, Felddefinition und Vorlage: components/<name>/component.json und template.liquid, JSON und Liquid
  • Verlauf jeder Komponente und des Designsystems: verlauf/ und components/<name>/verlauf/, JSON
  • Kopf, Fuß und Grundgestaltung: layout/, Liquid und CSS
  • Designsystem mit Farben, Schriften, Abständen und Bausteinen: designsystem-v2.json, JSON
  • Typen, Blöcke, Collections und ihre Einträge: site.json und sammlungen/, JSON
  • Medien, jede Version jedes Bildes, Films, Tons und Dokuments im hochgeladenen Original: medien/, das Verzeichnis in medien.json; Formate wie hochgeladen, zum Beispiel JPEG, PNG, WebP, SVG, MP4, MP3, PDF
  • Schriften: uploads/fonts/, WOFF2 und CSS
  • Favicon und Vorschaubild: branding/, PNG und ICO

Formulareinsendungen als CSV

Die Einsendungen eines Formulars lassen sich im Posteingang der Website als CSV-Datei herunterladen: alle, die gerade gezeigte Ansicht oder die der letzten Tage. Spalten, Trennzeichen (Semikolon oder Komma), Kopfzeile und Byte-Order-Mark sind wählbar. Die Datei ist UTF-8-kodiert. Über die API liefert list_submissions dieselben Einsendungen als JSON.

Die API

Alles, was die Oberfläche zeigt, ist auch über die API lesbar, als JSON über HTTPS mit einem persönlichen Zugangsschlüssel:

Seiten, Komponenten, Designsystem, Medien, Collections, Einsendungen, Kommentare und Besucherstatistik lassen sich damit einzeln abrufen, eine veröffentlichte Seite auch als fertiges HTML.

Was nicht im Archiv ist, und warum

  • Formulareinsendungen und ihre Anhänge. Es sind personenbezogene Daten Dritter mit einer eigenen Aufbewahrungsfrist. Sie stehen als CSV im Posteingang, die Anhänge einzeln dort, alles auch als JSON über die API.
  • Besucherstatistik. Sie zählt nur Tage und Seiten, keine Personen. Abrufbar über die API (read_analytics).
  • Kommentare zu Seiten. Es sind Arbeitsnotizen des Teams. Abrufbar über die API (read_comments).
  • Gebaute Seiten (HTML) und Vorschau. Sie entstehen bei jeder Veröffentlichung neu aus der Quelle. Jede veröffentlichte Seite ist einzeln als HTML über die API abrufbar (read_approvals).
  • Bildgrößen und Videostreams. Sie werden aus den Originalen erzeugt, die im Archiv sind, und lassen sich daraus neu erzeugen.
  • Zugangsdaten: Passwort der Testadresse, Freigabelinks, Zugangsschlüssel. Sie gäben jedem Zugang, der das Archiv erhält, und werden beim neuen Anbieter neu vergeben.
  • Freigabestand und offene Freigabeanfragen. Das ist interner Arbeitsstand; der veröffentlichte Stand ist über die API abrufbar.

Nicht zur Website gehören und deshalb ebenfalls nicht im Archiv sind: die Konten und Rechte der Personen, die Rechnungen und die Abrechnung des KI-Guthabens. Rechnungen stehen in der Oberfläche unter Abrechnung. Die Software Cleverpage selbst, insbesondere der Renderkern, ist kein Bestandteil des Exports.

Standards

  • JSON nach RFC 8259, UTF-8
  • CSV nach RFC 4180, wählbar mit Semikolon oder Komma
  • ZIP-Archiv
  • Liquid als Vorlagensprache der Komponenten
  • CSS für Gestaltung und Designsystem
  • OpenAPI 3.1 für die Beschreibung der API
  • HTTPS mit Bearer-Token für den Zugriff
  • Medien in ihren Ursprungsformaten

Der Wechsel in Schritten

  1. Wechselmitteilung. Der Kunde teilt per E-Mail an hello@cleverpage.ai mit, dass er wechselt, wohin, und ob alle oder nur einzelne Websites betroffen sind. Wir bestätigen den Eingang innerhalb von 3 Werktagen auf demselben Weg.
  2. Plan. Gemeinsam legen wir fest, was in welcher Reihenfolge exportiert wird, wer Ansprechpartner ist und wie der Export getestet wird.
  3. Export. Der Kunde lädt die Archive und die CSV-Dateien herunter, in der Oberfläche oder über die API. Der Export ist ein Download, der in Minuten fertig ist; er lässt sich vorab ausprobieren.
  4. Übergangsfrist. 30 Kalendertage, in denen alles unverändert weiterläuft und wir beim Wechsel helfen.
  5. Frist für den Datenabruf. Danach 30 weitere Kalendertage, in denen die Daten noch abgerufen oder gelöscht werden können.
  6. Löschung. Danach löschen wir die Daten und bestätigen die Löschung. Rechnungsdaten bewahren wir so lange auf, wie das Gesetz es verlangt (10 Jahre nach § 147 AO).

Für den Wechsel berechnen wir nichts. Die Fristen im Einzelnen stehen im Annex zum Anbieterwechsel der AGB.