Converter JSON para CSV

Transforme uma resposta de API ou uma exportação NDJSON em uma tabela de planilha, com cada campo de cada registro na sua própria coluna.

Solte seus arquivos aqui

.json, .ndjson, .txt · até 300 MB

Escolher arquivos

Caminho até o array

Mais configurações

DelimitadorCodificação de saídaQuebras de linhaObjetos aninhadosProfundidade máximaArrays dentro de um registroSeparador de arrayIncluir linha de cabeçalhoAspas

Como Converter para CSV

1
Solte seu arquivo JSON
Arraste um arquivo .json ou .ndjson para a página. Aceita um array simples, um único objeto ou um registro por linha.
2
Indique o array e escolha o delimitador
Se os registros estiverem dentro de outro objeto, digite o caminho até eles, como data.items. Depois escolha o separador que a sua planilha espera.
3
Converta e baixe o CSV
Clique no botão e salve a tabela, pronta para abrir no Excel, no Numbers ou no Google Sheets.

O cabeçalho é montado com todos os registros

Um conversor que lê as chaves só do primeiro registro perde, sem avisar, um campo que aparece pela primeira vez no registro novecentos, e ninguém percebe até uma coluna surgir vazia semanas depois. Aqui, o arquivo inteiro é percorrido primeiro. A união de todas as chaves vira o cabeçalho, na ordem em que cada uma aparece pela primeira vez, e só então as linhas são escritas.

Objetos aninhados viram colunas com ponto no nome

Um CSV não tem onde guardar uma estrutura, então um objeto dentro de um registro é desdobrado em colunas com nomes como user.address.city. O que passa do limite de profundidade é gravado como uma string JSON compacta, em vez de ser descartado. Os arrays podem ser unidos em uma só célula, distribuídos em colunas numeradas ou mantidos como texto JSON.

Um arquivo que o Excel abre sem assistente de importação

A saída padrão é UTF-8 com marca de ordem de bytes (BOM) e quebras de linha CRLF, e é isso que faz o Excel mostrar acentos e texto em cirílico corretamente com um clique duplo. Windows-1251 está disponível para ferramentas mais antigas; os caracteres que essa codificação não consegue representar viram pontos de interrogação, e você fica sabendo quantos foram.

Seus dados ficam na aba

A análise do JSON, a montagem do cabeçalho, o achatamento dos registros e a codificação do CSV rodam localmente no seu navegador. Nada é enviado, nada entra na fila de uma máquina que você não controla, e não é preciso criar conta. Uma exportação cheia de dados de clientes ou de chaves de API não vai a lugar nenhum.

Perguntas frequentes

O que acontece com os objetos aninhados dos meus registros?

Eles são achatados em colunas com ponto no nome: uma cidade guardada em user.address vira uma coluna chamada user.address.city. Um limite de profundidade impede que isso exploda em dados muito aninhados. O que fica abaixo dele é gravado em uma só célula como texto JSON, então a informação continua lá, mesmo que a estrutura não.

Meus registros estão dentro de outro objeto. Como chego até eles?

Use o campo de caminho no topo. Escreva a sequência de chaves separadas por pontos, por exemplo data.items ou result.0.rows, e o conversor começa dali. Se o caminho não levar a nada, o erro lista as chaves de primeiro nível que existem de fato no arquivo, para você corrigir.

Por que o Excel coloca a linha inteira em uma só coluna?

O Excel separa as colunas pelo separador definido nas configurações regionais do sistema, que em boa parte da Europa, e também no Brasil, é o ponto e vírgula, e não a vírgula. Converta de novo com o ponto e vírgula como delimitador, e as colunas se alinham. O Google Sheets detecta o separador na importação, então não é afetado em nenhum dos casos.

Para que serve o BOM no início do arquivo?

Esses três bytes avisam ao Excel que o arquivo está em UTF-8 antes que ele comece a adivinhar. Sem eles, o Excel muitas vezes supõe uma página de código antiga e mostra acentos ou texto em cirílico como caracteres ilegíveis. Se o sistema de destino não aceitar essa marca, basta mudar uma configuração para gerar UTF-8 sem BOM.

O que acontece com os arrays dentro de um registro?

Por padrão, eles são unidos em uma só célula com o separador que você escolher, o que funciona bem para listas curtas de tags. Também dá para distribuí-los em colunas numeradas, como tags.0 até tags.4, com limite de cinquenta e um aviso, ou gravá-los como uma string JSON quando o conteúdo importa mais que a disposição.

Aceita NDJSON como entrada?

Sim. Se o arquivo não puder ser lido como um único documento JSON, cada linha não vazia é lida como um registro próprio. Isso cobre exportações NDJSON e JSON Lines sem precisar mudar nenhuma configuração.

Por que aparece um apóstrofo antes de um valor que começa com sinal de igual?

O Excel trata uma célula que começa com =, + ou @ como fórmula, e um valor forjado em uma exportação não confiável pode virar um comando quando alguém abre o arquivo. Um apóstrofo no início desativa isso. Números negativos comuns, como -5 ou -12,5, ficam exatamente como estão.

Meu JSON é enviado para algum lugar?

Não. A leitura, o achatamento e a codificação são feitos por JavaScript que roda dentro desta página. Não há requisição a servidor, armazenamento nem registro do seu conteúdo em momento algum.