Guía de uso
Con esta herramienta puedes convertir JSON a CSV: la respuesta de una API o una exportación en JSON se transforma en filas y columnas separadas por comas, listas para una hoja de cálculo. Los objetos anidados se aplanan en columnas como cliente.nombre, los arrays se guardan como texto JSON en una sola celda y se entrecomilla cualquier celda que pudiera romper la tabla. Todo sucede en tu navegador.
Cómo pasar de JSON a CSV
- Pega el JSON; lo ideal es un array en el que cada objeto sea un registro.
- Conviértelo con el botón de ejecutar o con el atajo Ctrl + Enter.
- Si aparece un error, el JSON no es válido: corrige el punto indicado por la línea y la columna.
- Copia el CSV o descárgalo y cambia la extensión del archivo de
.txta.csv.
Ejemplo: pedidos con datos anidados
Imagina una exportación con dos pedidos. El primero es {"pedido":501,"cliente":{"nombre":"Lucía","direccion":{"ciudad":"Sevilla"}},"productos":["café","taza"],"nota":"Dejar en portería; no llamar","cupon":null,"pagado":true}; el segundo solo tiene número de pedido, nombre de cliente y un campo regalo. El resultado es esta tabla:
| pedido | cliente.nombre | cliente.direccion.ciudad | productos | nota | cupon | pagado | regalo |
|---|---|---|---|---|---|---|---|
| 501 | Lucía | Sevilla | ["café","taza"] | Dejar en portería; no llamar | true | ||
| 502 | Andrés | true |
En el archivo en bruto, la nota va entre comillas porque contiene un punto y coma, y el array aparece como "[""café"",""taza""]", con las comillas interiores duplicadas. null se convierte en una celda vacía, y regalo queda al final porque las columnas siguen el orden en que cada clave aparece por primera vez.
Reglas para convertir JSON a CSV
| En el JSON | En el CSV |
|---|---|
| Array de objetos | Una fila por objeto, una columna por clave |
| Un único objeto | Una tabla de una fila |
| Objeto anidado | Columnas con ruta de puntos, a cualquier profundidad |
| Array dentro de un registro | Texto JSON en una celda; no se reparte en filas |
Array de valores simples, como [1,"x"] | Una sola columna llamada value |
| Clave ausente en algún registro | Celda vacía |
Objeto vacío {} | El texto {} |
El separador es siempre la coma. Una celda se entrecomilla si contiene coma, punto y coma, tabulación, barra vertical, comillas o un salto de línea, o si empieza o termina con un espacio; así la tabla no se descuadra se lea con el separador que se lea.
Abrir el resultado en una hoja de cálculo
- Todo aparece en la columna A: con configuración regional en español, las hojas de cálculo esperan punto y coma. Abre el archivo con la función de importar desde texto o CSV y elige la coma como separador.
- Tildes y eñes estropeadas: el resultado está en UTF-8 sin marca BOM, y algunos programas suponen entonces una codificación antigua. Selecciona UTF-8 al importar.
- Valores que cambian solos: un código postal como
08001puede perder el cero,1-2puede convertirse en fecha y un identificador largo, en notación científica. Marca esas columnas como texto durante la importación.
Y una precaución en el lado del JSON: los identificadores de más de unas 16 cifras guardados como número pueden perder precisión al leer el JSON. Mantenlos como texto en el origen.
Privacidad y herramientas relacionadas
La conversión se ejecuta con JavaScript en tu navegador: los datos de clientes y pedidos no se envían al servidor, y la página solo suma un contador de uso anónimo. Si el JSON es largo o lo has editado a mano, valídalo antes con el formateador JSON. Para el camino contrario tienes convertir CSV a JSON, y en CSV vs JSON se explica cuándo conviene cada formato.