JSON in CSV umwandeln: einfache Anleitung

JSON in CSV umwandeln ist eine dieser kleinen Fähigkeiten, die Stunden lästigen Kopierens und Einfügens sparen. APIs, Webhooks und moderne Apps liefern Ihnen Daten als JSON, aber Tabellenkalkulationen, Buchhalter und Reporting-Tools wollen saubere Zeilen und Spalten. Wenn Sie jemals eine JSON-Datei in Excel oder Google Tabellen geöffnet und eine Wand aus Text gesehen haben, die in eine einzige Zelle gequetscht ist, kennen Sie das Problem. Die gute Nachricht ist, dass die Umwandlung einfach ist, sobald man versteht, wofür jedes Format gedacht ist — und Sie können sie in Ihrem Browser erledigen.

Warum Tabellenkalkulationen CSV wollen, nicht JSON

JSON und CSV wurden für unterschiedliche Aufgaben gebaut. JSON, kurz für JavaScript Object Notation, wurde dafür entwickelt, dass Maschinen strukturierte Daten austauschen. Ein einzelner Datensatz kann Text, Zahlen, Listen und weitere Datensätze enthalten, die darin verschachtelt sind. Diese Flexibilität ist der Grund, warum Entwickler es lieben — und warum Tabellenkalkulationen damit kämpfen: Eine Tabelle ist ein Raster, und jeder Wert braucht eine Zeile und eine Spalte.

CSV, also durch Kommas getrennte Werte, passt perfekt zum Raster. Die erste Zeile benennt die Spalten, und jede Zeile danach ist ein Datensatz. Excel, Google Tabellen, LibreOffice und fast jedes Import-Tool für Datenbanken können eine CSV-Datei direkt öffnen. Deshalb bitten Finanzteams um CSV-Exporte, deshalb akzeptieren E-Mail-Tools CSV-Kontaktlisten, und deshalb beginnen Analysten die meisten Projekte damit, API-Antworten in CSV umzuwandeln.

CSV-Dateien sind außerdem reiner Text, also klein und leicht zu prüfen. Eine API-Antwort enthält oft Felder, die Sie nicht brauchen, etwa interne IDs und Metadaten, und die Umwandlung in CSV zwingt Sie, die Spalten auszuwählen, die wichtig sind. Wenn das rohe JSON wie eine einzige lange, unlesbare Zeile aussieht, lassen Sie es zuerst durch einen JSON-Formatierer laufen, damit Sie seine Struktur sehen können.

JSON in CSV umwandeln: So sieht eine saubere Umwandlung aus

Eine saubere Umwandlung folgt einer einfachen Regel: Jedes JSON-Objekt wird eine Zeile, und jedes Feld wird eine Spalte. Die Feldnamen werden zur Kopfzeile oben in der Datei, und die Werte reihen sich darunter in derselben Reihenfolge auf. Wenn jeder Datensatz dieselben Felder hat, ist das Ergebnis eine ordentliche Tabelle, die jede Tabellenkalkulation ohne Beschwerden öffnet.

Drei Details unterscheiden ein sauberes CSV von einem kaputten. Erstens muss Text, der ein Komma enthält, in doppelte Anführungszeichen gesetzt werden, sonst teilt Ihre Tabellenkalkulation ihn auf zwei Spalten auf — ein Firmenname wie Smith, Jones and Co braucht Anführungszeichen darum. Zweitens werden Anführungszeichen innerhalb von Text verdoppelt: Aus she said "hello" wird in CSV "she said ""hello""". Drittens sollten Zahlen und Datumsangaben ein einheitliches Format behalten, damit Beträge immer dieselben Dezimalstellen verwenden.

Auch die Kodierung spielt eine Rolle. Wenn Ihre Daten Umlaute oder Währungssymbole enthalten, speichern Sie das CSV als UTF-8. Excel unter Windows liest UTF-8-Dateien manchmal falsch, also wenn Namen mit Umlauten zu seltsamen Symbolen werden, importieren Sie die Datei über den Textkonvertierungs-Assistenten von Excel und wählen Sie UTF-8, statt sie per Doppelklick zu öffnen. Prüfen Sie schließlich, ob jeder Datensatz dieselben Felder hat; wenn bei einem ein Feld fehlt, sollte diese Zelle leer bleiben, statt spätere Werte in die falschen Spalten zu verschieben.

Verschachtelte Daten: der knifflige Teil, wenn man JSON in CSV umwandelt

Flaches JSON lässt sich leicht umwandeln, aber echte API-Daten sind selten flach. Ein Kundendatensatz kann ein Adressobjekt mit Feldern für Straße, Stadt und Postleitzahl enthalten, oder eine Liste früherer Bestellungen. Eine Tabellenkalkulation kann kein Objekt in einer Zelle speichern, also müssen verschachtelte Daten abgeflacht werden, bevor sie zu CSV werden.

Der häufigste Ansatz ist die Punktnotation: Jedes verschachtelte Feld wird eine eigene Spalte, wobei der Pfad mit Punkten verbunden wird. Ein Adressobjekt mit einem Stadtfeld wird zu einer Spalte namens address.city, und eine Postleitzahl wird zu address.postcode. So bleiben alle Informationen erhalten, und die Spaltennamen zeigen weiterhin, woher jeder Wert stammt. Das funktioniert gut, wenn die Verschachtelung nur ein oder zwei Ebenen tief ist, was die meisten API-Antworten abdeckt.

Listen sind schwieriger, weil ein Datensatz viele Elemente enthalten kann. Eine Bestellung mit drei Produkten passt nicht in eine einzige Zeile, ohne dass man eine Entscheidung trifft. Sie haben drei Möglichkeiten: eine Zeile pro Artikel, wobei die Bestelldetails wiederholt werden — am besten, wenn Sie die Artikel analysieren oder zusammenzählen müssen; die Artikel in einer Zelle zusammenfassen, getrennt durch ein Semikolon — das hält eine Zeile pro Bestellung, ist aber schwerer zu analysieren; oder die Daten in zwei Dateien aufteilen, eine für Bestellungen und eine für Artikel, verknüpft über eine Bestell-ID. Wofür Sie sich auch entscheiden, wenden Sie es auf jeden Datensatz an — ein Mix aus Ansätzen führt dazu, dass Spalten in verschiedenen Zeilen unterschiedliche Dinge bedeuten.

Ein echtes Beispiel Schritt für Schritt

Angenommen, Sie betreiben einen kleinen Onlineshop und Ihr Bestellsystem liefert Ihnen dieses JSON: ein Array aus vier Bestellungen, jede mit einem Kundennamen, einer E-Mail-Adresse und einem Betrag.

• { "name": "Ana Ruiz", "email": "ana@example.com", "amount": 49.99 }
• { "name": "Ben Carter", "email": "ben@example.com", "amount": 129.50 }
• { "name": "Carla Diaz", "email": "carla@example.com", "amount": 24.00 }
• { "name": "Dan Kim", "email": "dan@example.com", "amount": 89.95 }

Das ist eine saubere, flache Struktur, also ist die Umwandlung unkompliziert. Die Feldnamen — name, email und amount — werden zur Kopfzeile, und jedes Objekt wird eine Zeile in der CSV-Datei:

• name,email,amount
• Ana Ruiz,ana@example.com,49.99
• Ben Carter,ben@example.com,129.50
• Carla Diaz,carla@example.com,24.00
• Dan Kim,dan@example.com,89.95

Öffnen Sie diese Datei in einer Tabellenkalkulation, und Sie erhalten eine ordentliche Tabelle mit vier Zeilen und drei Spalten, bereit zum Sortieren, Filtern oder Summieren. Addieren Sie die vier Beträge — 49.99 plus 129.50 plus 24.00 plus 89.95 — und die Summe ist 293.44, was mit der Summe in Ihrem Bestellsystem übereinstimmen sollte. Falls sie nicht übereinstimmt, prüfen Sie, ob ein Datensatz fehlt oder doppelt vorhanden ist.

JSON in CSV umwandeln im Browser

Sie müssen keine Software installieren und keinen Code schreiben, um eine Datei umzuwandeln. Ein kostenloser Online-Konverter erledigt die ganze Arbeit: Fügen Sie Ihr JSON ein, prüfen Sie die Vorschau und laden Sie das CSV herunter. Der JSON-in-CSV-Umwandler läuft vollständig in Ihrem Browser, sodass Ihre Daten Ihren Computer nie verlassen — was wichtig ist, wenn die Datei Kunden-E-Mails oder Bestelldetails enthält.

Der übliche Ablauf dauert weniger als eine Minute. Kopieren Sie zuerst das JSON aus Ihrer API-Antwort oder Ihrem Export. Wenn es wie eine einzige komprimierte Zeile aussieht, bringen Sie es zuerst mit einem JSON-Formatierer in Form, damit Sie bestätigen können, dass die Struktur gültig ist. Fügen Sie es dann in den Konverter ein, prüfen Sie die Spaltenüberschriften in der Vorschau und laden Sie das CSV herunter. Öffnen Sie die heruntergeladene Datei in Excel oder Google Tabellen und prüfen Sie drei Dinge: ob die Überschriften den Feldern entsprechen, die Sie erwartet haben, ob keine Spalte verschoben aussieht und ob die Zeilenanzahl mit der Anzahl der Datensätze in Ihrem JSON übereinstimmt. Wenn etwas falsch aussieht, liegt das Problem fast immer an verschachtelten Daten oder einem fehlenden Feld.

Häufig gestellte Fragen

Kann ich JSON in Excel in CSV umwandeln, ohne ein Online-Tool?

Ja. Verwenden Sie in Excel Daten, dann Daten abrufen, dann Aus Datei, dann Aus JSON, um die Datei über Power Query zu laden. Power Query zeigt das JSON als Tabelle an, die Sie erweitern können, wobei verschachtelte Datensätze abgeflacht werden, indem Sie auf das Erweiterungssymbol einer Spalte klicken. Sobald die Tabelle richtig aussieht, wählen Sie Schließen und laden und speichern Sie die Datei dann als CSV. Google Tabellen hat keinen eingebauten JSON-Import, also ist für Tabellen ein Online-Konverter in der Regel schneller.

Was passiert mit verschachtelten Arrays in meinem JSON?

Verschachtelte Arrays müssen abgeflacht werden, bevor sie zu CSV werden, weil eine einzelne Zelle eine Liste von Werten nicht sinnvoll aufnehmen kann. Die meisten Konverter erstellen entweder eine Zeile pro Array-Element und wiederholen dabei die Felder des übergeordneten Datensatzes, oder sie fassen die Elemente mit einem Trennzeichen in einer Zelle zusammen. Wählen Sie eine Zeile pro Element, wenn Sie die Elemente zählen, summieren oder filtern müssen, und eine zusammengefasste Zelle nur, wenn Sie eine Zeile pro übergeordnetem Datensatz brauchen.

Warum sieht mein CSV kaputt aus, wenn ich es in Excel öffne?

Die häufigsten Ursachen sind Kommas ohne Anführungszeichen innerhalb von Text, ein anderes Trennzeichen und die Kodierung. Wenn ein Wert ein Komma enthält und nicht in Anführungszeichen steht, teilt Excel ihn in zusätzliche Spalten auf. Wenn Ihre Datei Semikolons statt Kommas verwendet, legt Excel möglicherweise die gesamte Zeile in eine Spalte; der Import über den Textkonvertierungs-Assistenten und die Wahl des richtigen Trennzeichens beheben das. Wenn Umlaute falsch aussehen, importieren Sie die Datei erneut und wählen Sie die UTF-8-Kodierung.

Jetzt können Sie JSON in CSV umwandeln — und zwar richtig: Wählen Sie die Spalten aus, die wichtig sind, flachen Sie verschachtelte Daten konsequent ab, achten Sie auf Kommas und Anführungszeichen und prüfen Sie die Zeilenanzahl und eine Summe, bevor Sie die Datei teilen. Probieren Sie es jetzt mit dem kostenlosen JSON-in-CSV-Umwandler aus — fügen Sie Ihr JSON ein, laden Sie ein sauberes, tabellenfertiges CSV herunter und kehren Sie zu der Arbeit zurück, die wirklich zählt.