Como converter JSON em CSV para Excel e Google Sheets

Uma API te entrega uma parede de JSON, mas a pessoa que precisa dele vive no Excel. Colar JSON bruto em uma planilha resulta em uma única célula feia, cheia de colchetes e aspas. O que você quer é um CSV: linhas e colunas limpas que abrem direto no Excel ou no Google Sheets. Converter JSON em CSV é uma tarefa pequena e comum, e este guia mostra como fazer isso de forma limpa com a ferramenta gratuita JSON para CSV.

Por que achatar JSON em CSV

O JSON foi feito para código. O CSV foi feito para as pessoas que trabalham em planilhas. Na maioria das vezes você converte porque os dados precisam sair do mundo do desenvolvimento e chegar diante de alguém que filtra, ordena e cria gráficos em uma grade familiar. Os motivos típicos incluem:

• Criar um relatório que um gestor ou cliente vai abrir no Excel.
• Exportar registros de um app ou API para que um colega não técnico possa revisá-los.
• Importar em outra ferramenta que aceita uploads de CSV, mas não de JSON.
• Fazer análises rápidas com fórmulas de planilha em vez de escrever código.

Em resumo, o CSV é o aperto de mãos universal entre os seus dados e todos que não leem JSON para ganhar a vida.

Como um array de objetos vira uma tabela

O JSON mais limpo de converter é um array de objetos planos, porque ele se mapeia perfeitamente em uma tabela. Veja este exemplo:

• [{"name": "Ada", "role": "dev"}, {"name": "Linus", "role": "lead"}]

Cada chave (name, role) vira um cabeçalho de coluna. Cada objeto vira uma linha. O resultado é um CSV organizado de duas colunas, com uma linha de cabeçalho e duas linhas de dados. Um objeto na entrada, uma linha na saída, com as chaves servindo de rótulos. Esse é o formato com que as planilhas ficam mais à vontade, então busque por ele sempre que puder.

Tratando campos aninhados

O JSON real raramente é perfeitamente plano. Um registro pode conter um objeto de endereço ou uma lista de tags dentro dele. Uma célula de planilha, por outro lado, quer um único valor. Há duas formas sensatas de tratar isso:

1. Achatar com um caminho. Um campo aninhado como address.city vira a própria coluna chamada address.city, trazendo o valor interno para o nível superior, de modo que cada pedaço tenha a sua própria célula.
2. Transformar em texto. Um valor que não pode ser achatado de forma limpa, como um array, é escrito na célula como texto compacto para que nenhum dado se perca.

Saber qual das duas aconteceu te diz o que esperar. Se você vir uma coluna com um ponto no nome, isso é um campo aninhado achatado. Se você vir colchetes dentro de uma célula, aquele ramo foi mantido como texto. De qualquer forma, nada é descartado em silêncio.

Como converter JSON em CSV no seu navegador

A ferramenta gratuita JSON para CSV roda inteiramente no seu navegador, então os seus dados nunca são enviados. Isso importa quando o JSON contém registros de usuários, e-mails ou números internos que você não colaria em um site desconhecido.

1. Abra a ferramenta e cole o seu JSON, ou carregue um arquivo .json. Um array de objetos se converte da forma mais limpa.
2. Deixe que ela construa os cabeçalhos de coluna a partir das chaves que encontra nos seus registros.
3. Copie a saída CSV, ou faça o download, e depois abra no Excel ou no Google Sheets.

Como a conversão acontece na aba, as exportações sensíveis permanecem na sua própria máquina o tempo todo.

Deixe o JSON limpo primeiro

Uma conversão que falha geralmente é uma entrada malformada, não um problema da ferramenta. Antes de converter, vale a pena confirmar que o JSON é válido e bem estruturado. Cole-o primeiro no Formatador de JSON: ele indenta a estrutura, aponta uma vírgula faltando ou um colchete sem fechar, e permite confirmar que você está realmente trabalhando com um array de objetos, e não com um único bloco aninhado. Dois minutos ali te poupam de um CSV confuso depois.

Ferramentas relacionadas

A ida e volta funciona nos dois sentidos. Quando um colega edita o CSV no Excel e você precisa dele de volta como dados estruturados, a ferramenta CSV para JSON transforma aquelas linhas em objetos de novo. E se os seus dados chegaram originalmente como XML, a ferramenta XML para JSON os leva primeiro para JSON, prontos para serem achatados em uma planilha a partir daí.

A versão curta

JSON para CSV é sobre levar dados em forma de código para uma grade que qualquer um pode abrir. Um array de objetos planos se converte perfeitamente: as chaves viram colunas, os objetos viram linhas. Os campos aninhados são achatados em colunas com ponto ou mantidos como texto, então nada se perde. Valide o seu JSON primeiro no formatador e depois execute a ferramenta gratuita JSON para CSV direto no seu navegador para obter um arquivo limpo, privado e pronto para planilha em segundos.