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

  1. Pegue su JSON Pegue un array de objetos en el campo de entrada. Copiar directamente una respuesta de API es perfectamente válido.
  2. 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.
  3. 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

No, la herramienta solo acepta un array de objetos JSON ([{}, {}]). Si tienes un objeto individual, envuélvelo en un array primero (p. ej. [{}]).

Los valores profundamente anidados no se aplanan — se muestran como una cadena JSON (p. ej. {"a":1} para un objeto). Aplana tu estructura JSON antes de convertir si necesitas esos valores en columnas separadas.

El CSV descargado está en UTF-8 con BOM, por lo que normalmente se abre bien con doble clic. Si aun así aparecen caracteres extraños, impórtelo en Excel con «Datos» → «Desde el texto/CSV» y seleccione 65001: Unicode (UTF-8) en «Origen del archivo».
Tool-kun

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.