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á codificado em UTF-8. Se aparecerem caracteres estranhos no Excel, abra-o como UTF-8 com BOM.
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 curiosidade, Crockford incluiu a cláusula "The Software shall be used for Good, not Evil." no aviso de copyright da especificação do JSON. Isso causou um pequeno alvoroço quando os departamentos jurídicos de grandes empresas como Google e IBM solicitaram uma licença formal porque não conseguiam se comprometer a determinar o que é "bom".