ForHosting KIT · Daten & Dateien

CSV in JSON umwandeln

Fügen Sie eine CSV ein, und jede Zeile wird zu einem benannten Datensatz: Im Beispiel kommt Adas Alter 36 als echte Zahl an, und „Lovelace, Ada“ bleibt trotz Komma ein einziger Wert. Leere Zellen bleiben leer statt null. Kostenlos in Ihrem Browser.

Kostenlos
Läuft in Ihrem Browser
Ohne Anmeldung
Ihre Daten bleiben auf Ihrem Gerät

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Rechenbeispiel

Wenn Sie eingeben

CSV-Daten: nombre,edad,activo Ada,36,true "Lovelace, Ada",,false

Erhalten Sie

Anzahl der Zeilen: 2
Spaltennamen: nombre, edad, activo

Gedacht für Entwickler und alle, die eine Tabelle in ein Format bringen möchten, das sich direkt in Anwendungen und Programmierschnittstellen weiterverarbeiten lässt.

Warum man eine CSV nicht an jedem Komma trennt

CSV wirkt wie das einfachste Datenformat überhaupt, und genau dieser Ruf sorgt für die meisten Probleme. Es gibt keine strenge Regel, wie ein Komma innerhalb eines Werts stehen darf oder welche Zeichenkodierung gilt, deshalb exportiert jede Tabellenkalkulation, Buchhaltung oder Bank ein wenig anders. Ein Name wie „Lovelace, Ada“ steht gerade deshalb in Anführungszeichen, damit sein Komma keine neue Spalte beginnt. Ein Umwandler, der an jedem Komma trennt, scheitert an der ersten echten Datei; dieser beachtet die Anführungszeichen, sodass jeder Wert unter dem richtigen Namen landet.

Von Zeilen zu Datensätzen und typische Fehler

Die erste Zeile liefert die Namen, jede folgende Zeile wird zu einem Datensatz mit diesen Namen, also genau die Form, die die meisten Anwendungen und Skripte erwarten. Ganze Zahlen, Dezimalzahlen und die Wörter true und false werden erkannt, sodass eine Spalte mit Altersangaben direkt addierbar ankommt und nicht als Text. Der häufigste Fehler ist das falsche Trennzeichen: Nutzt Ihre Datei Semikolons und bleibt das Komma ausgewählt, wird jede Zeile zu einem einzigen langen Wert. Der zweite ist eine Datei ohne Kopfzeile, die so gelesen wird, als hätte sie eine, wodurch Ihr erster Datensatz zu Spaltennamen wird.

Häufige Fragen

Erkennt das Werkzeug automatisch, welches Trennzeichen die CSV-Datei verwendet?

Ja, Komma, Semikolon und Tabulator werden automatisch erkannt, ebenso Anführungszeichen um Werte mit eingebettetem Komma.

Gibt es ein Limit für die Dateigröße?

Die CSV-Datei darf bis zu 25 MB groß sein. Für größere Exporte empfiehlt sich eine Aufteilung in mehrere Dateien.

Was passiert mit meiner Datei nach der Umwandlung?

Beim Nutzen dieser Seite verlässt die Datei Ihren Browser nicht.

Muss die erste Zeile die Spaltennamen enthalten?

Standardmäßig ja: Die erste Zeile liefert die Namen, und jede weitere Zeile wird zu einem Datensatz mit diesen Namen. Hat Ihre Datei keine Kopfzeile, schalten Sie diese Option aus, dann kommt jede Zeile als einfache Liste von Werten in ihrer ursprünglichen Reihenfolge zurück.

Was passiert mit leeren Zellen in der CSV?

Eine leere Zelle kommt als leerer Wert zurück, nicht als Null und nicht als leerer Text. Im Beispiel hat die zweite Person kein Alter, also zeigt ihr Datensatz das Alter leer, während Name und die Spalte mit wahr oder falsch gefüllt bleiben.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/data/csv-to-json

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/data/csv-to-json \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"csv":"nombre,edad\nAda,36"}'

const res = await fetch("https://api.kit.forhosting.com/data/csv-to-json", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "csv": "nombre,edad\nAda,36"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/csv-to-json",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "csv": "nombre,edad\nAda,36"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/csv-to-json", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"csv":"nombre,edad\\nAda,36"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"csv":"nombre,edad\nAda,36"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/csv-to-json", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "csv": "nombre,edad\nAda,36"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.csv_to_json",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

max_mb 25

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Technische Hinweise

Ein Werkzeug, das eine CSV-Datei zeilenweise in JSON umwandelt: Jede Zeile wird zu einem JSON-Objekt, die erste Zeile liefert die Feldnamen als Schlüssel.

Wie aus einer Zeile ein Objekt wird

Trennzeichen wie Komma, Semikolon oder Tabulator erkennt das Werkzeug automatisch, ebenso Anführungszeichen um Werte, die selbst ein Komma enthalten. Die erste Zeile der CSV-Datei liefert die Spaltennamen, jede weitere Zeile wird zu einem eigenen JSON-Objekt mit genau diesen Namen als Schlüssel. Am Ende steht ein JSON-Array, in dem jede ursprüngliche Zeile als eigenständiges Objekt erscheint, bereit zum Kopieren, Herunterladen oder direkten Einfügen in ein anderes Programm.

Zahlen und Wahrheitswerte bleiben, was sie sind

Ein reiner Text-zu-Text-Ersatz würde jede Spalte als Zeichenkette übernehmen. Diese Funktion erkennt stattdessen, ob eine Spalte Zahlen, Wahrheitswerte oder leere Felder enthält, und gibt sie im JSON entsprechend typisiert aus, also als Zahl statt als Text in Anführungszeichen. Das erspart eine nachträgliche Umwandlung im eigenen Code und verhindert Fehler, die entstehen, wenn eine Preis- oder Mengenspalte versehentlich als Zeichenkette weiterverarbeitet wird.

Wo Sie die Umwandlung nutzen

Eine Anbindung über App ist in Vorbereitung. Genutzt wird die Umwandlung über diese Seite im Browser: Datei hochladen, JSON erhalten, ohne Limit und ohne dass die Datei den Browser verlässt. Dieselbe Funktion steht auch per API bereit, etwa um einen CSV-Export aus einem Warenwirtschaftssystem automatisiert in eine Anwendung einzuspielen, die nur JSON als Eingabe akzeptiert, zum Beispiel einen Onlineshop oder ein No-Code-Werkzeug.

Der umgekehrte Weg: JSON zurück in CSV

Manchmal ist JSON nur ein Zwischenschritt, etwa wenn ein anderes System nur JSON annimmt, das Ergebnis am Ende aber wieder als Tabelle für Excel oder eine Buchhaltungssoftware gebraucht wird. Für diesen Fall steht die Umwandlung von JSON zurück in CSV bereit, sodass sich Daten zwischen beiden Formaten hin- und herbewegen lassen, ohne dass Spaltennamen oder Datentypen dabei verloren gehen. Auch verschachtelte JSON-Strukturen lassen sich dabei automatisch in flache Spalten auflösen, sodass am Ende wieder eine Tabelle mit einer Zeile pro Datensatz entsteht, unabhängig davon, wie tief die ursprüngliche JSON-Struktur verschachtelt war.

Integrationsbeispiele

Artikeldaten aus dem Warenwirtschaftssystem

Weber Metallbau GmbH exportiert die Artikelliste als CSV aus dem Warenwirtschaftssystem und wandelt sie in JSON um, um sie in den eigenen Onlineshop einzuspielen.

Migration alter Kundendaten

Schneider IT-Systeme GmbH & Co. KG übernimmt einen CSV-Export aus einer abgelösten Software und wandelt ihn in JSON um, damit die neue Anwendung die Daten direkt einlesen kann.

Schnell die Struktur einer Testdatei prüfen

Lukas Fischer wandelt eine kleine Beispiel-CSV in JSON um, um vor der eigentlichen Programmierung zu sehen, wie die Datenstruktur später in der Anwendung aussehen wird.

Technische Fragen

Bleiben Zahlen im JSON auch Zahlen und werden nicht zu Text?

Ja, Spalten mit Zahlen oder Wahrheitswerten werden entsprechend typisiert ausgegeben, nicht als Zeichenkette in Anführungszeichen.

Was kostet die Umwandlung über die API?

$0.002 pro Anfrage, unabhängig von der Zeilenzahl. Im Browser bleibt die Umwandlung kostenlos und ohne Limit.

Brauche ich ein Konto?

Nein. Es gibt derzeit keine Konten – im Browser nutzen Sie die Funktion direkt, über die API zahlen Sie pro Anfrage.

Vollständige KIT-Dokumentation lesen →