Cómo convertir JSON a CSV: guía rápida y gratis

Aprender cómo convertir JSON a CSV es una de esas pequeñas habilidades que te ahorran horas de tedioso copiar y pegar. Las API, los webhooks y las aplicaciones modernas te entregan los datos en formato JSON, pero las hojas de cálculo, los contables y las herramientas de informes quieren filas y columnas ordenadas. Si alguna vez has abierto un archivo JSON en Excel o Google Sheets y has visto un muro de texto apretado en una sola celda, conoces el problema. La buena noticia es que la conversión es sencilla una vez que entiendes para qué sirve cada formato, y puedes hacerla en tu navegador.

Por qué las hojas de cálculo quieren CSV, no JSON

JSON y CSV se crearon para trabajos diferentes. JSON, abreviatura de JavaScript Object Notation, se diseñó para que las máquinas intercambiaran datos estructurados. Un solo registro puede contener texto, números, listas y otros registros anidados dentro de él. Esa flexibilidad es la razón por la que a los desarrolladores les encanta, y por la que las hojas de cálculo tienen problemas con él: una hoja de cálculo es una cuadrícula, y cada valor necesita una fila y una columna.

CSV, o valores separados por comas, encaja perfectamente con la cuadrícula. La primera fila nombra las columnas, y cada fila siguiente es un registro. Excel, Google Sheets, LibreOffice y casi todas las herramientas de importación de bases de datos pueden abrir un archivo CSV directamente. Por eso los equipos de finanzas piden exportaciones en CSV, por eso las herramientas de correo aceptan listas de contactos en CSV, y por eso los analistas empiezan la mayoría de los proyectos convirtiendo respuestas de API en CSV.

Los archivos CSV también son texto plano, así que son pequeños y fáciles de revisar. Una respuesta de API suele incluir campos que no necesitas, como identificadores internos y metadatos, y convertir a CSV te obliga a elegir las columnas que importan. Si el JSON sin procesar parece una sola línea larga e ilegible, pásalo primero por un formateador JSON para poder ver su estructura.

Cómo convertir JSON a CSV: cómo es una conversión limpia

Una conversión limpia sigue una regla sencilla: cada objeto JSON se convierte en una fila, y cada campo se convierte en una columna. Los nombres de los campos se convierten en la fila de encabezado en la parte superior del archivo, y los valores se alinean debajo en el mismo orden. Cuando todos los registros tienen los mismos campos, el resultado es una tabla ordenada que cualquier hoja de cálculo abre sin quejas.

Tres detalles separan un CSV limpio de uno roto. Primero, el texto que contiene una coma debe ir entre comillas dobles, o tu hoja de cálculo lo dividirá en dos columnas: un nombre de empresa como Smith, Jones and Co necesita comillas a su alrededor. Segundo, las comillas dentro del texto se duplican: she said "hello" se convierte en "she said ""hello""" en CSV. Tercero, los números y las fechas deben mantener un formato consistente, de modo que los importes usen siempre los mismos decimales.

La codificación también importa. Si tus datos incluyen caracteres acentuados o símbolos de moneda, guarda el CSV como UTF-8. Excel en Windows a veces lee mal los archivos UTF-8, así que si los nombres acentuados se convierten en símbolos extraños, importa el archivo con el Asistente para importar texto de Excel y elige UTF-8 en lugar de hacer doble clic en él. Por último, comprueba que todos los registros tengan los mismos campos; si a uno le falta un campo, esa celda debe quedar vacía en lugar de desplazar los valores siguientes a las columnas equivocadas.

Datos anidados: la parte complicada de cómo convertir JSON a CSV

El JSON plano se convierte fácilmente, pero los datos reales de las API rara vez son planos. Un registro de cliente puede contener un objeto de dirección con campos de calle, ciudad y código postal, o una lista de pedidos anteriores. Una hoja de cálculo no tiene forma de guardar un objeto dentro de una celda, así que los datos anidados deben aplanarse antes de convertirse en CSV.

El enfoque más común es la notación de puntos: cada campo anidado se convierte en su propia columna, con la ruta unida por puntos. Un objeto de dirección con un campo de ciudad se convierte en una columna llamada address.city, y un código postal se convierte en address.postcode. Esto conserva toda la información, y los nombres de las columnas siguen mostrando de dónde viene cada valor. Funciona bien cuando la anidación tiene solo uno o dos niveles de profundidad, lo que cubre la mayoría de las respuestas de API.

Las listas son más difíciles, porque un registro puede contener muchos elementos. Un pedido con tres productos no cabe en una sola fila sin tomar una decisión. Tienes tres opciones: una fila por artículo, repitiendo los datos del pedido, que es lo mejor cuando necesitas analizar o sumar los artículos; unir los artículos en una sola celda, separados por punto y coma, lo que mantiene una fila por pedido pero es más difícil de analizar; o dividir los datos en dos archivos, uno para pedidos y otro para artículos, vinculados por un ID de pedido. Elijas lo que elijas, aplícalo a todos los registros: mezclar enfoques hace que las columnas signifiquen cosas distintas en filas distintas.

Un ejemplo real paso a paso

Supón que tienes una pequeña tienda en línea y tu sistema de pedidos te entrega este JSON: una matriz de cuatro pedidos, cada uno con el nombre del cliente, una dirección de correo electrónico y un importe.

• { "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 }

Es una estructura plana y limpia, así que la conversión es sencilla. Los nombres de los campos —name, email y amount— se convierten en la fila de encabezado, y cada objeto se convierte en una fila del archivo CSV:

• 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

Abre ese archivo en una hoja de cálculo y obtendrás una tabla ordenada con cuatro filas y tres columnas, lista para ordenar, filtrar o sumar. Suma los cuatro importes —49.99 más 129.50 más 24.00 más 89.95— y el total es 293.44, que debería coincidir con el total de tu sistema de pedidos. Si no coincide, busca un registro faltante o duplicado.

Cómo convertir JSON a CSV en tu navegador

No necesitas instalar software ni escribir código para convertir un archivo. Un conversor en línea gratuito hace todo el trabajo: pega tu JSON, revisa la vista previa y descarga el CSV. El conversor de JSON a CSV funciona por completo en tu navegador, así que tus datos nunca salen de tu ordenador, lo que importa cuando el archivo contiene correos electrónicos de clientes o detalles de pedidos.

El flujo habitual lleva menos de un minuto. Primero, copia el JSON de la respuesta de tu API o de tu exportación. Si parece una sola línea comprimida, ordénalo primero con un formateador JSON para confirmar que la estructura es válida. Después pégalo en el conversor, revisa los encabezados de columna en la vista previa y descarga el CSV. Abre el archivo descargado en Excel o Google Sheets y comprueba tres cosas: que los encabezados coincidan con los campos que esperabas, que ninguna columna parezca desplazada y que el número de filas coincida con el número de registros de tu JSON. Si algo parece mal, el problema casi siempre son los datos anidados o un campo faltante.

Preguntas frecuentes

¿Puedo convertir JSON a CSV en Excel sin una herramienta en línea?

Sí. En Excel, usa Datos, luego Obtener datos, luego Desde archivo, luego Desde JSON para cargar el archivo con Power Query. Power Query muestra el JSON como una tabla que puedes expandir, aplanando los registros anidados al hacer clic en el icono de expansión de una columna. Cuando la tabla se vea bien, elige Cerrar y cargar, y después guarda el archivo como CSV. Google Sheets no tiene importación de JSON integrada, así que para Sheets un conversor en línea suele ser más rápido.

¿Qué pasa con las matrices anidadas de mi JSON?

Las matrices anidadas deben aplanarse antes de convertirse en CSV, porque una sola celda no puede contener una lista de valores de forma útil. La mayoría de los conversores crean una fila por cada elemento de la matriz, repitiendo los campos del registro principal, o unen los elementos en una sola celda con un separador. Elige una fila por elemento cuando necesites contar, sumar o filtrar los elementos, y una celda unida solo cuando necesites una fila por registro principal.

¿Por qué mi CSV se ve roto cuando lo abro en Excel?

Las causas más comunes son las comas sin comillas dentro del texto, un separador diferente y la codificación. Si un valor contiene una coma y no está entre comillas, Excel lo divide en columnas extra. Si tu archivo usa punto y coma en lugar de comas, Excel puede poner toda la fila en una sola columna; importarlo con el Asistente para importar texto y elegir el delimitador correcto lo soluciona. Si los caracteres acentuados se ven mal, vuelve a importar y elige la codificación UTF-8.

Ahora ya sabes cómo convertir JSON a CSV de la forma correcta: elige las columnas que importan, aplana los datos anidados de forma coherente, ten cuidado con las comas y las comillas, y verifica el número de filas y un total antes de compartir el archivo. Pruébalo ahora con el conversor gratuito de JSON a CSV: pega tu JSON, descarga un CSV limpio listo para tu hoja de cálculo y vuelve al trabajo que de verdad importa.