Como converter JSON em CSV (e abrir o resultado no Excel)
Transforme uma exportação de API ou um arquivo JSON em planilha. Veja como objetos e arrays são achatados, o que vira das chaves ausentes e como abrir o CSV no Excel.
Atualizado em 4 de novembro de 20268 min de leitura
Para converter JSON em CSV, cole o JSON (ou solte um arquivo .json) no conversor, clique em Converter para CSV e depois baixe o arquivo ou copie o texto. A ferramenta transforma cada objeto do seu array em uma linha, monta o cabeçalho com todas as chaves que encontra e junta objetos aninhados em nomes de coluna separados por pontos, como user.name. O Excel abre o CSV diretamente, e por isso esse é o caminho comum de "JSON para Excel". O que costuma surpreender é o que acontece com arrays, chaves ausentes e a ordem das colunas; por isso este guia explica exatamente o que a ferramenta faz.
Que forma de JSON funciona
O conversor espera o que a maioria das APIs e exportações devolve: um array de objetos, por exemplo uma lista de pedidos ou de usuários. Cada objeto vira uma linha. Um único objeto também funciona e vira uma tabela de uma linha. Se o array tiver valores simples em vez de objetos (números ou textos), cada um vira uma linha em uma única coluna chamada value. Um array vazio não gera nenhuma saída.
Se a sua resposta envolve a lista em outro objeto, por exemplo {"data": [ ... ]}, o conversor trata tudo como uma única linha com uma coluna que contém a lista como texto. Copie apenas o array interno e cole-o no lugar. Se o JSON não for válido, aparece a mensagem "JSON inválido. Verifique colchetes, vírgulas e aspas." Passe o texto antes pelo formatador de JSON para achar o ponto com erro; o guia sobre formatar JSON online mostra como são os erros mais comuns.
Convertendo JSON em CSV, passo a passo
Abra o conversor
Acesse o conversor de JSON para CSV. Tudo roda no seu dispositivo, não nos nossos servidores, então uma exportação com dados de clientes não é enviada a lugar nenhum.
Cole o JSON ou solte o arquivo
Cole na caixa Entrada JSON ou solte um arquivo .json sobre ela. Com um arquivo, deixe Codificação (arquivo) em UTF-8, a menos que saiba que ele foi salvo em uma página de código do Windows.
Clique em Converter para CSV
O CSV aparece na caixa de saída logo abaixo. Olhe primeiro a linha de cabeçalho: é nela que se vê como os seus campos aninhados foram nomeados.
Baixe ou copie
Baixar CSV salva um arquivo chamado data.csv. Copiar CSV coloca o texto na área de transferência para colar em uma planilha ou em outra ferramenta.
Cole ou solte o JSON, achate em colunas e baixe o CSV. Grátis: um arquivo por vez com delimitador vírgula e nenhum limite de linhas definido por nós, então o teto é a memória do seu dispositivo. Pro: escolher ponto e vírgula, tabulação ou barra vertical. Roda no seu dispositivo.
Converter JSON em CSVComo os dados aninhados são achatados
Um CSV é uma grade plana e o JSON é uma árvore, então algo precisa ceder. A ferramenta segue duas regras simples. Objetos aninhados são percorridos até o fim, e cada caminho vira um nome de coluna unido por pontos. Arrays não são expandidos: o array inteiro é escrito na célula como texto JSON.
| No JSON | Coluna no CSV | Valor da célula |
|---|---|---|
| "name": "Ada" | name | Ada |
| "address": { "city": "Pune" } | address.city | Pune |
| "a": { "b": { "c": 1 } } | a.b.c | 1 |
| "tags": ["x", "y"] | tags | ["x","y"] (como texto, entre aspas) |
| "items": [{ "id": 1 }] | items | [{"id":1}] (como texto, entre aspas) |
| "note": null | note | (vazia) |
| "paid": true | paid | true |
| "meta": {} | (sem coluna) | Um objeto vazio não acrescenta nada |
A consequência, sem rodeios: um registro com cinco itens de pedido em um array não vira cinco linhas. Continua sendo uma linha, com os itens em uma célula como texto. Se você precisa de uma linha por item, extraia esse array interno e converta-o separadamente, mantendo um ID de pedido em cada item para poder cruzar os dados depois. A ferramenta não tem opção para manter o aninhamento nem para desdobrar arrays, e não usa outro separador além do ponto nos caminhos.
Chaves ausentes, ordem das colunas e células vazias
Exportações reais são irregulares: um cliente tem telefone, o seguinte não. O conversor lê todos os registros primeiro e reúne a união de todos os nomes de coluna que vê. Um registro sem uma chave recebe uma célula vazia nessa coluna, de modo que todas as linhas têm o mesmo número de células e nada desliza para o lado. Um valor null também vira célula vazia, o que significa que o CSV não distingue "ausente" de "null".
As colunas são ordenadas alfabeticamente, não na ordem do seu JSON. A ordenação é por código de caractere, então letras maiúsculas vêm antes das minúsculas e números antes das letras. O campo id não será necessariamente o primeiro; normalmente você vai mover colunas na planilha depois. Números e true/false são escritos como texto simples, e um número JSON como 12.50 é escrito como 12.5.
| Registro | id | name | phone |
|---|---|---|---|
| { "id": 1, "name": "A", "phone": "555-0100" } | 1 | A | 555-0100 |
| { "id": 2, "name": "B" } | 2 | B | (vazia) |
| { "id": 3, "name": "C", "phone": null } | 3 | C | (vazia) |
Delimitador, aspas e codificação
A saída gratuita sempre usa vírgula. Escolher outro delimitador (ponto e vírgula, tabulação ou barra vertical) é uma opção Pro do menu Delimitador. Seja qual for o delimitador, todo valor que contenha esse delimitador, aspas duplas ou quebra de linha é envolvido em aspas duplas, e as aspas internas são duplicadas. É a forma padrão, então endereços como "12 Main St, Apt 4" ficam em uma única célula.
| Opção | Onde se aplica | Observações |
|---|---|---|
| Vírgula | Padrão, todos os planos | O CSV mais amplamente aceito |
| Ponto e vírgula | Pro | O que o Excel espera em muitas configurações regionais, como a do Brasil |
| Tabulação | Pro | Valores separados por tabulação (TSV) |
| Barra vertical | Pro | Alguns fluxos de dados |
| UTF-8 / Windows-1252 / ISO-8859-1 | Ao ler um arquivo enviado | Só muda como o arquivo .json é lido, não o CSV que você baixa |
O menu Codificação (arquivo) é fácil de entender errado. Ele controla como um arquivo JSON enviado é decodificado. O JSON quase sempre é UTF-8, então deixe como está, a menos que nomes com acento apareçam como símbolos estranhos depois de carregar o arquivo. O CSV baixado é escrito como texto UTF-8 simples, e a ferramenta não adiciona marca de ordem de bytes. Se você colar o JSON em vez de enviar o arquivo, o menu de codificação não tem efeito.
Abrindo o CSV no Excel
Dar dois cliques em um CSV UTF-8 sem marca de ordem de bytes pode fazer o Excel supor uma codificação antiga, e letras acentuadas e texto não latino viram caracteres estranhos. Em vez do clique duplo, abra uma pasta de trabalho em branco e use Dados, depois De Texto/CSV, e escolha UTF-8 como origem do arquivo. A janela de visualização também permite definir o delimitador, o que resolve o outro problema comum: em regiões em que o Excel espera ponto e vírgula, um arquivo separado por vírgulas cai todo em uma única coluna. Escolha Vírgula nessa janela e ele se divide corretamente. O passo a passo completo está em abrir um CSV no Excel corretamente.
Duas outras coisas acontecem do lado do Excel e não são causadas pelo conversor. Números longos, como identificadores de cartão ou de rastreamento com 16 dígitos, aparecem em notação científica, e valores com zeros à esquerda, como 00123, perdem os zeros. Defina essas colunas como Texto na visualização de importação antes de carregar. Se preferir pular a caixa de importação, passe o CSV pelo CSV para Excel para obter uma pasta de trabalho, ou use o visualizador de CSV só para olhar o conteúdo.
Limites e o que saber antes de uma exportação grande
- Um arquivo por vez. O conversor aceita um único arquivo JSON por execução.
- Sem limite de linhas e sem marca d'água. Como tudo roda no seu dispositivo, o limite real é a memória que ele tem. Um arquivo muito grande pode deixar a página lenta; divida-o antes, se for o caso.
- Tudo é texto. O CSV não tem tipos. Datas continuam sendo as strings que eram no JSON, e números são apenas dígitos.
- Fórmulas não são neutralizadas. Um valor que começa com = + - ou @ é copiado como está, e uma planilha pode tratá-lo como fórmula. Verifique exportações de fontes não confiáveis antes de abri-las.
- Pontos nas chaves podem colidir. Uma chave que se chame literalmente "a.b" e um objeto a aninhado com b dentro cairiam na mesma coluna.
- Voltar é outro passo: CSV para JSON reconstrói JSON a partir de uma tabela, mas não consegue restaurar exatamente o aninhamento original.
Se você tem dúvida se o CSV é mesmo o formato certo para os seus dados, JSON, CSV ou XML compara o que cada formato mantém e perde.
Perguntas frequentes
Como converter JSON em CSV de graça?
Abra o conversor de JSON para CSV, cole o JSON ou solte um arquivo .json, clique em Converter para CSV e use Baixar CSV ou Copiar CSV. O plano grátis dá um arquivo por vez com delimitador vírgula, e não há limite de linhas definido por nós.
Como converter JSON para Excel?
Converta primeiro para CSV, depois abra o Excel e use Dados, De Texto/CSV, escolhendo UTF-8 e o delimitador vírgula na visualização. Você também pode passar o CSV pelo CSV para Excel para obter uma pasta de trabalho .xlsx.
O que acontece com objetos e arrays aninhados?
Objetos aninhados viram colunas separadas, com nomes unidos por pontos, como address.city. Arrays não são divididos em linhas; o array inteiro é escrito em uma célula como texto JSON.
Por que algumas células do meu CSV estão vazias?
A ferramenta reúne todas as chaves de todos os registros. Um registro que não tem uma chave, ou a tem como null, recebe uma célula vazia nessa coluna para que todas as linhas fiquem alinhadas.
Por que as letras acentuadas aparecem erradas quando abro o CSV no Excel?
O Excel pode supor a codificação errada ao abrir um arquivo UTF-8 com clique duplo. Importe-o por Dados, De Texto/CSV e selecione UTF-8 como origem do arquivo. O conversor escreve UTF-8 simples e não adiciona marca de ordem de bytes.
Posso usar ponto e vírgula ou tabulação em vez de vírgula?
Sim, com o Pro: o menu Delimitador oferece vírgula, ponto e vírgula, tabulação e barra vertical. No plano grátis a saída usa vírgula, e a visualização de importação do Excel permite escolhê-la como separador.