Sobre esta herramienta
Este convertidor de JSON a CSV transforma un array de objetos JSON, como una respuesta de API o una exportación de base de datos, en una tabla CSV que se abre en Excel, Google Sheets o LibreOffice. Los objetos anidados se aplanan en columnas con rutas de puntos, los arrays se convierten en columnas numeradas y las columnas de todos los registros se combinan en el orden en que aparecen por primera vez.
Pega JSON o abre un archivo .json de hasta 5 MB, elige el delimitador y si quieres una fila de encabezado, y luego copia o descarga el CSV. Los campos que contienen el delimitador, comillas o saltos de línea se ponen entre comillas, como exige RFC 4180. Todo ocurre en tu navegador.
Cómo funciona
La entrada puede ser un array de objetos (una fila por objeto), un array de arrays (una fila por array interior), un array de valores simples (una columna llamada value) o un único objeto (una fila). Si el JSON no es válido, se indican la línea y la columna cuando el navegador las proporciona.
Los objetos anidados se convierten en columnas con nombres de ruta separados por puntos, por ejemplo user.name y user.address.city. Los arrays se convierten en columnas numeradas con índices desde cero, como tags.0 y tags.1, de modo que se conserva cada valor aunque los registros tengan arrays de distinta longitud. Los arrays y objetos vacíos, las claves ausentes y null se convierten en celdas vacías. Los números y los booleanos se escriben tal como aparecen en el JSON.
El CSV usa finales de línea CRLF. Elige el punto y coma si tu hoja de cálculo usa la coma como separador decimal, y activa la marca de orden de bytes si Excel muestra mal las letras con tilde.
Ejemplo
Toma dos registros con un objeto user anidado y un array tags:
[{"id": 1, "user": {"name": "Ada", "email": "[email protected]"}, "tags": ["math", "code"]}, {"id": 2, "user": {"name": "Alan"}, "tags": ["logic"]}]
El CSV tiene las columnas id, user.name, user.email, tags.0 y tags.1. La primera fila es 1,Ada,[email protected],math,code. La segunda fila es 2,Alan, luego un email vacío, logic y una celda tags.1 vacía, porque Alan no tiene email y solo tiene una etiqueta.
Supuestos y límites
La entrada está limitada a 5 MB de texto; por encima de 300.000 caracteres, el resultado solo se actualiza al pulsar Convertir. El JSON se analiza con el analizador estándar del navegador, así que los enteros mayores que 9.007.199.254.740.991 pueden perder precisión y, si hay claves duplicadas, solo se conserva el último valor. Los arrays dentro de arrays de arrays se escriben como texto JSON en una sola celda. La herramienta no protege contra fórmulas de hojas de cálculo, así que un valor que empiece por = puede evaluarse al abrir el archivo en una hoja de cálculo. Los datos nunca salen de tu navegador.
Preguntas frecuentes
¿Cómo convierto JSON a CSV para Excel?
Pega el JSON o abre el archivo, deja activado Escribir una fila de encabezado y descarga el CSV. Si Excel muestra mal las letras con tilde o los símbolos, activa la opción de marca de orden de bytes. Si Excel pone todo en una sola columna, elige el delimitador punto y coma, que es el que Excel espera en las configuraciones regionales con coma decimal, como la de España.
¿Cómo se tratan los objetos y arrays anidados?
Cada valor anidado tiene su propia columna. Las claves de los objetos se unen con puntos, como address.city, y los elementos de los arrays se numeran desde cero, como items.0.sku e items.1.sku. Así se conservan todos los valores y puedes reconstruir la estructura más adelante, pero los arrays muy largos generan muchas columnas.
¿Y si mis registros tienen claves distintas?
El convertidor recoge todas las claves de todos los registros. Las columnas aparecen en el orden en que se encuentran por primera vez, y un registro al que le falta una clave recibe una celda vacía en esa columna.
Mi JSON es un objeto con un array data dentro. ¿Qué hago?
Un único objeto se convierte en una sola fila, así que una respuesta de API como {"data": [...]} genera columnas llamadas data.0.id, data.1.id, etc. Pega solo la parte del array, desde el [ inicial hasta el ] final, para obtener una fila por registro.
¿Por qué algunos valores van entre comillas?
CSV exige comillas alrededor de los valores que contienen el delimitador, una comilla doble o un salto de línea, y las comillas dentro de esos valores se duplican. El convertidor también pone entre comillas los valores con espacios al principio o al final para que las hojas de cálculo los conserven.
Enlace con tus valores
Añade estos parámetros a la dirección de esta página para abrirla con los valores ya rellenados, por ejemplo para compartir un cálculo o enlazarlo desde un asistente de IA. El resultado se calcula en el navegador: el HTML de la página muestra un ejemplo con los valores predeterminados y la herramienta añade el atributo data-url-params cuando se aplican los valores del enlace.
| Parámetro | Valor | Si se omite |
|---|---|---|
jsonJSON de entrada | no se acepta en enlaces: escríbelo en la página | |
delimiterDelimitador | uno de: comma, semicolon, tab, pipe | predeterminado: comma |
headerEscribir una fila de encabezado | true o false | predeterminado: true |
byte_order_markAñadir una marca de orden de bytes (BOM) para que Excel lea bien UTF-8 | true o false | predeterminado: false |
Ejemplos
?delimiter=semicolon&byte_order_mark=true?delimiter=tab&header=false
Escribe los decimales con punto. Codifica un espacio como %20, + como %2B, # como %23 y & como %26.
Elementos del resultado: [data-result-block="csv-json"]