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

  1. Cole o seu JSON Cole um array de objetos no campo de entrada. Copiar direto uma resposta de API é perfeitamente válido.
  2. 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.
  3. 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

Não, a ferramenta aceita apenas um array de objetos JSON ([{}, {}]). Se você tiver um objeto individual, coloque-o dentro de um array primeiro (ex.: [{}]).

Valores profundamente aninhados não são achatados — são exibidos como uma string JSON (ex.: {"a":1} para um objeto). Achate sua estrutura JSON antes de converter se precisar desses valores em colunas separadas.

O CSV baixado está em UTF-8 com BOM, então normalmente abre corretamente com um clique duplo. Se ainda assim aparecerem caracteres estranhos, importe-o no Excel por «Dados» → «De Texto/CSV» e selecione 65001: Unicode (UTF-8) em «Origem do Arquivo».
Tool-kun

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.