Convertidor de JSON a CSV

Pega una matriz JSON de objetos y obtén un archivo CSV limpio y con los caracteres de escape adecuados, listo para copiar o descargar. Los encabezados de las columnas se generan automáticamente a partir de todas las claves que aparecen en la matriz, por lo que las filas con campos que faltan o de más se gestionan correctamente. Todo se ejecuta en tu navegador; los datos nunca salen de tu dispositivo.

¿Qué es esta herramienta?

Las API y las bases de datos suelen devolver datos en formato JSON, pero las hojas de cálculo, Excel, Google Sheets y la mayoría de las herramientas de importación de datos esperan archivos CSV. Esta herramienta sirve de puente entre ambos formatos: basta con pegar una matriz de objetos JSON (como la respuesta de una API) y ella genera un archivo CSV con una columna por cada clave única y una fila por cada objeto.

La conversión se encarga de los detalles que hacen que los enfoques simplistas fallen: los valores que contienen comas o comillas se escapan correctamente, los campos que faltan se convierten en celdas vacías en lugar de provocar un error en la conversión, y los objetos o matrices anidados dentro de un campo se serializan como una cadena JSON en esa celda, en lugar de omitirse sin aviso.

¿Por qué utilizarlo?

Detección automática de encabezados: la lista de columnas se genera a partir de la unión de las claves de todos los objetos, por lo que los registros incoherentes no alteran el resultado.
Escapado correcto de CSV: los valores que contienen comas, comillas o saltos de línea se encierran entre comillas de forma adecuada, de modo que el archivo se abre correctamente en Excel o en Google Sheets.
Gestiona datos anidados: un objeto o una matriz dentro de un campo se serializa en texto JSON en lugar de provocar un error.
Cópialo al portapapeles o descárgalo directamente como archivo .csv.
100 % en el lado del cliente: tus datos (respuestas de la API, registros exportados) nunca se suben a ningún sitio.

Cómo utilizarlo

Pega una matriz JSON de objetos, por ejemplo: [{"name":"Alice","age":30},{"name":"Bob","age":25}].
Haz clic en «Convertir a CSV».
Revisa el resultado: cópialo o haz clic en «Descargar CSV» para guardar un archivo.
Abre el archivo descargado en Excel, Google Sheets o cualquier programa de hojas de cálculo.

Ejemplo

Entrada

[{"name":"Alice","age":30},{"name":"Bob","city":"NYC"}]

Resultado

name,age,city
Alice,30,
Bob,,NYC

Fíjate en que tanto «ciudad» como «edad» aparecen como columnas, aunque ningún objeto tenga ambos datos; los valores que faltan simplemente se dejan en blanco.

Consejos prácticos

Cómo convertir la respuesta de una API para un informe en hoja de cálculo: pega la matriz JSON directamente desde la pestaña «Red» del navegador o desde una herramienta de pruebas de API, conviértela y descárgala; no hace falta ningún script intermedio.
Trabajo con registros inconsistentes (por ejemplo, campos opcionales de una exportación de formularios): la detección automática de encabezados te permite evitar tener que conciliar manualmente los esquemas primero.
Si tu JSON es un único objeto grande con una matriz anidada en su interior (por ejemplo, {"users": [...]}), extrae solo la parte de la matriz (la parte [...] ) antes de pegarla aquí.

Por qué son importantes el orden de las columnas y la exhaustividad

Un error sutil pero habitual en los archivos CSV se produce cuando los datos se exportan escribiendo primero los encabezados a mano y confiando en que todas las filas coincidan: si la fila 50 de 1000 tiene un campo adicional que ninguna de las filas anteriores tenía, un generador de CSV ingenuo que trabaja línea por línea o bien omite ese campo sin avisar o bien desalinea todas las columnas posteriores. Esta herramienta evita ese error analizando primero cada objeto de la matriz para construir la fila de encabezado completa y correcta antes de escribir una sola línea de salida; de este modo, un campo que solo aparece una vez, en el último objeto, sigue teniendo su propia columna y el valor correspondiente en todas las demás filas se muestra correctamente en blanco, en lugar de corromper la estructura de las filas.

Preguntas frecuentes

¿Funciona esto con un único objeto JSON en lugar de con una matriz?

Se espera una matriz: envuelve un único objeto entre corchetes; por ejemplo, cambia {"name":"Alice"} por [{"name":"Alice"}], y se convertirá en un archivo CSV de una sola fila.

¿Qué ocurre con los objetos o matrices anidados dentro de un campo?

Se serializan como una cadena JSON dentro de esa celda (por ejemplo, un campo que contenga {"a":1} se convierte en el texto «{""a"":1}» en el CSV, con las comillas correctamente escapadas), en lugar de provocar un error o ser omitido. Si necesitas que los datos anidados se conviertan en columnas independientes, para ello se requiere una herramienta diferente, específica para el esquema.

¿Se suben mis datos a un servidor?

No. La conversión se realiza íntegramente mediante JavaScript en tu navegador; no se envía nada a ningún sitio, lo que hace que sea seguro utilizarla con datos exportados de clientes o de la empresa.

¿Por qué mi archivo CSV tiene celdas en blanco?

Si a algunos objetos de tu matriz les falta una clave que otros sí tienen, esa columna existe, pero la celda se deja en blanco para los objetos que no la tienen; de este modo, se conservan todos tus datos en lugar de generar un error por registros incoherentes.

¿Los valores separados por comas pueden provocar errores en el archivo CSV?

No. Cualquier valor que contenga una coma, una comilla o un salto de línea se envuelve automáticamente entre comillas (con las comillas internas escapadas), según las normas estándar del formato CSV, por lo que se abre correctamente en Excel y en Google Sheets.