Convertidor de JSON a CSV

Convertidor de JSON a CSV

Bienvenido al Convertidor de JSON a CSV, una herramienta gratuita en línea que aplana cualquier carga útil de JSON (matrices planas, objetos anidados, respuestas de API profundamente envueltas) en un CSV limpio y listo para hojas de cálculo. La mayoría de los convertidores en línea solo manejan el caso trivial de [{...}, {...}] en la raíz y fallan cuando su JSON se ve como {"data": {"items": [...]}}. Esta herramienta realiza una detección automática inteligente de la matriz tabular, expone un selector estilo JSONPath para formas inusuales y le ofrece dos modos de aplanado (punto y corchete), además de una vista previa del esquema para que sepa exactamente qué columnas aparecerán en su hoja de cálculo antes de descargar.

¿Para qué se utiliza el Convertidor de JSON a CSV?

JSON es la lingua franca de las API web y los pipelines de datos modernos, mientras que CSV sigue siendo el rey para las hojas de cálculo, los paneles de BI y las herramientas de análisis de datos. Convertir de uno a otro es una de las tareas más comunes en el día de un ingeniero de datos. Los casos de uso típicos incluyen exportar una respuesta de API a Excel para las partes interesadas, preparar volcados de JSON para importar en Postgres o BigQuery, alimentar registros JSON en Pandas o R para análisis y escanear rápidamente una respuesta anidada ruidosa en una forma tabular más amigable.

Características Principales

• Detección automática inteligente de matrices: el convertidor recorre su JSON y elige la matriz más grande y parecida a una tabla, generalmente la que realmente deseaba.
• Selector JSONPath: anule la detección automática con una ruta como data.users o results[0].rows para profundizar en respuestas envueltas.
• Dos modos de aplanado: notación de puntos (address.city) para nombres de columnas limpios, o matrices con corchetes (tags[0], tags[1]) cuando cada elemento debe ser su propia columna.
• Descubrimiento de esquema: un panel de pastillas de columnas con insignias de tipo (cadena, entero, número, booleano, mixto) para que pueda auditar la salida antes de descargar.
• Tabla de vista previa en vivo: las primeras ocho filas se representan como una tabla HTML: verificación instantánea de que sus datos se alinearon correctamente.
• Delimitadores personalizados: coma (CSV), punto y coma (Excel europeo), tabulación (TSV), tubería o cualquier carácter individual que especifique.
• Modos de comillas: mínimo (RFC 4180), entrecomillar todo, entrecomillar no numéricos o nunca (con escape de barra invertida).
• Finales de línea compatibles con Excel: alterne entre LF y CRLF.
• Fila de encabezado opcional.
• Muestras con un clic: matriz plana, respuesta envuelta, objetos anidados, API estilo GitHub y pronóstico del tiempo.
• Copiar y descargar: obtenga el CSV instantáneamente o guárdelo como un archivo .csv.

¿Cómo maneja el convertidor los objetos y matrices anidados?

El JSON del mundo real rara vez es plano. El motor de aplanado del convertidor maneja las dos formas principales de manera inteligente:

Objetos Anidados → Notación de Puntos

Un objeto dentro de otro objeto se convierte en un nombre de columna con puntos. Así, un registro como {"id": 1, "address": {"city": "Tokyo", "zip": "100-0001"}} produce tres columnas: id, address.city, address.zip. Esta convención es utilizada por json_normalize de Pandas, Splunk, Elasticsearch y docenas de otras herramientas; sus pipelines posteriores ya la entenderán.

Matrices Anidadas → Dos Estrategias

Las matrices de escalares (ej. "tags": ["red", "blue"]) y las matrices de objetos (ej. "orders": [{...}, {...}]) reciben un tratamiento diferente según el modo de aplanado elegido:

• Modo de punto: las matrices de escalares se unen con el carácter de tubería en una sola celda (red|blue); las matrices de objetos se codifican en JSON para que los datos no se pierdan. Esto mantiene predecible el recuento de columnas.
• Modo de corchete: cada elemento obtiene su propia columna indexada: tags[0], tags[1], orders[0].id, orders[0].total. Ideal cuando los registros tienen una matriz de longitud fija conocida.
• Mantener anidado como JSON: las estructuras anidadas se serializan como una cadena JSON y se insertan en una celda. Útil cuando la hoja de cálculo de destino tiene una columna con reconocimiento de JSON o desea conservar la forma original.

¿Para qué sirve el selector JSONPath?

La mayoría de las API públicas envuelven sus datos en metadatos adicionales: códigos de estado, información de paginación, ID de solicitud. Una respuesta típica se ve así:

La detección automática generalmente encontrará la matriz interna, pero para formas inusuales o profundamente anidadas, puede proporcionar la ruta explícitamente. El selector admite claves con puntos e índices numéricos entre corchetes:

• data — profundizar en la clave data
• data.users — profundizar en data, luego en users
• results[0].rows — primer elemento de results, luego su clave rows
• (vacío) — detección automática de la matriz más parecida a una tabla

¿Produce un CSV compatible con Excel?

Sí. La configuración predeterminada (delimitador de coma, comillas mínimas, fila de encabezado, finales de línea LF) produce una salida RFC 4180 estricta que se abre limpiamente en Excel, Google Sheets, Numbers, LibreOffice Calc, read_csv de Pandas, read.csv de R y cada comando COPY FROM de base de datos. Para las configuraciones regionales europeas de Excel que usan el punto y coma como separador de campos, cambie el menú desplegable de Delimitador a Punto y coma. Para las herramientas nativas de Windows que prefieren los finales de línea \r\n, cambie el Final de línea a CRLF.

¿Cómo se manejan los campos faltantes entre filas?

Las matrices JSON a menudo contienen registros heterogéneos: un objeto tiene un middle_name, el siguiente no. El convertidor recorre cada registro y recopila los nombres de las columnas en el orden en que se ven por primera vez; cualquier registro al que le falte una columna obtiene una celda vacía en esa posición. Este es el mismo comportamiento que json_normalize de Pandas y evita que se descarten silenciosamente campos que solo aparecen en algunos registros.

Casos de Uso Prácticos

Para Desarrolladores

• Convertir respuestas de API REST a CSV para exploración en una hoja de cálculo
• Aplanar exportaciones de MongoDB o Firestore para importarlas en una base de datos relacional
• Convertir líneas de registro JSON en un formato tabular para análisis
• Generar accesorios de prueba combinando JSON de muestra con la salida del modo corchete

Para Analistas y Científicos de Datos

• Previsualizar rápidamente datos de API en forma tabular sin escribir un script de Pandas
• Preparar JSON de raspado web para importar en Excel, Tableau o Power BI
• Convertir un conjunto de datos JSON en un CSV para su uso en Jupyter o RStudio
• Auditar campos anidados con el panel de descubrimiento de esquemas antes de la importación real

Para Especialistas en Marketing y Operadores

• Exportar datos de herramientas que emiten JSON (análisis, exportaciones de CRM) a Google Sheets
• Crear tablas dinámicas o gráficos sobre la salida de la API JSON
• Entregar un CSV amigable a las partes interesadas no técnicas sin mostrarles el JSON sin procesar

Cómo usar esta herramienta

1. Pegar JSON: pegue su JSON en el cuadro de entrada o haga clic en un botón de Muestra Rápida para cargar una carga útil típica de API.
2. Elegir la matriz: deje el campo JSONPath vacío para que la herramienta detecte automáticamente la matriz tabular, o escriba una ruta como data.users para apuntar a una matriz envuelta.
3. Elegir modo de aplanado: seleccione notación de puntos para nombres de columna limpios, corchetes en matrices para expandir cada elemento de la matriz, o Mantener anidado como JSON para preservar las subestructuras textualmente.
4. Elegir delimitador y comillas: seleccione coma, punto y coma, tabulación (TSV), tubería o un carácter personalizado, luego elija un modo de comillas y final de línea.
5. Convertir y revisar: haga clic en Convertir a CSV. Inspeccione el panel de esquema y la tabla de vista previa, luego copie el resultado o descárguelo como un archivo .csv.

Consejos para mejores resultados

• Validar primero: el indicador en vivo debajo del cuadro de entrada señala errores de sintaxis JSON antes de hacer clic en Convertir.
• Consulte el panel de esquema: una columna etiquetada como mixta (mixed) significa que el mismo campo tiene diferentes tipos entre registros; generalmente es una señal de que un error de ingesta ascendente necesita solución.
• Use el modo corchete para matrices fijas: si cada registro tiene, por ejemplo, exactamente cuatro puntajes, el modo corchete le brinda cuatro columnas limpias en lugar de una sola celda unida por tuberías.
• Para Excel europeo: elija el delimitador de Punto y coma para que 1,5 (uno y medio) no se divida en dos celdas.
• Para Excel en Windows: elija finales de línea CRLF para evitar el problema de "todo en la columna A".
• Entrecomillar todo por seguridad: si sus datos contienen comas, saltos de línea o su carácter delimitador, prefiera Entrecomillar todos los campos para obtener una salida más defensiva.

Preguntas Frecuentes

¿Qué sucede si mi JSON tiene múltiples matrices?

La detección automática elige la más grande que contiene objetos. Si esa no es la matriz que desea, proporcione un JSONPath como orders o line_items para apuntar a la correcta.

¿Puedo convertir un solo objeto JSON en lugar de una matriz?

Sí; un solo objeto se convierte en un CSV de una sola fila con cada campo de nivel superior como una columna. Las reglas de aplanado siguen aplicándose.

¿Qué pasa con el JSON con números no finitos (NaN, Infinity)?

El estándar JSON no permite estos literales, pero si su entrada los contiene y se analiza correctamente, se convierten en celdas vacías en la salida CSV para mantener el archivo válido.

¿Por qué algunos valores booleanos se representan como true / false?

Para mantener el CSV legible para humanos. Si su herramienta posterior necesita 1 / 0, realice una búsqueda y reemplazo después de la descarga o procese el JSON de antemano.

¿El convertidor valida que todos los registros tengan la misma forma?

No; los registros heterogéneos se manejan con elegancia (los campos faltantes se convierten en celdas vacas). El panel de esquema muestra la variación de tipos a través de la insignia mixed para que pueda detectar inconsistencias.

¿Qué tamaño de JSON puedo convertir?

La herramienta maneja cómodamente entradas JSON de hasta unos pocos megabytes en el navegador y en el servidor. Para conjuntos de datos muy grandes (decenas de MB o más), prefiera una herramienta fuera de línea como jq o un script de Python con ijson.

¿Se envían mis datos a un servidor?

La conversión se realiza en el servidor de MiniWebtool para aprovechar el robusto escritor de CSV y el analizador de JSON de Python. No registramos, almacenamos ni compartimos su entrada. Las respuestas se sirven con encabezados no-cache. Para una máxima confidencialidad con datos sensibles, prefiera el procesamiento fuera de línea.

Recursos Adicionales

• Valores separados por comas - Wikipedia
• JSON - Wikipedia
• RFC 4180 - El formato de archivo CSV

Otras herramientas relacionadas:

Otras herramientas para texto:

• Generador de anagramas Destacado
• Convertidor de Lectura Biónica
• Comparar dos cadenas
• Encontrar la línea más larga
• Detector de Idiomas con IA
• Procesador de líneas de texto
• Validador XML
• Lector de texto a voz
• Extractor de Columnas de Texto
• Convertidor JSON a YAML
• Probador de Regex Nuevo
• Comparador de Diferencias Nuevo
• Convertidor de CSV a JSON Nuevo
• Convertidor de Imagen a Base64 Nuevo
• Probador de API Nuevo
• Tabla ASCII Nuevo
• Probador de Webhook Nuevo
• Generador de Títulos de Blog con IA Nuevo
• Generador de Hashtags con IA Nuevo
• Generador de eslóganes con IA Nuevo
• Generador de Esquemas de Artículos con IA Nuevo
• Bloc de Notas en Línea Nuevo
• Conversor de TOML a JSON Nuevo
• Convertidor de JSON a CSV Nuevo
• Conversor de XML a JSON Nuevo
• Convertidor de Consultas SQL a MongoDB Nuevo