Converter JSON para CSV
Converte um array de objetos JSON para formato CSV.
O que faz converter JSON para CSV?
O JSON devolvido por uma API é um formato pensado para máquinas, então uma planilha não consegue abri-lo como está. Esta ferramenta lê um array de objetos JSON e o converte para CSV, com as chaves como linha de cabeçalho e cada elemento como uma linha. O resultado se presta a somar e ordenar no Excel ou no Planilhas Google.
Há dois pressupostos. O primeiro: a entrada precisa ser um array de objetos; envolva um objeto isolado num array antes de informá-lo. O segundo diz respeito ao aninhamento profundo: quando um valor é ele mesmo um objeto ou um array, ele não é expandido em colunas, mas colocado na célula como string JSON. Achatar antes deixa o resultado mais fácil de manejar.
Passos para converter JSON em CSV
- Cole o seu JSON Cole um array de objetos no campo de entrada. Copiar direto uma resposta de API é perfeitamente válido.
- Confira o resultado da conversão As chaves passam a ser a linha de cabeçalho e cada elemento vira uma linha. Confirme que estão presentes as colunas que você esperava.
- Baixe o CSV A codificação é UTF-8. Se o texto aparecer ilegível no Excel, indique UTF-8 durante a importação.
Dicas para aproveitar melhor
- A entrada deve ser um array de objetos JSON (
[{}, {}, ...]). Objetos individuais não são suportados. - Muito útil para trabalhar com dados de resposta de uma REST API no Excel ou Google Sheets.
- Valores em objetos ou arrays profundamente aninhados não são achatados — são exibidos como uma string JSON (ex.:
{"a":1}). - O CSV baixado está em UTF-8 com BOM, então não aparecem caracteres estranhos mesmo ao abri-lo com um clique duplo no Excel.
Quando converter JSON para CSV é útil
Processar uma resposta de API
Converta para CSV os dados obtidos e você poderá processá-los diretamente com funções da planilha ou com uma tabela dinâmica.
Compartilhar com quem não é desenvolvedor
Entregue os dados em forma de tabela a quem não sabe ler JSON bruto. Pedir uma revisão ou uma correção fica muito mais simples.
Usar o CSV como formato intermediário numa migração
Prático para converter dados a caminho de uma ferramenta que aceita importação CSV — e muitíssimos serviços aceitam.
Conferir o número de registros e as lacunas
Numa tabela, o número de linhas e as células vazias aparecem num relance, o que serve para verificar se você tem os registros previstos.
Termos de JSON e CSV
- Array de objetos
- Uma estrutura que alinha vários objetos na forma
[{...}, {...}]. Como cada um corresponde a uma linha de tabela, ela pode ser convertida para CSV. - Chave
- O nome que aponta para um valor dentro de um objeto. No CSV, ele passa a ser um nome de coluna na linha de cabeçalho.
- Aninhamento
- Uma estrutura em que um valor contém por sua vez outro objeto ou array. É justamente a parte que não cabe bem numa tabela.
- Achatamento
- Expandir as estruturas aninhadas num único nível. Feito antes, permite tratá-las como colunas CSV.
- BOM
- Uma marca de ordem de bytes colocada no início do arquivo para sinalizar a codificação. É usada quando você quer que o Excel abra corretamente um CSV em UTF-8.
Perguntas frequentes
[{}, {}]). Se você tiver um objeto individual, coloque-o dentro de um array primeiro (ex.: [{}]).{"a":1} para um objeto). Achate sua estrutura JSON antes de converter se precisar desses valores em colunas separadas.
Curiosidade — A origem do JSON: "descoberto", não inventado
O JSON (JavaScript Object Notation) foi formalizado por Douglas Crockford por volta de 2001. Ele afirmou que não inventou o JSON — ele o descobriu: apenas padronizou a sintaxe de literais de objetos que já existia no JavaScript como formato de troca de dados.
A partir de 2006, o JSON se popularizou rapidamente junto com o crescimento do Ajax (comunicação assíncrona). Sua simplicidade em relação à verbosidade do XML conquistou os desenvolvedores. Embora críticos iniciais dissessem que "o JSON não pode substituir o XML", hoje é o formato de dados padrão das REST APIs.
Como pequena curiosidade, Crockford acompanhava parte do seu próprio software, como o JSMin, de uma licença baseada na MIT à qual acrescentou uma frase: "The Software shall be used for Good, not Evil." (o software deve ser usado para o bem, não para o mal). A especificação do JSON em si (RFC 8259, ECMA-404) não contém essa cláusula. Como uma condição que restringe o uso não se encaixa na definição de código aberto, o Google não permitiu a publicação do JSMin no Google Code, e a versão derivada JSMin-PHP teve de se mudar para outro lugar. Aliás, em 2022 Crockford mudou a licença da sua implementação de JSON em Java para o domínio público.