GarToolsPremium Tools

Conversor CSV a JSON

Convierte datos CSV a formato JSON estructurado.

Por Ferran Garola BonillaDesarrollador especializado en formatos de datosActualizado: RFC 4180 (CSV) + ECMA-404 (JSON)
Procesamiento local Resultado instantáneo 100% gratuito

¿Cómo convertir CSV a JSON?

Pega tu contenido CSV en el editor (o copia datos directamente desde una hoja de cálculo), selecciona el separador correcto y haz clic en «Convertir a JSON». La herramienta usa la primera fila como nombres de campo y genera un array de objetos JSON listo para usar en tu proyecto. El resultado se puede copiar al portapapeles o descargar como archivo .json con un solo clic.

¿Qué es el formato CSV y cuáles son sus limitaciones?

CSV (Comma-Separated Values) es uno de los formatos de intercambio de datos más antiguos y universales. Consiste en texto plano donde cada línea representa una fila y los valores se separan por un delimitador (coma, punto y coma o tabulación). Su simplicidad es su mayor ventaja, pero también su limitación: CSV es completamente plano, no soporta tipos de datos (todo es texto), no permite anidar información y carece de un esquema formal. Esto significa que no puedes representar relaciones jerárquicas como un usuario con múltiples direcciones en una sola fila CSV sin recurrir a trucos como concatenar valores o duplicar filas.

¿Cuándo necesitas convertir CSV a JSON?

La conversión de CSV a JSON es necesaria en numerosos escenarios del desarrollo moderno. Cuando importas datos desde hojas de cálculo a aplicaciones web, las APIs REST esperan recibir JSON, no CSV. Si estás migrando datos entre sistemas, JSON ofrece mayor flexibilidad para representar estructuras complejas. También es imprescindible cuando alimentas bases de datos NoSQL como MongoDB o Firestore, que trabajan nativamente con documentos JSON. Otros casos frecuentes incluyen la preparación de datos para visualizaciones interactivas con librerías como D3.js o Chart.js, y la creación de archivos de configuración para aplicaciones.

Diferencias entre CSV plano y JSON anidado

CSV organiza los datos en una estructura tabular bidimensional: filas y columnas. JSON, en cambio, permite crear estructuras jerárquicas con objetos dentro de objetos y arrays de valores. Al convertir CSV a JSON, cada fila se transforma en un objeto cuyas claves son los encabezados de las columnas. El resultado es un array de objetos planos. Si necesitas anidar propiedades (por ejemplo, agrupar «calle», «ciudad» y «código postal» dentro de un objeto «dirección»), deberás transformar el JSON resultante manualmente o usar una convención de nombres como «dirección.calle» en los encabezados CSV.

Encabezados, codificación y caracteres especiales

Para que la conversión funcione correctamente, asegúrate de que la primera fila de tu CSV contenga encabezados descriptivos y únicos. Evita caracteres especiales en los nombres de columna como puntos, corchetes o espacios al inicio, ya que se convertirán en claves JSON tal cual. En cuanto a la codificación, la herramienta trabaja con UTF-8, que es el estándar para la web. Si tu CSV fue exportado desde Excel en Windows, es posible que use la codificación Latin-1 (ISO-8859-1), lo que puede causar problemas con tildes y eñes. En ese caso, abre el archivo en un editor de texto y guárdalo como UTF-8 antes de pegarlo. Los campos que contienen el carácter delimitador, comillas dobles o saltos de línea deben estar encerrados entre comillas dobles según el estándar RFC 4180.

Casos de uso prácticos

APIs y microservicios: convierte exportaciones CSV de tu base de datos en JSON para alimentar endpoints REST o GraphQL. Migración de datos: transforma datos tabulares de sistemas legacy en documentos JSON para importar en MongoDB, CouchDB o Elasticsearch. Prototipado rápido: usa un CSV como fuente de datos mock para tu aplicación frontend sin necesidad de montar un backend. Integración con herramientas: muchas plataformas de automatización como Zapier, Make o n8n trabajan con JSON internamente, por lo que convertir tus datos CSV facilita la integración.

Preguntas frecuentes

Soporta coma (,), punto y coma (;) y tabulación. La herramienta detecta automáticamente el separador más probable al analizar tu CSV, pero puedes cambiarlo manualmente si la detección no es correcta. El punto y coma es habitual en archivos CSV generados en regiones donde la coma se usa como separador decimal (como España y Latinoamérica).

La primera línea debe contener los nombres de las columnas (encabezados), que se usarán como claves en los objetos JSON resultantes. Cada línea posterior representa un registro. Los valores que contengan comas, comillas dobles o saltos de línea deben estar encerrados entre comillas dobles, siguiendo el estándar RFC 4180. Si un encabezado está vacío, se generará una clave genérica.

Sí. El parser respeta las comillas dobles según el estándar CSV (RFC 4180). Los campos que contienen comas, comillas dobles o saltos de línea dentro del valor se procesan correctamente siempre que estén encerrados entre comillas dobles. Las comillas literales dentro de un campo se escapan duplicándolas ("").

Sí. Copia las celdas en Excel o Google Sheets, pégalas en el editor y selecciona «Tabulación» como separador. Los datos copiados desde hojas de cálculo usan tabulaciones como delimitador por defecto. Este flujo es muy práctico para convertir rápidamente una tabla a JSON sin necesidad de exportar primero a un archivo .csv.

CSV es un formato plano y tabular: cada fila tiene el mismo número de columnas y no permite anidar datos. JSON, en cambio, es un formato jerárquico que soporta objetos anidados, arrays y tipos de datos como números, booleanos y null. CSV es ideal para hojas de cálculo y exportaciones masivas, mientras que JSON es el estándar para APIs web, bases de datos NoSQL y configuraciones de aplicaciones.

Sí. El parser CSV se ejecuta íntegramente en tu navegador con JavaScript: ni el archivo ni su contenido viajan a ningún servidor. Esto es relevante porque convertir CSVs con datos personales (clientes, empleados, leads) en un servicio online tradicional sería técnicamente una transferencia de datos a un encargado de tratamiento, con todas las implicaciones de GDPR/RGPD que eso conlleva. Al ocurrir todo en local, la herramienta queda fuera del ámbito del Reglamento europeo. Para entender qué es JSON y por qué es el formato moderno por defecto en APIs, lee la guía sobre JSON paso a paso.

Herramientas relacionadas

Lecturas relacionadas