Conversor de JSON para CSV Online: da API para a planilha em segundos
O conversor de JSON para CSV transforma um array de objetos JSON — como a resposta de uma API — em uma tabela CSV que abre direto no Excel, Google Sheets ou LibreOffice. E faz o caminho inverso: pega um CSV exportado de uma planilha e devolve um array JSON pronto para colar no seu código. Tudo roda no navegador; nenhum dado é enviado para servidores.
Como converter JSON para CSV (e CSV para JSON)
- Escolha o sentido: JSON → CSV ou CSV → JSON.
- Cole o conteúdo no campo de entrada.
- Escolha o separador do CSV: vírgula (padrão internacional) ou ponto e vírgula (Excel em português).
- Converta e copie — ou salve como
.csve abra na sua planilha.
O formato esperado
Para um CSV com cabeçalho, o JSON ideal é um array de objetos com as mesmas chaves:
[
{ "nome": "Ana", "cidade": "Recife" },
{ "nome": "João", "cidade": "Salvador" }
]
Isso gera:
nome,cidade
Ana,Recife
João,Salvador
Campos com vírgula, aspas ou quebra de linha são automaticamente colocados entre aspas duplas e as aspas internas viram duas aspas, seguindo o padrão RFC 4180 — o mesmo que o Excel e o Google Sheets esperam.
O que acontece com dados aninhados
Uma célula de planilha guarda um valor simples, não uma estrutura. Quando um campo do JSON é um objeto ou um array, a ferramenta o serializa como texto JSON dentro da coluna. Um objeto como { "id": 1, "tags": ["a","b"] } gera uma coluna tags com o conteúdo ["a","b"] escapado. Se você precisa de colunas separadas para endereco.cidade, achate (flatten) o JSON antes de converter.
Casos de uso comuns
- Abrir respostas de API no Excel: cole o JSON de um endpoint e gere uma planilha para análise, tabela dinâmica ou relatório.
- Importar dados em sistemas: a maioria dos ERPs, CRMs e plataformas de e-mail importa CSV, não JSON.
- Popular um banco: transforme um CSV recebido em array JSON para um
INSERTem lote ou um seed. - Fixtures e mocks de teste: converta uma planilha de exemplo em JSON para alimentar testes automatizados.
- Revisar dados com quem não programa: um CSV abre em qualquer lugar; um arquivo
.jsoncostuma assustar.
Vírgula ou ponto e vírgula
O "C" de CSV é de comma, mas o Excel em português usa ponto e vírgula como separador de colunas, porque a vírgula já é o separador decimal (4,50). Regra prática: vai abrir no Excel PT-BR, use ;; vai consumir em código, no Google Sheets ou num sistema internacional, use ,. Se um CSV "abre tudo numa coluna só", o separador do arquivo não bate com o que a planilha espera — reconverta com o outro separador.
Erros comuns
| Sintoma | Causa provável |
|---|---|
| "JSON inválido" | vírgula sobrando antes de ] ou }, ou aspas simples |
| CSV numa coluna só | separador errado para a sua planilha |
| Acentos quebrados no Excel | arquivo não está salvo em UTF-8 |
| Coluna faltando em algumas linhas | objetos com chaves diferentes — células vazias são esperadas |
Dicas
- Antes de converter, rode o JSON pelo Formatador de JSON para ver a estrutura e pelo Validador de JSON para achar o erro de sintaxe.
- De CSV para JSON, todos os campos saem como string — o CSV não guarda tipo. Converta números e booleanos depois, no código.
- Precisa de outro formato de configuração? Veja o Conversor JSON ↔ YAML e JSON vs YAML: quando usar cada um.
- Guia completo com exemplos e linha de comando: Como converter JSON para CSV.