Cómo convertir JSON a CSV (y abrir el resultado en Excel)
Convierta una exportación de API o un archivo JSON en una hoja de cálculo. Vea cómo se aplanan objetos y arrays, qué pasa con las claves ausentes y cómo abrir el CSV en Excel.
Actualizado el 4 de noviembre de 20268 min de lectura
Para convertir JSON a CSV, pegue el JSON (o suelte un archivo .json) en el convertidor, pulse Convertir a CSV y después descargue el archivo o copie el texto. La herramienta convierte cada objeto de su array en una fila, construye el encabezado con todas las claves que encuentra y une los objetos anidados en nombres de columna separados por puntos, como user.name. Excel abre el CSV directamente, y por eso es el camino habitual para pasar de "JSON a Excel". Lo que suele sorprender es qué ocurre con los arrays, las claves ausentes y el orden de las columnas, así que esta guía explica exactamente lo que hace la herramienta.
Qué forma de JSON funciona
El convertidor espera lo que devuelven la mayoría de las API y exportaciones: un array de objetos, por ejemplo una lista de pedidos o de usuarios. Cada objeto se convierte en una fila. Un único objeto también sirve y da una tabla de una sola fila. Si el array contiene valores simples en lugar de objetos (números o textos), cada uno pasa a ser una fila en una sola columna llamada value. Un array vacío no produce ninguna salida.
Si su respuesta envuelve la lista en otro objeto, por ejemplo {"data": [ ... ]}, el convertidor tratará todo como una sola fila con una columna que contiene la lista como texto. Copie solo el array interior y péguelo en su lugar. Si el JSON no es válido, verá el mensaje "JSON inválido. Revise corchetes, comas y comillas." Pase primero el texto por el formateador de JSON para localizar el fallo; la guía sobre dar formato a JSON online muestra cómo son los errores habituales.
Convertir JSON a CSV, paso a paso
Abra el convertidor
Vaya al convertidor de JSON a CSV. Todo se ejecuta en su dispositivo, no en nuestros servidores, así que una exportación con datos de clientes no se sube a ninguna parte.
Pegue el JSON o suelte el archivo
Pegue el texto en el cuadro Entrada JSON o suelte un archivo .json encima. Con un archivo, deje Codificación (archivo) en UTF-8 salvo que sepa que se guardó en una página de códigos de Windows.
Pulse Convertir a CSV
El CSV aparece en el cuadro de salida de abajo. Mire primero la fila de encabezado: ahí se ve cómo se nombraron sus campos anidados.
Descargue o copie
Descargar CSV guarda un archivo llamado data.csv. Copiar CSV deja el texto en el portapapeles para pegarlo en una hoja de cálculo u otra herramienta.
Pegue o suelte JSON, aplánelo en columnas y descargue el CSV. Gratis: un archivo cada vez con delimitador de coma y sin límite de filas fijado por nosotros, así que el tope es la memoria de su dispositivo. Pro: elegir punto y coma, tabulación o barra vertical. Se ejecuta en su dispositivo.
Convertir JSON a CSVCómo se aplanan los datos anidados
Un CSV es una cuadrícula plana y JSON es un árbol, así que algo tiene que ceder. La herramienta sigue dos reglas sencillas. Los objetos anidados se recorren hacia abajo, y cada ruta se convierte en un nombre de columna unido con puntos. Los arrays no se expanden: el array completo se escribe en la celda como texto JSON.
| En el JSON | Columna en el CSV | Valor de la celda |
|---|---|---|
| "name": "Ada" | name | Ada |
| "address": { "city": "Pune" } | address.city | Pune |
| "a": { "b": { "c": 1 } } | a.b.c | 1 |
| "tags": ["x", "y"] | tags | ["x","y"] (como texto, entre comillas) |
| "items": [{ "id": 1 }] | items | [{"id":1}] (como texto, entre comillas) |
| "note": null | note | (vacía) |
| "paid": true | paid | true |
| "meta": {} | (sin columna) | Un objeto vacío no añade nada |
La consecuencia, dicha sin rodeos: un registro con cinco líneas de pedido en un array no se convierte en cinco filas. Sigue siendo una fila con las líneas en una sola celda como texto. Si necesita una fila por línea, extraiga ese array interior y conviértalo por separado, conservando un ID de pedido en cada elemento para poder cruzarlos después. La herramienta no tiene opción para mantener el anidamiento ni para desplegar arrays, y no usa otro separador que el punto para las rutas.
Claves ausentes, orden de columnas y celdas vacías
Las exportaciones reales son irregulares: un cliente tiene teléfono y el siguiente no. El convertidor lee primero todos los registros y reúne la unión de todos los nombres de columna que ve. Un registro al que le falta una clave recibe una celda vacía en esa columna, de modo que todas las filas tienen el mismo número de celdas y nada se desplaza hacia un lado. Un valor null también se convierte en celda vacía, lo que significa que el CSV no distingue entre "ausente" y "null".
Las columnas se ordenan alfabéticamente, no según el orden de su JSON. La ordenación es por código de carácter, así que las mayúsculas van antes que las minúsculas y los números antes que las letras. El campo id no será necesariamente el primero; normalmente moverá columnas en su hoja de cálculo después. Los números y los valores true/false se escriben como texto plano, y un número JSON como 12.50 se escribe como 12.5.
| Registro | id | name | phone |
|---|---|---|---|
| { "id": 1, "name": "A", "phone": "555-0100" } | 1 | A | 555-0100 |
| { "id": 2, "name": "B" } | 2 | B | (vacía) |
| { "id": 3, "name": "C", "phone": null } | 3 | C | (vacía) |
Delimitador, comillas y codificación
La salida gratuita usa siempre una coma. Elegir otro delimitador (punto y coma, tabulación o barra vertical) es una opción Pro del menú Delimitador. Sea cual sea el delimitador, cualquier valor que contenga ese delimitador, unas comillas dobles o un salto de línea se envuelve entre comillas dobles, y las comillas interiores se duplican. Es la forma estándar, así que direcciones como "12 Main St, Apt 4" se quedan en una sola celda.
| Opción | Dónde se aplica | Notas |
|---|---|---|
| Coma | Predeterminada, todos los planes | El CSV más ampliamente aceptado |
| Punto y coma | Pro | Lo que Excel espera en muchas configuraciones regionales europeas |
| Tabulación | Pro | Valores separados por tabulaciones (TSV) |
| Barra vertical | Pro | Algunos flujos de datos |
| UTF-8 / Windows-1252 / ISO-8859-1 | Al leer un archivo subido | Solo cambia cómo se lee el archivo .json, no el CSV que descarga |
El menú Codificación (archivo) se malinterpreta fácilmente. Controla cómo se decodifica un archivo JSON subido. El JSON casi siempre es UTF-8, así que déjelo como está salvo que los nombres con tilde aparezcan como símbolos raros tras cargar el archivo. El CSV descargado se escribe como texto UTF-8 simple, y la herramienta no añade marca de orden de bytes. Si pega el JSON en lugar de subirlo, el menú de codificación no tiene ningún efecto.
Abrir el CSV en Excel
Hacer doble clic en un CSV en UTF-8 sin marca de orden de bytes puede llevar a Excel a suponer una codificación antigua, y las letras con tilde y el texto no latino se convierten en caracteres extraños. En lugar de doble clic, abra un libro en blanco y use Datos, y después Desde texto/CSV, y elija UTF-8 como origen del archivo. La ventana de vista previa también permite fijar el delimitador, lo que resuelve el otro problema habitual: en regiones donde Excel espera punto y coma, un archivo separado por comas acaba en una sola columna. Elija Coma en esa ventana y se divide bien. El recorrido completo está en abrir un CSV en Excel correctamente.
En el lado de Excel ocurren otras dos cosas que no provoca el convertidor. Los números largos, como identificadores de tarjeta o de seguimiento de 16 dígitos, se muestran en notación científica, y los valores con ceros a la izquierda, como 00123, pierden los ceros. Ponga esas columnas en formato Texto en la vista previa de importación antes de cargar. Si prefiere evitar el cuadro de importación, pase el CSV por CSV a Excel para obtener un libro, o use el visor de CSV solo para mirarlo.
Límites y cosas que conviene saber antes de una exportación grande
- Un archivo cada vez. El convertidor toma un único archivo JSON por ejecución.
- Sin tope de filas y sin marca de agua. Como todo se ejecuta en su dispositivo, el límite real es la memoria que tenga. Un archivo enorme puede ralentizar la página; divídalo antes si es el caso.
- Todo es texto. El CSV no tiene tipos. Las fechas siguen siendo los textos que eran en el JSON, y los números son solo dígitos.
- Las fórmulas no se escapan. Un valor que empieza por = + - o @ se copia tal cual, y una hoja de cálculo puede tratarlo como fórmula. Revise las exportaciones de fuentes no fiables antes de abrirlas.
- Los puntos en las claves pueden chocar. Una clave que se llame literalmente "a.b" y un objeto a anidado con b dentro acabarían en la misma columna.
- Volver atrás es otro paso: CSV a JSON reconstruye JSON a partir de una tabla, aunque no puede restaurar el anidamiento original exacto.
Si duda de que CSV sea el destino adecuado para sus datos, JSON vs CSV vs XML compara lo que conserva y lo que pierde cada formato.
Preguntas frecuentes
¿Cómo convierto JSON a CSV gratis?
Abra el convertidor de JSON a CSV, pegue su JSON o suelte un archivo .json, pulse Convertir a CSV y use Descargar CSV o Copiar CSV. El plan gratuito da un archivo cada vez con delimitador de coma, y no hay límite de filas fijado por nosotros.
¿Cómo convierto JSON a Excel?
Convierta primero a CSV, luego abra Excel y use Datos, Desde texto/CSV, eligiendo UTF-8 y el delimitador coma en la vista previa. También puede pasar el CSV por CSV a Excel para obtener un libro .xlsx.
¿Qué pasa con los objetos y arrays anidados?
Los objetos anidados se convierten en columnas separadas con nombres unidos por puntos, como address.city. Los arrays no se dividen en filas; el array completo se escribe en una celda como texto JSON.
¿Por qué hay celdas vacías en mi CSV?
La herramienta reúne todas las claves de todos los registros. Un registro que no tiene una clave, o la tiene en null, recibe una celda vacía en esa columna para que todas las filas queden alineadas.
¿Por qué las letras con tilde se ven mal al abrir el CSV en Excel?
Excel puede suponer una codificación equivocada al hacer doble clic en un archivo UTF-8. Impórtelo con Datos, Desde texto/CSV y seleccione UTF-8 como origen del archivo. El convertidor escribe UTF-8 simple y no añade marca de orden de bytes.
¿Puedo usar punto y coma o tabulación en lugar de coma?
Sí, con Pro: el menú Delimitador ofrece coma, punto y coma, tabulación y barra vertical. En el plan gratuito la salida usa coma, y la vista previa de importación de Excel permite elegirla como separador.