Cómo convertir JSON a CSV para Excel y Google Sheets

Una API te entrega un muro de JSON, pero la persona que lo necesita vive en Excel. Pegar JSON en bruto en una hoja de cálculo te deja una sola celda fea llena de corchetes y comillas. Lo que quieres es un CSV: filas y columnas limpias que se abren directamente en Excel o Google Sheets. Convertir JSON a CSV es una tarea pequeña y habitual, y esta guía muestra cómo hacerlo de forma limpia con la herramienta gratuita JSON a CSV.

Por qué aplanar JSON a CSV

JSON está hecho para el código. CSV está hecho para las personas que trabajan en hojas de cálculo. La mayoría de las veces conviertes porque los datos necesitan salir del mundo del desarrollo y llegar ante alguien que filtra, ordena y crea gráficos en una cuadrícula familiar. Los motivos habituales incluyen:

• Crear un informe que un responsable o cliente abrirá en Excel.
• Exportar registros desde una aplicación o API para que un compañero no técnico pueda revisarlos.
• Importar a otra herramienta que acepta archivos CSV pero no JSON.
• Hacer análisis rápidos con fórmulas de hoja de cálculo en lugar de escribir código.

En resumen, el CSV es el apretón de manos universal entre tus datos y todos los que no leen JSON para ganarse la vida.

Cómo un arreglo de objetos se convierte en una tabla

El JSON más fácil de convertir es un arreglo de objetos planos, porque se asigna a la perfección a una tabla. Toma este ejemplo:

• [{"name": "Ada", "role": "dev"}, {"name": "Linus", "role": "lead"}]

Cada clave (name, role) se convierte en un encabezado de columna. Cada objeto se convierte en una fila. El resultado es un CSV ordenado de dos columnas con una línea de encabezado y dos líneas de datos. Un objeto que entra, una fila que sale, con las claves haciendo de etiquetas. Esta es la forma con la que las hojas de cálculo están más contentas, así que busca esto siempre que puedas.

Cómo tratar los campos anidados

El JSON real rara vez es perfectamente plano. Un registro puede contener un objeto de dirección o una lista de etiquetas dentro de él. Una celda de hoja de cálculo, en cambio, quiere un único valor. Hay dos maneras sensatas de tratar esto:

1. Aplanar con una ruta. Un campo anidado como address.city se convierte en su propia columna llamada address.city, llevando el valor interno al nivel superior para que cada pieza tenga su propia celda.
2. Convertir a texto. Un valor que no se puede aplanar de forma limpia, como un arreglo, se escribe en la celda como texto compacto para que no se pierda ningún dato.

Saber cuál de las dos ocurrió te dice qué esperar. Si ves una columna con un punto en el nombre, eso es un campo anidado aplanado. Si ves corchetes dentro de una celda, esa rama se conservó como texto. En cualquier caso, nada se descarta en silencio.

Cómo convertir JSON a CSV en tu navegador

La herramienta gratuita JSON a CSV se ejecuta por completo en tu navegador, así que tus datos nunca se suben. Eso importa cuando el JSON contiene registros de usuarios, correos electrónicos o cifras internas que no pegarías en un sitio desconocido.

1. Abre la herramienta y pega tu JSON, o carga un archivo .json. Un arreglo de objetos se convierte de la forma más limpia.
2. Deja que construya los encabezados de columna a partir de las claves que encuentra en tus registros.
3. Copia la salida CSV, o descárgala, y luego ábrela en Excel o Google Sheets.

Como la conversión ocurre en la pestaña, las exportaciones sensibles permanecen en tu propia máquina todo el tiempo.

Deja el JSON limpio primero

Una conversión fallida suele deberse a una entrada mal formada, no a un problema de la herramienta. Antes de convertir, conviene confirmar que el JSON es válido y está bien estructurado. Pégalo primero en el Formateador de JSON: indenta la estructura, señala una coma que falta o un corchete sin cerrar, y te permite confirmar que de verdad trabajas con un arreglo de objetos y no con un único bloque anidado. Dos minutos ahí te ahorran un CSV confuso después.

Herramientas relacionadas

El viaje funciona en ambos sentidos. Cuando un colega edita el CSV en Excel y necesitas recuperarlo como datos estructurados, la herramienta CSV a JSON convierte esas filas de nuevo en objetos. Y si tus datos llegaron originalmente como XML, la herramienta XML a JSON los pasa primero a JSON, listos para aplanarlos a una hoja de cálculo desde ahí.

La versión corta

JSON a CSV trata de llevar datos con forma de código a una cuadrícula que cualquiera puede abrir. Un arreglo de objetos planos se convierte a la perfección: las claves se vuelven columnas, los objetos se vuelven filas. Los campos anidados se aplanan en columnas con puntos o se conservan como texto, así que nada se pierde. Valida tu JSON primero en el formateador y luego ejecuta la herramienta gratuita JSON a CSV directamente en tu navegador para obtener un archivo limpio, privado y listo para hoja de cálculo en segundos.