JSON para CSV
Conversor

Como converter JSON em CSV

1. Clique em “Escolher arquivos” ou arraste arquivos .json para a página.
2. Cada arquivo é convertido assim que é adicionado, usando vírgulas e campos aninhados achatados.
3. Mude o “Separador” ou desative “Achatar campos aninhados” no painel de configurações à direita e clique em “Aplicar a todos os arquivos”.
4. Salve o CSV ou use “Baixar tudo (.zip)” para vários arquivos.

Qual parte do JSON vira linhas

Se o arquivo é uma lista, cada item vira uma linha. A maioria das respostas de API coloca a lista dentro de um objeto, por exemplo com uma chave data ou results ao lado de alguns metadados. Nesse caso, a ferramenta percorre o objeto nível por nível e usa a primeira lista de objetos que encontrar. Um objeto único, sem nenhuma lista dentro, vira uma única linha.

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 determinado campo fica com a célula vazia ali. Null vira uma célula vazia, e os valores booleanos são escritos como true e false.

Uma lista cujos itens são, eles mesmos, listas recebe colunas chamadas 1, 2, 3 e assim por diante. Uma lista de valores simples, como números ou textos, recebe uma única coluna chamada value.

O que as configurações fazem

Listas dentro de um registro são sempre mantidas como texto JSON em uma única célula, por exemplo ["red","blue"]. Dividi-las exigiria uma linha por item, o que mudaria o significado de cada linha.

• Separador. Vírgula (o padrão), Ponto e vírgula ou Tabulação. Use ponto e vírgula se o seu Excel usa a vírgula como separador decimal, e tabulação para arquivos TSV ou para colar em uma planilha.
• Achatar campos aninhados. Ativado por padrão. Um objeto aninhado como address, com um city dentro, vira uma coluna chamada address.city, e níveis mais profundos acrescentam mais pontos, como em address.geo.lat. Desative para manter cada objeto aninhado como texto JSON em uma única célula.

Como abrir o CSV no Excel

O CSV está em UTF-8 e começa com uma marca de ordem de bytes (BOM), então o Excel mostra letras acentuadas e alfabetos não latinos corretamente quando você dá dois cliques no arquivo. Campos que contêm o separador, aspas ou quebras de linha vão entre aspas.

Mesmo assim, o Excel pode reformatar alguns valores ao abrir: números de identificação longos podem virar notação científica e valores como 0042 perdem os zeros. Para evitar isso, importe com Dados › De Texto/CSV e defina essas colunas como Texto.

Problemas comuns e soluções

• “Este JSON não é válido perto da linha 12.” O arquivo tem um erro de sintaxe, geralmente uma vírgula sobrando no final, uma aspa faltando ou um colchete faltando. A linha e a coluna indicam onde olhar.
• O arquivo é JSON Lines (um objeto por linha). Isso não é um único documento JSON, então não é lido. Coloque as linhas entre colchetes e acrescente uma vírgula no fim de cada linha, menos na última.
• A lista errada virou as linhas. A ferramenta escolheu a primeira lista de objetos que encontrou. Edite o arquivo para que a lista que você quer venha primeiro, ou salve só essa lista em um arquivo separado.
• Colunas demais. Dados muito aninhados se achatam em muitas colunas com pontos. Desative “Achatar campos aninhados” ou exclua as colunas desnecessárias depois de abrir o arquivo.

Privacidade

Exportações de API costumam conter nomes de clientes, e-mails e IDs. Aqui o arquivo é lido e convertido inteiramente por JavaScript na aba do seu navegador, e nada é enviado a um servidor. Para fazer o caminho inverso, use o CSV para JSON.