Qué maneja realmente la conversión de JSON a CSV
JSON es jerárquico. CSV es plano. Convertir JSON a CSV significa decidir qué hacer con objetos anidados, qué hacer con matrices y cuál delimitador hace que el resultado sea compatible con la herramienta de hoja de cálculo o pipeline en la que estás a punto de pegarlo.
Los objetos anidados se convierten en columnas con notación de puntos. Un objeto JSON {"user": {"name": "Ana", "age": 33}} se convierte en columnas CSV user.name,user.age con valores Ana,33 en la misma fila. Sin aplamiento, la columna user contendría la cadena [object Object] y el resto de la jerarquía se perdería.
Las matrices presentan tres opciones. Puedes unir los elementos de la matriz en una sola celda con un separador como |, dividir cada elemento de la matriz en una nueva fila y repetir los campos principales, o convertir la matriz a cadena JSON dentro de una sola celda CSV. La opción correcta depende de lo que estés importando. Los usuarios de Excel generalmente quieren filas divididas. Las importaciones de bases de datos generalmente quieren una unión.
Los delimitadores importan porque CSV significa valores separados por comas, pero muchas regiones y plataformas esperan puntos y comas, y los archivos delimitados por tabuladores evitan problemas de escape cuando las comas aparecen dentro de tus datos. El conversor te permite elegir coma, punto y coma, tabulador o barra vertical.
El modo inverso lee CSV y lo convierte de vuelta a JSON. Eliges si la primera fila son encabezados, si las columnas con notación de puntos deben anidarse de nuevo en objetos, y si deseas generar una matriz de objetos o un único objeto con claves de fila.
Cómo usar este conversor de JSON a CSV
- Pega JSON en JSON or CSV input, o arrastra una URL si tu JSON está en un endpoint de API y la obtenemos para ti.
- Establece Mode en JSON → CSV o CSV → JSON.
- Elige tu Delimiter. Coma es el valor predeterminado. Cambia a punto y coma si estás enviando a Excel en una configuración regional europea, tabulador si tu JSON tiene comas en valores de cadena, o barra vertical si estás canalizando el resultado en un script de Unix.
- Activa Flatten nested keys with dot notation si tu JSON tiene más de un nivel de anidamiento. Desactívalo si prefieres que los objetos anidados se conviertan a cadena en celdas individuales.
- Haz clic en Convert. Verás una tabla de vista previa mostrando las primeras 20 filas y cada columna. Verifica que el aplamiento y el manejo de matrices coincidan con tus expectativas.
- Haz clic en Download CSV para guardar el archivo, o copia el resultado y pégalo directamente en Google Sheets, Excel o tu herramienta de importación de base de datos.
Intenta pegar este JSON:
[
{"product": "Widget A", "sales": {"Q1": 1200, "Q2": 1450}, "tags": ["new", "sale"]},
{"product": "Widget B", "sales": {"Q1": 980, "Q2": 1100}, "tags": ["featured"]}
]
Con aplamiento activado y delimitador establecido en coma, el resultado es:
product,sales.Q1,sales.Q2,tags
Widget A,1200,1450,new|sale
Widget B,980,1100,featured
Sin aplamiento, la columna sales muestra [object Object] y pierdes el desglose trimestral. El valor predeterminado de unión de matrices usa | como separador. Cambia al modo de división de filas y obtendrás cuatro filas: una por etiqueta por producto.
Por qué la conversión de JSON a CSV importa para flujos de trabajo de datos
Los archivos planos son el formato universal de intercambio. JSON es el formato de salida de todas las API modernas, paneles de análisis y webhooks. Si tu flujo de trabajo implica tomar datos de un sistema e insertarlos en otro, convertirás JSON a CSV al menos una vez a la semana.
Exportaciones de API. La mayoría de las API REST devuelven JSON de forma predeterminada. Google Analytics Data API, informes de Stripe, versiones de GitHub, exportaciones de Airtable — todo JSON. Cargar esos datos en Power BI, Tableau o una base de datos SQL es más rápido cuando llegan como CSV. Puedes automatizar la conversión, pero verificar manualmente el resultado primero detecta sorpresas de esquema antes de que se conviertan en errores de pipeline.
Pipelines de transformación de datos. Los flujos de trabajo ETL a menudo se dividen en una etapa de obtención que extrae JSON y una etapa de carga que espera CSV. Aplanar JSON anidado en el navegador antes de la carga ahorra escribir y mantener un script de transformación. Para migraciones puntuales o análisis exploratorio, este conversor termina el trabajo en menos de un minuto.
Importaciones de hojas de cálculo. Los analistas que no escriben código aún pueden importar datos de API si tienen una forma de convertir JSON a CSV. Google Sheets y Excel manejan el pegado y la importación de archivos CSV. Ninguno maneja JSON sin procesar a menos que escribas un script. Esta herramienta cierra la brecha.
La opción de delimitador previene corrupción de datos silenciosa. CSV delimitado por comas se rompe cuando un campo de texto contiene una coma a menos que cada valor esté entre comillas y el carácter de comilla esté escapado. Los delimitadores de tabulador y punto y coma evitan ese problema en la mayoría de los conjuntos de datos. Si tu JSON incluye direcciones, descripciones de productos o texto generado por el usuario, cambia a tabulador.
Aplamiento de JSON anidado explicado
CSV plano tiene una fila por registro y un valor por columna. JSON anidado tiene objetos dentro de objetos. El aplamiento cierra la brecha convirtiendo cada nivel de anidamiento en un nombre de columna con un separador de punto.
Un objeto JSON con tres niveles:
{
"company": "Acme Inc",
"contact": {
"person": "Jane Doe",
"email": {"work": "[email protected]", "personal": "[email protected]"}
}
}
se convierte en cuatro columnas CSV:
company,contact.person,contact.email.work,contact.email.personal
Acme Inc,Jane Doe,[email protected],[email protected]
La notación de puntos preserva la jerarquía original de una manera que puedes invertir. Algunos conversores de CSV a JSON reconocen columnas con notación de puntos y reconstruyen la estructura anidada. Si desactivas el aplamiento, el conversor convierte objetos anidados a cadena en una sola celda. Ese resultado es legible en una hoja de cálculo pero no es reversible de vuelta a datos estructurados.
Las matrices dentro de objetos presentan una opción. Si un objeto tiene "tags": ["new", "sale", "limited"] puedes unir la matriz en una sola celda como new|sale|limited, dividir en tres filas con las otras columnas repetidas, o convertir la matriz a cadena como un fragmento JSON ["new","sale","limited"]. El modo de unión mantiene una fila por registro y es el valor predeterminado. El modo de división es útil cuando la matriz representa una relación uno a muchos. El modo de stringificación preserva información de tipo pero hace que CSV sea más difícil de consultar.
Cuando tu JSON incluye tipos mixtos — algunos registros tienen una matriz donde otros tienen una única cadena — el conversor los normaliza envolviendo valores únicos en una matriz antes de aplicar la regla de manejo de matrices elegida. Eso previene columnas faltantes y mantiene el esquema CSV consistente.
Errores comunes
- Pegar un fragmento JSON en lugar de una estructura completa. El conversor espera JSON válido: ya sea una matriz de objetos
[{…}, {…}]o un único objeto{…}. Si pegas una respuesta de API truncada o un fragmento JSON sin llaves de cierre, el analizador lanza un error. Copia la respuesta completa. - Dejar el aplamiento activado cuando quieres legibilidad sobre reversibilidad. Los nombres de columnas aplanados como
meta.author.profile.urlson difíciles de escanear en una hoja de cálculo. Si solo necesitas leer los datos y no los convertirás de vuelta a JSON, desactiva el aplamiento y acepta objetos anidados stringificados. - Usar delimitador de coma cuando tus datos tienen comas. Las direcciones, nombres completos y descripciones de productos casi siempre incluyen comas. Si tu JSON contiene campos de texto de forma libre, cambia a delimitador de tabulador o barra vertical antes de convertir. De lo contrario, abrirás el CSV en Excel y verás columnas desplazadas.
- Olvidar que los archivos grandes exceden la memoria del navegador. Este conversor se ejecuta en el cliente. Si tu JSON es más grande de 50 MB, el navegador puede congelarse o bloquearse. Para conjuntos de datos de ese tamaño, usa una herramienta de línea de comandos como
jqocsvkit. - No previsualizar el resultado antes de descargar. La tabla de vista previa muestra las primeras 20 filas y cada columna. Verifica. Un delimitador incorrecto o una división de matriz sorprendente pueden duplicar el número de filas y romper importaciones posteriores. Arreglarlo después de descargar desperdicia tiempo.
Consejos avanzados
- Valida tu JSON primero. Si el conversor lanza un error de sintaxis y no puedes detectar el problema a simple vista, pega tu JSON en un validador como
jsonlint.como ejecútalo a través dejq .en la línea de comandos. El mensaje de error señalará el número de línea. - Usa el modo inverso para viaje de ida y vuelta de tus datos. Convierte JSON a CSV, edita el CSV en tu hoja de cálculo, luego convierte de vuelta a JSON. Este flujo de trabajo es más rápido que escribir un script cuando necesitas editar en lote propiedades de objetos.
- Para JSON profundamente anidado, aplana primero, luego filtra columnas en tu herramienta de hoja de cálculo. Una jerarquía de diez niveles produce docenas de columnas con notación de puntos. La mayoría de ellas están vacías para la mayoría de filas. Elimina las columnas vacías después de la importación.
- Guarda la vista previa como captura de pantalla antes de descargar. Si estás convirtiendo datos de API para un informe o auditoría, la vista previa te da evidencia de la estructura y el número de filas. Los stakeholders preguntarán "¿cuántos registros importaste?" y la captura de pantalla lo responde.
- Cuando trabajes con matrices de primitivos como
["red", "blue", "green"], el modo de unión con delimitador de barra vertical es casi siempre la opción correcta. El modo de división solo tiene sentido cuando cada elemento de matriz necesita su propia fila para normalización de base de datos.
Una vez que tengas tu CSV, el siguiente paso es generalmente filtrado o reformulación. Si tu CSV incluye una columna de palabras clave y quieres combinarla con otras listas, pásala por nuestro keyword combiner para generar permutaciones. Si estás construyendo URLs a partir de filas CSV, alimenta la columna relevante en el slug generator para producir slugs de URL limpios en lote. Cuando tu CSV es el resultado de una auditoría SEO y quieres validar la estructura, usa el SEO checklist para confirmar que cada campo que necesitas está presente.