What is JSON to CSV converter online: anatomía de la herramienta (Guía 2026)

What is JSON to CSV converter online? Cinco máquinas, no una

Cuando pegas JSON en un conversor y sale un CSV, parece una sola acción. No lo es. Todo conversor de JSON a CSV online, incluido el de esta página, ejecuta las mismas cinco etapas en el mismo orden: analizar, buscar filas, aplanar, serializar, descargar. Saber qué etapa hace qué cambia cómo lees cada mensaje de error y cada celda de aspecto extraño, porque cada tipo de problema pertenece exactamente a una etapa.

El flujo importa por una segunda razón: las opciones de la página no son ajustes mágicos. Cada interruptor y cada lista desplegable se conecta con una etapa concreta. El interruptor de aplanado controla la etapa tres. La elección del delimitador controla la etapa cuatro. Cuando ves el mapa, las opciones dejan de ser adivinanzas y pasan a ser decisiones.

Esta guía recorre las cinco etapas en orden con el mismo registro de pedido pequeño, para que veas a cada máquina hacer su trabajo. Cada salida que verás la produjo el conversor real de esta página, no es un dibujo explicativo.

Parte 1: el analizador, el portero de la puerta

La etapa uno lee tu pegado y decide si es JSON o no. Es la máquina más estricta del flujo y la menos indulgente: el JSON con una comilla faltante, una coma final o un carácter suelto se rechaza aquí, antes de que se ejecute nada más. Eso es una ventaja. Un conversor que adivinara con entradas rotas produciría en silencio una tabla incorrecta.

Cuando el analizador rechaza tu entrada, te dice dónde se detuvo, que suele estar a uno o dos caracteres del error real. Los dos rechazos más comunes son el cuadro vacío y el JSON mal formado, y los mensajes son claros:

What the parser reports

Input: (empty box)
Output: Input is empty. Please paste or upload JSON data.

En esta etapa nada de tus datos cambia. El analizador acepta el JSON y entrega los valores estructurados a la etapa dos, o detiene todo el flujo con un error. Si alguna vez ves que un conversor produce una tabla a partir de una entrada que sabes que está rota, ese conversor se saltó la validación, y no deberías confiar en su salida.

Parte 2: el buscador de filas, de dónde salen las filas

La etapa dos mira el JSON analizado y responde una pregunta: ¿qué se convierte en una fila? Un CSV es una lista de filas, así que el conversor tiene que encontrar una lista en alguna parte de tus datos. El caso fácil es una matriz de objetos en el nivel superior: cada objeto se convierte en una fila, punto.

Los datos reales rara vez son tan ordenados. A las APIs les encanta envolver sus listas: {"users": [...], "total": 2}. Un buen buscador de filas detecta la lista envuelta, la usa como filas e ignora los campos del envoltorio. Un solo objeto sin lista se convierte en exactamente una fila. El JSON delimitado por saltos de línea, un objeto por línea, se lee como una fila por línea.

Input: a wrapped list, as APIs return it

{"users": [{"name": "Amelia", "city": "Austin"}, {"name": "Bruno", "city": "Berlin"}], "total": 2}

El buscador de filas extrae la lista de usuarios y crea dos filas con columnas de nombre y ciudad. El campo total no es una fila ni una columna, así que se descarta. Esta es la etapa a la que culpar cuando tu salida tiene menos filas de las que esperabas, o cuando faltan columnas que esperabas: el conversor encontró una lista distinta de la que tenías en mente.

Parte 3: el aplanador, la única transformación real

La etapa tres es la única que cambia la forma de tus datos. Las celdas de un CSV no pueden contener objetos ni listas, así que todo lo anidado tiene que reescribirse antes de caber en una tabla. El aplanador sube cada valor anidado al nivel superior con reglas fijas: los objetos anidados se convierten en columnas con notación de puntos, las listas cortas de valores simples se convierten en una celda con los valores unidos, y las listas de objetos se convierten en texto JSON dentro de una celda entre comillas.

Este es el registro de entrada que usa esta guía, con un objeto de cliente anidado, una lista de etiquetas y una nota que contiene una coma:

Input JSON (nested)

[{"id": "A-101", "customer": {"name": "Amelia", "city": "Austin"}, "tags": ["new", "vip"], "note": "ships, fast"}]

Parte 3: el aplanador, la única transformación real (continuación)

Y esto es lo que el aplanador entrega a la siguiente etapa, verificado contra el conversor real:

Flattened output (verified against the real engine)

id,customer.name,customer.city,tags,note
A-101,Amelia,Austin,new; vip,"ships, fast"

Léelo columna por columna. El objeto de cliente se convirtió en dos columnas, customer.name y customer.city. La lista de etiquetas se convirtió en una celda, new; vip, con los valores unidos por un punto y coma y un espacio. La nota conservó su coma, y la etapa cuatro se encargará de eso. Los valores nulos y las listas vacías se convierten en celdas vacías. Nada se inventa y nada se borra, pero un árbol se ha convertido en una tabla.

Apaga el interruptor de aplanado y la etapa tres se salta: los valores anidados quedan como texto JSON dentro de sus celdas, entre comillas para que la tabla siga siendo válida. A veces eso es lo que quieres, cuando el sistema receptor vuelve a analizar el JSON, y a veces es un desastre. De cualquier forma, es esta etapa la que lo hace.

Parte 4: el serializador, el motor de comillas

La etapa cuatro convierte las filas aplanadas en texto CSV, y su único trabajo es mantener la tabla válida. La regla que sigue es simple: una celda que contiene el delimitador, un carácter de comilla o un salto de línea se envuelve entre comillas dobles, y cualquier comilla interior se duplica. Todo lo demás se escribe sin comillas.

La parte sutil es que el entrecomillado sigue al delimitador en uso, no a una idea fija de lo que es especial. Mira el mismo registro serializado con delimitador de punto y coma, verificado contra el conversor real:

Semicolon output (verified against the real engine)

id;customer.name;customer.city;tags;note
A-101;Amelia;Austin;"new; vip";ships, fast

La celda de etiquetas ahora va entre comillas, porque new; vip contiene un punto y coma. Pero la nota ships, fast va sin comillas: con puntos y coma como delimitador, una coma es un carácter normal y no necesita protección. El motor entrecomilla según el delimitador real en uso. Por eso un CSV que se ve perfecto puede abrirse como una sola columna en Excel: Excel lo dividió con un delimitador distinto del que usó el serializador, lo cual es un desajuste de la etapa cuatro, no datos rotos.

Parte 4: el serializador, el motor de comillas (continuación)

Un delimitador más, porque sorprende a la gente: la tabulación. Las tabulaciones casi nunca aparecen dentro de datos reales, así que la salida separada por tabulaciones normalmente no necesita comillas:

Tab output (verified against the real engine)

id	customer.name	customer.city	tags	note
A-101	Amelia	Austin	new; vip	ships, fast

Sin comillas en ninguna parte. El interruptor de encabezado también es una opción de la etapa cuatro: simplemente decide si los nombres de las columnas se escriben como primera fila. Nada más cambia.

Parte 5: la descarga, UTF-8 puro y un nombre de archivo

La etapa cinco es la menos interesante y la más fácil de arruinar. Toma el texto terminado y te lo entrega como un archivo. Esta página lo llama data-export-YYYY-MM-DD.csv para que las descargas repetidas se ordenen por fecha, y lo escribe como UTF-8 puro sin marca de orden de bytes (BOM).

El detalle del BOM vale la pena porque pica en Excel. Algunos programas esperan un BOM para detectar UTF-8; sin él, los caracteres con acento pueden mostrarse como símbolos raros al hacer doble clic en el archivo. La solución está en el lado de la apertura, no en el archivo: en Excel, importa el archivo como importación de texto y elige la codificación 65001: Unicode (UTF-8). El archivo en sí está bien.

Dónde se conecta cada opción de la página

Con las cinco etapas mapeadas, las opciones del conversor se leen como un diagrama de cableado. El interruptor de aplanar valores anidados activa u omite la etapa tres. La elección del delimitador, coma, punto y coma, tabulación o barra vertical, fija el carácter contra el que la etapa cuatro entrecomilla. El interruptor de incluir fila de encabezado añade o quita la fila de nombres de columna en la etapa cuatro. La conversión automática simplemente vuelve a ejecutar todo el flujo con cada pulsación en lugar de esperar un botón.

No hay ninguna opción que llegue al analizador, y es deliberado: la validación no es una preferencia. Un conversor que te dejara desactivar la etapa uno produciría basura con aspecto confiable a partir de entradas rotas.

Cuando la salida se ve mal, culpa exactamente a una parte

El diagnóstico es el motivo de conocer el flujo. Empareja el síntoma con la etapa y sabrás dónde mirar:

Un mensaje de error que nombra una posición: etapa uno, el analizador. Tu JSON está mal formado cerca del punto indicado; valídalo y corrige la fuente.
Menos filas o columnas faltantes: etapa dos, el buscador de filas. El conversor eligió una lista distinta de la que pretendías, o tu forma de envoltorio lo confundió.
Datos anidados como texto JSON ilegible en las celdas: etapa tres, el aplanador, está apagado o los datos eran demasiado profundos. Activa el aplanado.
Todo cae en una columna al abrirlo: etapa cuatro, el serializador, usó un delimitador distinto del que espera tu hoja de cálculo. Reimporta y elige el delimitador correcto, o regenera con punto y coma o tabulación.
Comillas sueltas o filas divididas: entrecomillado de la etapa cuatro, normalmente por la opción de quoteMode en never o por CSV editados a mano. Deja el entrecomillado en automático.
Caracteres raros al abrir: etapa cinco, la codificación de la descarga. Reimporta como UTF-8 (65001) en lugar de hacer doble clic.

Lo que un conversor de JSON a CSV online no es

El flujo también define los límites. Un conversor no es un editor de JSON: no puede arreglar tus datos, renombrar tus campos ni decidir qué significa una columna. Tampoco es un formateador de JSON, aunque el analizador valida como efecto secundario; si quieres JSON bien impreso, esa es otra herramienta. No es una hoja de cálculo: una vez descargado el CSV, el ordenamiento, el filtrado y las fórmulas ocurren en Excel o Sheets, no en el conversor.

Y no puede cambiar lo que significan tus datos. Aplanar conserva los valores pero colapsa los tipos: números, booleanos y nulos se convierten en texto, la estructura anidada se convierte en nombres de columna, y no hay forma de volver al árbol original solo desde el CSV. Cuando las filas tienen formas distintas, el conversor toma la unión de todas las columnas y deja blancos donde una fila no tiene un campo. Es un comportamiento honesto, pero vale la pena saberlo antes de convertir: un conversor reordena tus datos con fidelidad, y la fidelidad es todo lo que promete.

Guías relacionadas

Preguntas frecuentes

¿Qué es un conversor de JSON a CSV online en una frase?

Es una página web que convierte datos JSON en un archivo CSV en cinco pasos, analizador, buscador de filas, aplanador, motor de comillas y descarga, con todo el flujo ejecutándose en tu pestaña del navegador.

¿Cuáles son las cinco partes de un conversor de JSON a CSV?

El analizador, que valida el JSON; el buscador de filas, que decide qué se convierte en fila; el aplanador, que convierte los valores anidados en celdas simples; el serializador, que escribe texto CSV válido con el entrecomillado correcto; y el paso de descarga, que te entrega el archivo. Las opciones de la página se conectan con las tres del medio.

¿Por qué el conversor entrecomilla algunas celdas y otras no?

El entrecomillado sigue al delimitador en uso. Una celda se envuelve entre comillas solo si contiene el delimitador activo, un carácter de comilla o un salto de línea, y las comillas interiores se duplican. Cambia el delimitador y otras celdas quedarán entrecomilladas, lo cual es un comportamiento correcto, no una inconsistencia.

¿Por qué mi CSV se abrió como una sola columna en Excel?

Es un desajuste de delimitador en la etapa del serializador, no datos rotos. Excel divide las columnas con el separador de listas de tu sistema, que es una coma en algunas regiones y un punto y coma en otras. Reimporta el archivo y elige el delimitador que corresponda, o regenera el CSV con la opción de punto y coma o tabulación.

¿Un conversor de JSON a CSV es lo mismo que un formateador de JSON?

No. Un formateador imprime JSON de forma legible para que lo lean personas; un conversor reestructura JSON en una tabla para que la abran hojas de cálculo. El analizador del conversor sí valida tu JSON como efecto secundario, por eso una entrada inválida produce un error en lugar de una tabla, pero formatear no es su trabajo.

¿Un conversor puede arreglar JSON roto o inválido?

No, y deberías desconfiar de uno que lo intente. La etapa del analizador rechaza el JSON mal formado con un error que nombra la posición donde se detuvo. Arregla el JSON en la fuente, una comilla faltante o una coma final cerca de la posición indicada, y convierte de nuevo.

¿El conversor cambia mis datos, o solo el formato?

Los valores se conservan pero la forma cambia. Aplanar convierte los objetos anidados en columnas con notación de puntos y las listas en celdas unidas, y cada valor se convierte en texto: números, booleanos y nulos pierden sus tipos. Las filas con formas distintas obtienen la unión de todas las columnas con blancos donde falta un campo.

Mira las cinco partes en acción

Pega cualquier JSON en el conversor de esta página y mira cómo trabajan el analizador, el aplanador y el motor de comillas. Gratis, sin registro, todo se ejecuta en tu navegador.

Abrir el conversor de JSON a CSV

Todas las guías