Converter JSON em CSV JavaScript Object Notation ↔ Comma-Separated Values Grátis Online Seguro
Solte um arquivo JSON e leve CSV. É lido e escrito aqui, no seu navegador, por isso o arquivo não sai do seu aparelho — e o que a conversão mantém, e o que não consegue, está escrito mais abaixo em vez de ficar para descobrir.
Converta o seu arquivo
Solte aqui um arquivo JSON, ou escolha um.
O seu arquivo não sai deste dispositivo. Tudo roda no seu navegador.
Nada é enviado
Converter a partir de JSON
Converter para JSON
De onde vêm estes formatos
O CSV é o mais antigo e o menos normalizado: uma tabela escrita em linhas de texto, em uso desde os anos setenta e só descrito por escrito em 2005, quando cada programa já decidira por si qual era o delimitador e quando pôr aspas. O XML saiu do SGML em 1998, para documentos que têm de levar estrutura estrita e ser verificados contra um esquema. O JSON foi retirado do JavaScript por Douglas Crockford por volta de 2001, reduzido de propósito a objetos, listas, números e cadeias — e esse despojamento é a razão de ter conquistado a web. O YAML é o seu primo legível, onde a indentação faz o trabalho que em outros lugares cabe às chavetas. Ao converter entre eles só importa uma coisa: o CSV é plano, uma grelha de linhas e colunas, ao passo que JSON, XML e YAML são árvores.
Onde os encontra
O CSV é o que uma planilha exporta e o que lhe entregam um contabilista, uma plataforma de loja ou um extrato bancário. O JSON é o que os serviços web falam e aquilo em que cada vez mais se escrevem os arquivos de configuração. O XML sobrevive em sistemas empresariais antigos, nas normas de faturação e dentro dos próprios formatos de escritório. O YAML é onde as pessoas escrevem definições à mão. Converter entre eles é o trabalho diário de levar os dados de onde foram produzidos para onde são precisos.
Perguntas frequentes
O meu CSV abriu como uma única coluna no Excel. Porquê?
Porque a sua planilha esperava outro aba. O Excel segue o aba de listas das definições regionais, que é o ponto e vírgula em toda a parte onde a vírgula já é o sinal decimal — ou seja, em boa parte da Europa continental. Um arquivo separado por vírgulas aparece então como uma só coluna de texto. Use a caixa de importação e indique o aba, em vez de abrir o arquivo com duplo clique. A mesma definição regional explica que 3.5 chegue por vezes transformado em data.
Por que o meu JSON aninhado não dá uma planilha arrumada?
Porque uma planilha é plana e o JSON é uma árvore. Uma linha leva um valor por coluna; um objeto JSON pode conter uma lista dentro de um campo dentro de outra lista. Converter é escolher como achatar isso: ou juntar os nomes aninhados num cabeçalho de coluna comprido, ou repetir a linha-mãe uma vez por cada filha. Ambas são cedências, e nenhuma se desfaz automaticamente — por isso voltar da planilha à forma original costuma exigir uma decisão humana.
O arquivo perde qualidade?
Depende do que os dois formatos conseguem guardar. Converter entre formatos que armazenam a mesma coisa — um PNG para BMP, um WAV para FLAC — não perde nada. Converter para um formato que descarta informação para poupar espaço, como JPEG ou MP3, perde um pouco de cada vez, e voltar atrás não a traz de volta. Onde existe escolha, esta página tende a conservar a qualidade original em vez de fazer o arquivo menor.
O meu arquivo é enviado para algum lado?
Não. A conversão acontece dentro do seu navegador, na sua própria máquina; o arquivo nunca sai dela e aqui não existe servidor nenhum que o pudesse receber. É por isso que um arquivo grande é limitado pela sua memória e não por um envio, e que nada do que converter pode aparecer nos registros de quem quer que seja — incluindo os nossos. As ferramentas de áudio e de vídeo buscam, porém, o seu motor de conversão neste site da primeira vez que as usar — uns trinta megabytes, uma só vez; depois o trabalho continua a acontecer inteiramente na sua máquina.
Por que as pessoas convertem JSON em CSV
O JSON é a linguagem que os programas usam para conversar entre si. Uma exportação de um serviço da web, a resposta de uma API, uma configuração salva por um aplicativo, um despejo de um banco de dados: a maior parte chega como JSON. É ótimo para o software e incômodo para as pessoas, porque uma tela cheia de colchetes, aspas e vírgulas não é algo que se possa ordenar, filtrar ou somar. O CSV é o oposto: uma tabela simples, uma linha por registro, células separadas por vírgulas, que abre em qualquer planilha do planeta. É por isso que as pessoas convertem JSON em CSV: elas têm dados que um programa produziu e querem olhá-los, contá-los ou entregá-los a alguém que vive numa planilha.
As situações são familiares. Um analista que puxou registros de uma API e quer uma tabela dinâmica. Um lojista que exportou pedidos de uma plataforma on-line e precisa deles no Excel. Um pesquisador com os resultados de uma pesquisa salvos por uma ferramenta. Um desenvolvedor que quer conferir algumas centenas de registros de relance. Em todos os casos os dados já são estruturados, e o que falta é só a tabela.
Esta página converte JSON em CSV no seu navegador. O seu arquivo é lido e escrito aqui, então nunca sai do seu dispositivo, o que importa para listas de clientes, pedidos e qualquer outra coisa pessoal. E a página diz com antecedência o que a travessia preserva e o que não pode preservar, em vez de deixar você descobrir. Abaixo você verá como a conversão funciona, que tipo de JSON pode virar tabela e o que acontece com o resto.
Como a conversão funciona
As chaves viram o cabeçalho, na ordem em que aparecem pela primeira vez
O seu arquivo JSON é lido dentro do seu navegador. As chaves dos registros viram a linha de cabeçalho do CSV, na ordem em que aparecem pela primeira vez. Cada registro vira então uma linha, e cada valor é escrito como está. Se você olhar a primeira linha do resultado, verá os nomes dos campos; abaixo deles, uma linha para cada registro.
Uma chave ausente deixa uma célula vazia
Os registros nem sempre são uniformes. Um pode não ter um campo que os outros têm. Nesse caso uma linha sem uma chave deixa uma célula vazia em vez de deslocar as colunas. A coluna continua onde deve estar, e a célula fica simplesmente vazia, de modo que a tabela permanece alinhada.
Cada linha e cada coluna
Nada é descartado. Cada registro vira uma linha e cada chave que aparece em qualquer lugar vira uma coluna. Você não precisa se preocupar que um campo que só aparece no milésimo registro fique de fora.
O que é mantido
Todas as linhas e todas as colunas
Cada linha e cada coluna é mantida. Os dados que você deu são os dados que você recebe, em forma de tabela.
Os valores como estão
Cada valor é escrito como está. Números continuam números, texto continua texto, e os valores que contêm vírgulas ou aspas são colocados entre aspas corretamente para que a planilha os leia como uma só célula.
A ordem dos campos
As colunas seguem a ordem em que as chaves apareceram primeiro, que normalmente é a ordem usada pelo programa que produziu o arquivo. Isso mantém a tabela familiar para quem já viu os dados na forma original.
O que você deve saber antes de converter JSON em CSV
Só uma forma de JSON já é uma tabela
Só uma forma de JSON já é uma tabela: uma matriz de objetos simples, como uma lista de registros, cada um com o mesmo tipo de campos. Um único objeto, ou uma árvore com objetos dentro de objetos, não tem linhas para escrever e é recusado em vez de ser achatado em algo que você não pediu. Essa é uma escolha deliberada. Achatar uma árvore envolve decisões sobre nomes e sobre quais ramos manter, e um palpite errado produziria uma tabela que parece certa e não é.
Os valores aninhados são escritos como texto JSON
Quando um valor é em si uma lista ou um objeto, ele é escrito na célula como texto JSON, porque uma célula não consegue guardar um ramo. Assim, um registro com um campo de etiquetas, que contém uma lista, mostrará essa lista como texto numa célula. Está tudo lá, e você pode dividi-la com as ferramentas da sua planilha, se quiser.
O CSV não tem tipos
Um arquivo CSV é texto. Se 007 é um número ou um código é a planilha que decide ao abrir o arquivo, e as planilhas são famosas por adivinhar errado. Zeros à esquerda, números longos e datas podem ser alterados na abertura. Se isso importa, importe o arquivo pela caixa de diálogo de importação e marque essas colunas como texto.
Como converter JSON em CSV aqui
Adicione o seu arquivo
Solte o arquivo JSON na página ou escolha-o no seu dispositivo. Ele é lido dentro do seu navegador e não é enviado.
Converta
Aperte o botão. Um arquivo de tamanho comum leva um instante. Deixe a página aberta até terminar.
Baixe e abra
Baixe o CSV e abra-o no seu programa de planilha, ou num editor de texto para olhá-lo. Confira o cabeçalho, algumas linhas do meio e a última linha.
Um olhar mais de perto para o JSON e o CSV
Árvores e tabelas
O JSON descreve uma árvore: objetos que contêm valores, que por sua vez podem ser objetos ou listas. O CSV descreve uma tabela: linhas e colunas, nada mais. Uma árvore pode guardar coisas que uma tabela não pode, como um ramo com ramos diferentes embaixo. Uma tabela que é uma lista de registros uniformes, por outro lado, pode ser escrita em JSON sem nenhuma perda. Converter JSON em CSV é ir da forma geral para a especial, e funciona sem atrito quando os dados eram uma tabela desde o início.
Por que o rigor ajuda
As ferramentas que aceitam qualquer JSON e o achatam automaticamente costumam inventar nomes de coluna como address.street ou items.0.price. Isso é conveniente até você precisar saber o que aconteceu. Ao aceitar só a forma que já é uma tabela, esta página poupa você de decisões silenciosas. Se o seu arquivo é uma árvore, você sabe na hora.
Vírgulas, aspas e quebras de linha
O CSV tem as suas próprias armadilhas: uma vírgula dentro de um valor, uma aspa, uma quebra de linha no meio de uma célula. Elas são tratadas colocando a célula entre aspas e dobrando as aspas que há dentro, de modo que a planilha lê a tabela como se pretendia.
Situações comuns em detalhe
Exportações de serviços da web e APIs
A maioria dos serviços devolve listas de registros como JSON. Se você precisa delas numa planilha, converta JSON em CSV e abra o resultado. É o caminho mais rápido de uma resposta de API a uma tabela dinâmica.
Pedidos, clientes e produtos
As plataformas de lojas costumam permitir exportar dados como JSON. Um CSV de pedidos ou produtos pode ser ordenado por data, filtrado por cliente ou totalizado por produto em poucos cliques.
Resultados de pesquisas e registros
As ferramentas que guardam respostas de pesquisas ou registros de eventos como JSON produzem um registro por resposta ou evento. Como CSV, eles podem ser contados, representados em gráficos e comparados.
Conferindo os dados de relance
Os desenvolvedores costumam converter algumas centenas de registros em CSV só para lê-los. Uma tabela é mais fácil de percorrer que chaves aninhadas, e uma planilha pode ordenar e destacar os que fogem do padrão.
Conselhos práticos antes de converter JSON em CSV
Confira a forma do seu arquivo
Abra o JSON num editor de texto. Se ele começa com um colchete e contém uma lista de registros entre chaves com valores simples, é a forma certa. Se começa com uma chave e tem registros aninhados dentro, procure a lista de que precisa e extraia-a primeiro.
Saiba quais valores são aninhados
Se alguns campos contêm listas ou objetos, eles aparecerão como texto JSON nas células. Decida se você precisa deles divididos e planeje fazer isso na planilha.
Atenção à codificação e ao separador
O CSV é escrito com vírgulas. Algumas planilhas, em algumas regiões, esperam ponto e vírgula. Se um arquivo abrir numa única coluna, use a função de importação e defina o separador.
Arquivos grandes
Tudo roda no seu dispositivo, então um arquivo muito grande precisa de memória. Para arquivos de muitos megabytes, use um computador e divida os dados se a página tiver dificuldade.
Perguntas que as pessoas fazem antes de converter
Por que o meu arquivo foi recusado?
Porque não é uma matriz de objetos simples. Um único objeto, ou uma árvore com objetos dentro de objetos, não tem linhas para escrever. Escolha a lista de que precisa e converta essa.
O que acontece com um registro que não tem um campo?
Ele deixa uma célula vazia nessa coluna. As colunas não se deslocam.
O que acontece com listas dentro de um registro?
Elas são escritas na célula como texto JSON, porque uma célula não consegue guardar um ramo.
Por que os meus zeros à esquerda somem na planilha?
Porque a planilha decidiu que a coluna era numérica ao abrir o arquivo. O CSV guarda os zeros; use a caixa de diálogo de importação e marque a coluna como texto.
O meu arquivo é enviado?
Não. A conversão roda no seu navegador e o arquivo nunca sai do seu dispositivo.
Posso voltar para JSON?
Sim. CSV para JSON transforma uma tabela de volta numa lista de registros.
Escolhendo bem ao converter JSON em CSV
CSV ou uma planilha de verdade?
Se você quer um arquivo que abra no Excel com uma planilha própria, JSON para XLSX escreve a mesma tabela como uma pasta de trabalho. O CSV é mais leve e mais universal; o XLSX abre sem nenhuma etapa de importação.
Outros destinos
Se o destino é um arquivo de configuração ou de marcação, JSON para XML e JSON para YAML atendem a essas necessidades.
Guarde o JSON
O JSON é o original. Ele guarda a estrutura e os tipos. Guarde-o e trate o CSV como uma visão dos dados.
Obtendo um bom resultado depois da conversão
Importe, não apenas abra
Quando um arquivo contém códigos, números de telefone ou datas, use a caixa de diálogo de importação da sua planilha e defina o tipo de cada coluna. Isso evita o dano silencioso que a adivinhação automática pode causar.
Confira algumas linhas com a fonte
Compare alguns registros da tabela com o JSON. Leva um minuto e diz que a tabela é fiel.
Divida as células aninhadas quando for preciso
Se uma célula guarda uma lista como texto, use a ferramenta de texto para colunas ou uma fórmula para dividi-la. Ou volte e prepare o JSON de modo que cada item tenha um registro próprio.
Preparando o seu JSON para converter bem
Dê forma aos dados antes de converter JSON em CSV
Se o seu arquivo é uma árvore, você costuma poder remodelá-lo numa lista de registros simples antes de converter JSON em CSV. Escolha a lista que contém o que você quer contar: os pedidos, os clientes, os eventos. Copie-a num arquivo próprio, com os colchetes em volta, e a página a aceitará. Esse pequeno passo é a diferença entre uma recusa e uma tabela limpa.
Mantenha os nomes dos campos significativos
As chaves viram o cabeçalho, então quanto mais claros os nomes, mais legível a tabela. Se você controla a fonte, use nomes como order_date e customer_name em vez de abreviações que só um programador entenderia.
Seja coerente com os tipos
Um campo que guarda números na maioria dos registros e texto em alguns confundirá uma planilha. Se puder, limpe os que fogem do padrão antes da conversão, de modo que cada coluna signifique uma coisa só.
Pense nas datas
As datas em JSON costumam ser texto num formato combinado. São escritas no CSV como estão. Depois de converter JSON em CSV, diga à planilha como lê-las ao importar, e ela as tratará como datas e permitirá ordenar e filtrar por tempo.
Teste primeiro num pedaço pequeno
Se o seu arquivo é grande, copie os primeiros vinte registros num arquivo de teste e converta esse. Uma olhada rápida no resultado mostra se a forma e os nomes dos campos são o que você espera, antes de gastar tempo com o todo.
Privacidade e manuseio
Por que a conversão local importa para dados
Os arquivos de dados costumam conter o que é privado: clientes, pedidos, endereços, mensagens. Muitos conversores on-line enviam o seu arquivo a um servidor, processam e devolvem o resultado, e por um tempo uma cópia fica numa máquina que você não controla. Aqui o seu próprio navegador faz o trabalho, então os dados ficam no seu dispositivo.
O que acontece quando você sai
Quando você fecha a página, o arquivo convertido desaparece do navegador, então baixe-o antes. Nada sobre os seus dados é guardado.
Se algo der errado
A página diz que o arquivo não é um JSON válido
Pode haver uma vírgula sobrando, uma aspa faltando ou um colchete que não fecha. Abra o arquivo num editor que destaca erros de JSON e corrija a linha indicada.
As colunas parecem embaralhadas
A sua planilha pode esperar outro separador. Importe o arquivo e defina o separador como vírgula.
A página trava com um arquivo grande
Tudo roda no seu dispositivo, e um arquivo grande precisa de memória. Tente de novo num computador, ou divida os dados.
Ferramentas relacionadas
A mesma família de ferramentas cobre os trabalhos vizinhos. Para voltar, use CSV para JSON. Para uma pasta de trabalho, JSON para XLSX e XLSX para JSON trabalham com arquivos do Excel. Para outros formatos de dados estruturados, há JSON para XML, XML para JSON, JSON para YAML e YAML para JSON. Quando os números estão num PDF, PDF para XLS reconstrói uma tabela a partir da página.
Um exemplo resolvido
Digamos que você exportou 500 pedidos de uma loja on-line como um arquivo JSON e quer saber quais produtos vendem melhor. Você solta o arquivo aqui e aperta o botão. Um instante depois baixa um CSV com um cabeçalho com os nomes dos campos e 500 linhas embaixo. Você o importa na sua planilha, marca o código do produto como texto, faz uma tabela dinâmica e vê a resposta. O JSON fica na sua pasta como fonte.
Uma lista de conferência curta
Antes de converter
Confira se o arquivo é uma lista de registros. Anote quais campos são aninhados. Guarde o JSON.
Durante a conversão
Fique na página até o arquivo ficar pronto.
Depois de converter
Importe o CSV com os tipos certos, confira algumas linhas com a fonte e salve a tabela no formato da sua planilha.
Erros comuns
Dar uma árvore para ele
Não espere converter JSON em CSV para um arquivo muito aninhado. Extraia primeiro a lista de registros.
Abrir com duplo clique e confiar no resultado
As planilhas adivinham os tipos. Importe com tipos explícitos para códigos e datas.
Apagar o JSON
Guarde-o. Ele guarda a estrutura que a tabela não consegue.
Seus dados ficam no seu dispositivo
A conversão acontece localmente. Seu arquivo é lido pelo seu próprio navegador, reescrito ali e devolvido como CSV. Nada é enviado, então nenhuma cópia acaba num servidor e ninguém mais pode lê-lo. Para dados com conteúdo privado, essa é a forma segura de converter JSON em CSV.
Resumo
Para converter JSON em CSV aqui, solte o arquivo e aperte o botão. Ele é lido e escrito no seu navegador, então o arquivo nunca sai do seu dispositivo. Cada linha e cada coluna é mantida: as chaves viram o cabeçalho, na ordem em que aparecem pela primeira vez, e cada valor é escrito como está. Uma linha sem uma chave deixa uma célula vazia em vez de deslocar as colunas. Só uma forma de JSON já é uma tabela, uma matriz de objetos simples. Um único objeto, ou uma árvore com objetos dentro de objetos, não tem linhas para escrever e é recusado em vez de ser achatado em algo que você não pediu. Quando um valor é em si uma lista ou um objeto, ele é escrito na célula como texto JSON, porque uma célula não consegue guardar um ramo.