Como converter JSON para CSV
- Cole o JSON: uma lista de objetos, um objeto só, a resposta de uma API que contém uma lista (como
{"data": [ … ]}) ou JSON Lines, com um objeto por linha. A conversão acontece enquanto você cola. - Escolha o separador. Aqui o padrão já é o ponto e vírgula, que é o que o Excel em português do Brasil espera. Escolha vírgula para Google Planilhas, bancos de dados, Python ou qualquer sistema que siga o padrão internacional.
- Escolha como as listas são escritas: Texto JSON numa célula, Unidas com vírgulas ou em Colunas, uma por item.
- Confira a prévia e toque em Baixar para ter um arquivo .csv, ou em Copiar para colar o CSV em outro lugar.
Como a conversão funciona
CSV é uma tabela plana; JSON é uma árvore. Por isso o conversor achata cada registro:
- Onde estão as linhas. Uma lista no nível mais alto dá uma linha por item. Se o nível mais alto for um objeto, o conversor procura a primeira lista de objetos dentro dele, nível por nível, e a linha Linhas tiradas de mostra o caminho usado, como
$.data.items. Um objeto sem lista assim vira uma linha só. - Objetos aninhados viram colunas com nomes separados por ponto:
{"cliente": {"cidade": "Recife"}}gera a colunacliente.cidade, seja qual for a profundidade. - As colunas são a união de todas as chaves de todos os registros, na ordem em que aparecem pela primeira vez. Um registro sem uma chave ganha uma célula vazia, então registros com campos diferentes ficam alinhados.
- Valores: texto vai como está, números exatamente como escritos no JSON,
trueefalsecomo palavras enullcomo célula vazia. - Aspas seguem a RFC 4180: uma célula com o separador, uma aspa dupla ou uma quebra de linha vai entre aspas duplas, com as aspas internas dobradas. As linhas terminam em CRLF, como o padrão e o Excel esperam.
| Opção de listas | {"itens": ["café", "açaí"]} vira |
|---|---|
| Texto JSON | itens ⏎ "[""café"",""açaí""]" |
| Unidas | itens ⏎ café, açaí |
| Colunas | itens.0;itens.1 ⏎ café;açaí |
Exemplo com pedidos de uma loja
O exemplo da caixa é uma resposta de API com 2 pedidos dentro de pedidos. O conversor encontra a lista em $.pedidos e escreve 8 colunas, com ponto e vírgula:
id;cliente.nome;cliente.cidade;cliente.cep;total;pago;itens;obs 9007199254740993;Conceição Araújo;São João del-Rei;36300-000;1234.50;true;"[""café"",""pão de queijo""]"; 9007199254740994;André Gonçalves;Florianópolis;88010-000;89.9;false;"[""açaí""]";Deixar na portaria, por favor
Repare nos detalhes. O objeto do cliente virou cliente.nome, cliente.cidade e cliente.cep. O primeiro pedido não tem obs, então a última célula fica vazia. A observação do segundo pedido tem uma vírgula, mas com ponto e vírgula como separador ela não precisa de aspas; com vírgula, ela ficaria assim:
9007199254740994,André Gonçalves,Florianópolis,88010-000,89.9,false,"[""açaí""]","Deixar na portaria, por favor"
E os IDs, 9007199254740993 e 9007199254740994, saem exatos: os dois passam de 253, o limite em que o JSON.parse do JavaScript arredonda números — por isso muitos conversores transformam o primeiro em …992.
Abrindo o CSV no Excel em português
- Ponto e vírgula ou vírgula. Ao abrir um CSV com duplo clique, o Excel separa as colunas pelo “separador de lista” das configurações regionais do Windows. Em português do Brasil a vírgula é o separador decimal (R$ 1.234,50), então o separador de lista é o ponto e vírgula, e um arquivo separado por vírgulas cai inteiro na coluna A. Por isso esta página já começa em ponto e vírgula. Se for mandar o arquivo para um sistema, o Google Planilhas ou alguém no exterior, escolha vírgula — ou importe pelo Excel em Dados › De Texto/CSV, onde você escolhe o delimitador.
- Acentos. Sem uma pista, o Excel lê o CSV numa página de código antiga do Windows, e “Conceição” vira “Conceição”. O BOM do UTF-8 — três bytes invisíveis, EF BB BF, no começo do arquivo — avisa o Excel de que o arquivo é UTF-8. Deixe ligado para o Excel; desligue para programas que leriam essa marca como parte do nome da primeira coluna. O Google Planilhas lida bem com os dois.
- Decimais com ponto. Os números saem como no JSON, com ponto (
1234.50), porque o conversor não muda os dados. No Excel brasileiro, uma coluna assim pode não ser reconhecida como número. Na importação por Dados › De Texto/CSV, trate essa coluna com a localidade Inglês (Estados Unidos), ou troque o ponto pela vírgula no Excel depois. - CEP, CPF e números longos. O CSV guarda todos os dígitos, mas o Excel só mantém 15 dígitos significativos: mostra 9007199254740993 como 9,0072E+15 e guarda 9007199254740990. Ele também tira o zero à esquerda de CEPs como 01310-100 quando estão sem hífen e de CPFs que começam com 0. Importe essas colunas como Texto.
- Fórmulas. Uma célula que começa com =, +, - ou @ pode ser executada como fórmula numa planilha. Se o JSON veio de terceiros, confira essas células antes de abrir no Excel.
Limites e dicas
- Arquivos de alguns megabytes são convertidos em cerca de um segundo. Resultados com mais de 200 mil caracteres vão só para download, porque um bloco enorme de texto fica lento para mostrar e copiar.
- Um JSON inválido aparece com a linha e a coluna do erro. O formatador de JSON explica cada tipo de erro e como corrigir.
- Se a resposta tiver várias listas de registros, cole só a que você quer, ou coloque-a no topo.
- Para gerar IDs para uma planilha, use o gerador de UUID.
- Tudo roda no seu navegador: o JSON e o CSV não saem do seu aparelho e nada fica salvo — recarregar a página limpa a caixa.
Perguntas frequentes
Os meus dados são enviados?
Não. A conversão é feita por JavaScript no seu navegador e o arquivo é criado no seu aparelho, então serve para exportações privadas, listas de clientes e chaves de API dentro do JSON — e funciona até sem internet depois que a página carrega.
Por que o Excel coloca tudo numa coluna só?
Porque o seu Excel espera ponto e vírgula. Em português do Brasil a vírgula é o separador decimal, e o Excel usa o ponto e vírgula para separar colunas ao abrir um CSV. Escolha Ponto e vírgula como separador, ou abra o arquivo por Dados › De Texto/CSV e escolha a vírgula.
Por que os acentos aparecem errados no Excel?
O Excel adivinhou o conjunto de caracteres errado. Deixe o BOM UTF-8 ligado, baixe o arquivo de novo e abra o novo: a marca no começo diz ao Excel que o arquivo é UTF-8, e ç, ã e é aparecem certos.
Como objetos JSON aninhados são convertidos?
Eles são achatados em colunas com nomes separados por ponto: {"usuario": {"endereco": {"cidade": "Belém"}}} vira a coluna usuario.endereco.cidade. As listas seguem a opção escolhida: texto JSON numa célula, valores unidos ou uma coluna por item.
Dá para converter JSON Lines (NDJSON)?
Sim. Cole um valor JSON por linha, como em arquivos de log e exportações; cada linha vira uma linha da tabela, e as colunas são combinadas entre todas as linhas.
Última atualização: 16 de outubro de 2026