Converter JSON para CSV
Este conversor gratuito transforma JSON ou JSON Lines em uma tabela CSV para Excel ou Google Planilhas: encontra a lista de registros e achata os campos aninhados em colunas com nomes separados por pontos. O arquivo é convertido no seu navegador e não é enviado. Listas de registros dentro de um registro são gravadas como texto JSON em uma única célula, e um arquivo com erro de sintaxe JSON não pode ser lido.
Um arquivo não foi convertido corretamente? Escreva para [email protected], de preferência com um pequeno arquivo de exemplo, e o problema será corrigido.
O essencial
- Entrada: JSON (.json). Saída: CSV (.csv).
- Seus arquivos não são enviados: o trabalho é feito no navegador, no seu próprio dispositivo.
- Tamanho: sem limite fixo; arquivos muito grandes são limitados pela memória do dispositivo.
- Precisa de um navegador atual (Chrome, Edge, Firefox ou Safari) no computador, tablet ou celular; nada para instalar.
- Grátis e sem cadastro.
Por que transformar JSON em uma tabela CSV
Exportações de APIs web, aplicativos, lojas virtuais e sistemas de log costumam chegar em JSON: ótimo para programas, difícil de ler para pessoas. Uma tabela CSV abre no Excel ou no Google Planilhas, onde você pode ordenar, filtrar e somar. Este conversor encontra a lista de registros no arquivo, também quando ela está dentro de um invólucro como "data", "results" ou "items", e cria uma linha por registro e uma coluna por campo. Campos aninhados viram colunas com nomes separados por pontos, então a cidade de um endereço vira address.city. Listas dentro de um registro, como tags, são gravadas como texto JSON ou, se preferir, como valores separados por ponto e vírgula. Os registros não precisam ter os mesmos campos: todo campo que aparece em algum lugar vira uma coluna, na ordem em que aparece pela primeira vez, e os valores ausentes ficam vazios. Arquivos JSON Lines (.jsonl, .ndjson) com um registro por linha também funcionam, e a prévia mostra as primeiras linhas antes do download.
Como converter JSON para CSV
- Solte seu arquivo .json, .jsonl ou .ndjson na caixa ou clique para escolhê-lo.
- Confira as colunas na prévia e escolha como as listas e o estilo de CSV devem ficar.
- Clique em “Converter para CSV” e baixe o arquivo.
O que muda na conversão
Qual lista vira a tabela
Se o arquivo for uma lista, cada item vira uma linha. Se for um objeto, a ferramenta usa a lista de registros mais longa que encontrar, até dois níveis abaixo, e mostra o nome dela (por exemplo "data.items") no resumo. Um objeto sem uma lista assim vira uma única linha.
Dados muito aninhados
Objetos aninhados são abertos até dez níveis de profundidade, e cada valor ganha sua própria coluna. Um registro que contém uma lista de outros registros, como os itens de um pedido, é gravado como texto JSON em uma única célula, porque uma tabela plana não tem um bom lugar para isso.
JSON inválido
Uma vírgula ou uma aspa faltando torna o arquivo inteiro ilegível. A ferramenta informa onde está o erro quando o navegador indica uma linha e uma coluna. Arquivos cortados, por exemplo um log que ainda estava sendo gravado, são uma causa comum.
GeoJSON são dados de mapa
Um arquivo GeoJSON contém coordenadas além de atributos. Use o conversor de GeoJSON para CSV, que grava as coordenadas como colunas X e Y ou como WKT.
Sobre os formatos
JSON
JSON (JavaScript Object Notation) é o formato de texto que a maioria das APIs web, aplicativos e arquivos de configuração usa para dados. Os valores podem ser aninhados: um registro pode conter outro registro ou uma lista, o que uma tabela plana não consegue.
- Objetos contêm valores com nome e listas contêm valores em ordem; os dois podem ser aninhados em qualquer profundidade.
- Os valores são texto, números, true/false ou null, então um CEP escrito como "01310" continua sendo texto.
- JSON Lines (.jsonl, .ndjson) coloca um objeto JSON em cada linha, algo comum em logs e exportações de dados.
- O texto é sempre Unicode, normalmente UTF-8.
CSV
CSV (valores separados por vírgula) é uma tabela em texto simples: uma linha por registro, com as células separadas por vírgula, ponto e vírgula ou tabulação. Excel, Google Planilhas, Numbers, todos os bancos de dados e a maioria das linguagens de programação leem e gravam CSV, por isso ele é a forma habitual de levar uma tabela de um programa para outro.
- Não há padrão para o separador: o Excel usa vírgula ou ponto e vírgula, conforme as configurações de idioma.
- Todo valor é texto; se 01310 é um número ou um CEP, quem decide é o programa que o lê.
- Não há planilhas, fórmulas, cores nem larguras de coluna, só os valores.
- A codificação não fica salva no arquivo; UTF-8 é a escolha segura, e o Excel precisa de um BOM para reconhecê-la.
Perguntas frequentes
Meu arquivo JSON é enviado para algum lugar?
Não. O arquivo é lido e convertido pelo seu navegador, no seu próprio dispositivo. Exportações de API com dados pessoais ou tokens de acesso nunca saem do seu computador.
O Excel vai mostrar os caracteres especiais corretamente?
Escolha um dos estilos Excel. Eles adicionam uma marca de ordem de bytes (BOM), para que o Excel leia o arquivo como UTF-8 e mostre corretamente letras como ç, ã e é.
Como true, false e null são gravados?
true e false são gravados como as palavras true e false, e null como uma célula vazia. Os números são gravados como estão no JSON, com vírgula decimal no estilo Excel na Europa.
Qual o maior arquivo que funciona?
Até 200 MB. O arquivo inteiro é carregado na memória, então é melhor converter arquivos com milhões de registros em um computador do que em um celular.