JSON a CSV
JSON a CSV es una API que convierte un array de objetos JSON en un CSV, con las columnas sacadas de las claves de todos los objetos. Pone comillas solo donde hacen falta (si un valor lleva una coma o una comilla), no en todos los campos.
Cómo funciona
Le mandas data (un array de objetos) y te devuelve el texto CSV listo para descargar o guardar. Si algún objeto trae un campo que los demás no tienen, ese campo sale como columna y queda vacío donde falta.
Lo único que necesitas
- Tu API key. La creas en tu panel con "+ Crear llave".
- En tu plataforma de automatización, un paso de tipo "HTTP Request" (n8n, Make, Zapier, Pipedream…).
Cómo usarlo en n8n
- Method:
POST· URL:https://api.cofferdock.com/json-to-csv - Send Headers:
x-api-key= tu llave,Content-Type=application/json - Send Body (JSON):
{ "data": [{"nombre":"Ana","edad":30},{"nombre":"Luis","edad":25}] }
Opciones
| Opción | Por defecto | Para qué sirve |
|---|---|---|
data | - | Obligatorio. Array de objetos. Las columnas son todas las claves que aparezcan en cualquiera de ellos. |
header | true | Incluir la fila de nombres de columna. |
delimiter | , | Un solo carácter. |
escape_formulas | false | Ponlo en true si los textos de data vienen de terceros (formularios, correos, páginas web). Un texto que empieza por =, +, - o @ sale con una comilla simple delante y la hoja lo lee como texto, no como fórmula. Por MCP (asistentes de IA) viene en true de serie. Más abajo, el detalle. |
Resumen de la API
- Endpoint:
POST https://api.cofferdock.com/json-to-csv - Auth:
x-api-key: TU_LLAVE. - Entrada: SOLO JSON,
{ "data": [...] }. - Motor: csv-stringify, RFC 4180.
- Límites: 30 peticiones/min por IP. Hasta 100.000 filas y 1.000 columnas (y 5 millones de celdas, filas × columnas). 1 llamada = 1 crédito.
Ejemplo
curl -X POST "https://api.cofferdock.com/json-to-csv" \
-H "x-api-key: TU_LLAVE" -H "Content-Type: application/json" \
-d '{"data":[{"nombre":"Ana","edad":30}]}'
Respuesta
{ "success": true, "csv": "nombre,edad\nAna,30\n",
"meta": { "rows": 1, "used": 12, "remaining": 488 } }
Lo que recibes
csv, el texto listo. Con output=csv, el CSV directo como cuerpo de la respuesta (Content-Type: text/csv), sin envoltorio JSON.
Si los datos vienen de terceros
Si una celda de texto empieza por =, +, - o @, Excel y Google Sheets pueden leerla como una fórmula al abrir el CSV. Quien controle ese texto (quien rellena un formulario, quien manda un correo) podría hacer que la hoja de otra persona envíe sus datos a una web ajena. Se llama inyección de fórmulas.
Con "escape_formulas": true, cada texto que empieza por uno de esos signos, por un tabulador o por un retorno de carro lleva una comilla simple delante: =1+1 sale como '=1+1 y la hoja lo trata como texto. Lo mismo vale para los nombres de columna. Los números no se tocan: un -5 escrito sin comillas sigue siendo el número -5.
Por defecto está en false, para que el CSV salga exactamente como siempre. Cuando la herramienta se usa desde un asistente de IA por MCP, viene en true de serie (el asistente puede apagarla mandando false). Actívalo en cuanto mezcles textos que no controlas. La comilla pasa a formar parte del texto y se ve en la hoja: un teléfono que llega como texto +34 600 000 000 saldría como '+34 600 000 000. Si un dato debe seguir siendo un número, envíalo como número (sin comillas).
Límite: solo se protege el principio de cada texto. Si el programa que abre el archivo usa otro separador de lista que el archivo (por ejemplo Excel en español, que espera ;, con un CSV separado por comas), un texto con ;= en medio puede partirse en dos celdas y la segunda empezar por =. Usa el delimiter que espera quien lo abre, o genera un Excel con JSON a Excel.