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á en UTF-8 con BOM, así que no aparecen caracteres extraños aunque lo abra con doble clic en Excel.
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 pequeña curiosidad, Crockford acompañaba parte de su propio software, como JSMin, de una licencia basada en la MIT a la que añadió una frase: "The Software shall be used for Good, not Evil." (el software se usará para el bien, no para el mal). La especificación de JSON en sí (RFC 8259, ECMA-404) no contiene esta cláusula. Como una condición que restringe el uso no encaja con la definición de código abierto, Google no permitió publicar JSMin en Google Code, y la versión derivada JSMin-PHP tuvo que trasladarse a otro sitio. Por cierto, en 2022 Crockford cambió la licencia de su implementación de JSON en Java a dominio público.