Toolphy

Convertidor JSON a CSV

Pega un array JSON de objetos y obtén un CSV listo para Excel o Google Sheets, con las columnas detectadas automáticamente.

0
Filas
0
Columnas

Cómo convertir JSON a CSV

Pasar de un objeto JSON estructurado a un archivo CSV legible en una hoja de cálculo normalmente requiere un script. Esta herramienta lo hace en tu navegador en unos segundos.

  1. Pega tu JSON. Copia un array JSON de objetos —la forma que devuelven la mayoría de las API REST— y pégalo en el cuadro de entrada. Cada objeto se convierte en una fila CSV y sus claves pasan a ser las columnas.

    Ejemplo: [{"nombre":"Ada","edad":36},{"nombre":"Linus","edad":54}] produce el encabezado nombre,edad y después las filas Ada,36 y Linus,54.

  2. Elige el delimitador. Mantén la coma para el CSV estándar, cambia al punto y coma si tu configuración regional usa la coma como separador decimal, o elige la tabulación para pegar directamente en Excel o Google Sheets.

  3. Decide sobre la fila de encabezado. Está activada por defecto y enumera todas las columnas detectadas. Desactívala cuando un sistema de importación espere solo los datos.

  4. Pulsa Convertir y luego copia o descarga. La herramienta construye el CSV, muestra el número de filas y columnas, y te permite copiar el resultado o guardar un archivo .csv con un clic.

¿Qué es la conversión de JSON a CSV?

JSON (JavaScript Object Notation) es un formato jerárquico y autodescriptivo organizado en objetos y arrays. CSV (valores separados por comas) es una tabla plana donde cada registro ocupa una línea y cada campo se separa con un delimitador. Convertir uno en otro es, en esencia, aplanar: un árbol de valores anidados se reduce a una cuadrícula rectangular. La dificultad principal es que los objetos JSON no siempre tienen las mismas claves. Un convertidor que solo lee el primer registro perderá columnas en silencio. Esta herramienta, en cambio, recorre cada objeto del array y construye la unión de todas las claves: un campo que aparezca aunque sea en una fila obtiene su propia columna. Los valores ausentes quedan vacíos. Los valores que no son cadenas o números simples —objetos anidados, arrays, booleanos y null— se serializan con JSON.stringify para no perder información. Por último, el CSV sigue la convención RFC 4180: cualquier campo que contenga una comilla, el delimitador o un salto de línea se encierra entre comillas dobles, y las comillas internas se duplican. Eso evita que un valor como Dijo "hola", fuerte rompa el archivo.

Aplicaciones habituales

1. Convertir una respuesta de API en un informe: exporta usuarios, pedidos o eventos desde un endpoint JSON y abre el resultado en Excel o Google Sheets para analizarlo.

2. Migraciones de bases de datos y CMS: prepara archivos planos para herramientas que solo aceptan importación CSV, como CRM, plataformas de correo y suites de analítica.

3. Cuadernos de ciencia de datos: lleva un pequeño conjunto de datos JSON a pandas o R sin escribir un analizador propio.

4. Revisiones de configuración: aplana una lista de funciones, productos o idiomas en una tabla que personas no técnicas puedan leer y editar.

5. Uso compartido rápido: envía a un colega una hoja de cálculo en lugar de una carga JSON en bruto que no puede abrir.

Cómo tratar objetos y arrays anidados

El CSV no entiende de profundidad, así que las estructuras anidadas deben representarse como texto. Cuando un valor es un objeto o un array, el convertidor llama a JSON.stringify y escribe la cadena resultante en una sola celda. Por ejemplo, un array tags como ["new","sale"] se guarda literalmente como ["new","sale"], y un objeto address se convierte en {"city":"Paris","zip":"75001"}.

Este enfoque no pierde información —puedes volver a analizar la celda como JSON real más tarde—, pero no equivale a aplanar las claves en columnas con puntos. Si necesitas address.city como columna propia, transforma los datos antes o usa un paso de aplanado dedicado. Para la mayoría de las exportaciones, conservar la subestructura intacta en una celda es la opción más segura.

Utilidades Relacionadas

Preguntas Frecuentes - FAQ

¿Mis datos se envían a un servidor?

No. Toda la conversión ocurre localmente en tu navegador con JavaScript nativo. Tu JSON nunca se sube, se registra ni se almacena en ningún sitio.

¿Qué ocurre si los objetos tienen claves distintas?

La herramienta recorre cada objeto y usa la unión de todas las claves como columnas. Una clave que aparezca en una sola fila obtiene igualmente su columna, y las filas donde falta se dejan vacías.

¿Cómo se tratan los objetos y arrays anidados?

Los valores anidados se serializan con JSON.stringify y se colocan en una sola celda CSV, y después se escapan con normalidad. Así los datos no se pierden aunque el CSV no admita anidación de forma nativa.

¿La salida cumple la RFC 4180?

Sí. Los campos que contienen una comilla, el delimitador elegido o un salto de línea se encierran entre comillas dobles, y cada comilla interna se duplica. Las filas se separan con finales de línea CRLF.

¿Qué delimitadores puedo usar?

Puedes generar valores separados por comas, por puntos y coma o por tabulaciones. El punto y coma conviene a configuraciones regionales donde la coma es el separador decimal, y la tabulación se pega limpiamente en las hojas de cálculo.

Última actualización: