Convertir JSON a CSV
Convierte un array de objetos JSON a formato CSV.
¿Qué hace convertir JSON a CSV?
El JSON que devuelve una API es un formato pensado para máquinas, así que una hoja de cálculo no puede abrirlo tal cual. Esta herramienta lee un array de objetos JSON y lo convierte a CSV, con las claves como fila de encabezado y cada elemento como una fila. El resultado se presta a sumar y ordenar en Excel o Google Sheets.
Hay dos supuestos. El primero: la entrada debe ser un array de objetos; envuelva un objeto suelto en un array antes de introducirlo. El segundo se refiere al anidamiento profundo: cuando un valor es a su vez un objeto o un array, no se despliega en columnas, sino que se coloca en la celda como cadena JSON. Aplanarlo de antemano hace el resultado más manejable.
Pasos para convertir JSON a CSV
- Pegue su JSON Pegue un array de objetos en el campo de entrada. Copiar directamente una respuesta de API es perfectamente válido.
- Compruebe el resultado de la conversión Las claves pasan a ser la fila de encabezado y cada elemento se convierte en una fila. Confirme que están las columnas que esperaba.
- Descargue el CSV La codificación es UTF-8. Si el texto aparece ilegible en Excel, indique UTF-8 durante la importación.
Consejos para aprovecharla mejor
- La entrada debe ser un array de objetos JSON (
[{}, {}, ...]). No se admiten objetos individuales. - Muy útil para trabajar con datos de respuesta de una REST API en Excel o Google Sheets.
- Los valores de objetos o arrays con anidamiento profundo no se aplanan — se muestran como una cadena JSON (p. ej.
{"a":1}). - El CSV descargado está codificado en UTF-8. Si ves caracteres extraños en Excel, ábrelo como UTF-8 con BOM.
Cuándo resulta útil convertir JSON a CSV
Procesar una respuesta de API
Convierta a CSV los datos obtenidos y podrá procesarlos directamente con funciones de la hoja de cálculo o con una tabla dinámica.
Compartir con quien no es desarrollador
Entregue los datos en forma de tabla a alguien que no sabe leer JSON en bruto. Pedir una revisión o una corrección se vuelve mucho más sencillo.
Usar el CSV como formato intermedio en una migración
Práctico para convertir datos de camino a una herramienta que admite importación CSV, algo que hacen muchísimos servicios.
Comprobar el número de registros y los huecos
En una tabla, el número de filas y las celdas vacías se ven de un vistazo, lo que sirve para verificar que tiene los registros previstos.
Términos de JSON y CSV
- Array de objetos
- Una estructura que alinea varios objetos con la forma
[{...}, {...}]. Como cada uno corresponde a una fila de tabla, puede convertirse a CSV. - Clave
- El nombre que señala un valor dentro de un objeto. En CSV pasa a ser un nombre de columna en la fila de encabezado.
- Anidamiento
- Una estructura en la que un valor contiene a su vez otro objeto o array. Es justamente la parte que no encaja bien en una tabla.
- Aplanado
- Desplegar las estructuras anidadas en un solo nivel. Hecho de antemano, permite tratarlas como columnas CSV.
- BOM
- Una marca de orden de bytes colocada al inicio del archivo para señalar la codificación. Se usa cuando quiere que Excel abra correctamente un CSV en UTF-8.
Preguntas frecuentes
[{}, {}]). Si tienes un objeto individual, envuélvelo en un array primero (p. ej. [{}]).{"a":1} para un objeto). Aplana tu estructura JSON antes de convertir si necesitas esos valores en columnas separadas.
A propósito — El origen de JSON: "descubierto", no inventado
JSON (JavaScript Object Notation) fue formalizado por Douglas Crockford alrededor de 2001. Ha afirmado que no inventó JSON, sino que lo descubrió: simplemente estandarizó la sintaxis de literales de objetos que ya existía en JavaScript como formato de intercambio de datos.
A partir de 2006, JSON se extendió rápidamente de la mano del auge de Ajax (comunicación asíncrona). Su simplicidad frente a la verbosidad de XML conquistó a los desarrolladores. Aunque los primeros críticos decían que "JSON no puede reemplazar a XML", hoy es el formato de datos estándar de las REST APIs.
Como curiosidad, Crockford incluyó la cláusula "The Software shall be used for Good, not Evil." en el aviso de copyright de la especificación JSON. Esto causó un pequeño revuelo cuando los departamentos legales de grandes empresas como Google e IBM solicitaron una licencia formal porque no podían comprometerse a determinar qué es "bueno".