Convertir una exportación JSON de contactos a CSV

Para convertir una exportación JSON de contactos a CSV, encuentra el arreglo que contiene los registros, escribe una fila por registro y aplana los campos anidados en columnas con ruta de puntos. El convertidor de JSON a CSV hace las tres cosas en tu navegador: elige el arreglo aunque esté envuelto bajo data o results, une las listas de etiquetas en una celda y da columnas numeradas a las listas de correos o teléfonos. Después, el CSV se abre en Excel o pasa a un importador.

Fuentes: RFC 8259 (el formato JSON) y jsonlines.org (JSON Lines), leídas el 3 de noviembre de 2026.

Paso 1: encuentra los registros

Un CSV es una tabla; una exportación JSON suele ser un envoltorio con la tabla adentro:

{ "results": [ { "email": "ana@example.com", "company": { "name": "Contoso" } } ],
  "paging": { "next": { "after": "100" } } }

Las filas están en results. Otras API usan data, items, contacts o members. El convertidor puntúa cada arreglo de objetos del documento y elige el más probable; si se equivoca, elige otra ruta de la lista que muestra.

Paso 2: decide cómo los campos anidados se vuelven columnas

JSON	Columnas del CSV
"company": {"name": "Contoso"}	company.name
"tags": ["vip", "trial"]	tags = vip; trial
"emails": [{"type": "work", "value": "..."}, ...]	emails.0.type, emails.0.value, emails.1.value...

Tú defines cuántas columnas numeradas recibe una lista de objetos; lo que pase de ahí queda como texto JSON en una columna emails.more, para que no se pierda nada. Las columnas aparecen en el orden en que se ven por primera vez, y un campo que solo tienen algunos registros queda vacío en los demás. Los números y los true/false se escriben tal como aparecen en el JSON.

Paso 3: maneja la paginación y JSON Lines

Una API devuelve una página a la vez, así que una exportación completa son varios archivos. Convierte cada uno y únelos con CSV merge, o pega los registros como JSON Lines, un objeto por línea, que el convertidor lee directamente.

Paso 4: prepara el CSV para su destino

1. Recorta las columnas. Las exportaciones de API traen IDs, marcas de tiempo y campos internos que un importador no necesita. Elimínalos, renómbralos y reordénalos con el editor de columnas de CSV.
2. Mantén los IDs intactos en Excel. Los IDs numéricos largos y los códigos postales se redondean o pierden ceros con un doble clic; consulta abrir un CSV en Excel sin perder los ceros a la izquierda.
3. Quita duplicados. Los contactos que vienen de varios endpoints o páginas pueden repetirse; elimina los correos duplicados.

Límites

Los registros anidados a más de seis niveles de profundidad no se buscan automáticamente; en ese caso elige la ruta tú. Todo el archivo queda en la memoria del navegador mientras se convierte, varias veces su tamaño, así que una exportación muy grande puede ser más fácil de convertir por partes. El convertidor no pasa de CSV a JSON. Y convierte datos; no revisa si las direcciones que contienen todavía reciben correo.

Dónde encaja SimpleVerifier

Si sacas contactos de una API para verificarlos, puedes saltarte el paso del CSV y enviarlos a nuestra API de verificación masiva; verificar un CSV en lote con la API muestra el flujo. Para algo puntual, sube el CSV en /verify y recibe los archivos de válidos, riesgosos e inválidos con tus columnas intactas. Las primeras 100 comprobaciones son gratis al iniciar sesión con Google. Pro cuesta $39 al mes: los primeros 100.000 correos de cada mes van a máxima velocidad y después las listas grandes avanzan más despacio, sin cortes. Las llamadas a la API se miden aparte según el plan; consulta los precios.