É possível converter JSON para CSV? Sim — o que você precisa saber (Guia 2026)

A versão curta: sim, com uma condição

Sim — dá para converter JSON em CSV. A única condição é estrutural: um arquivo CSV é uma grade plana de linhas e colunas, então seu JSON precisa poder ser expresso assim. A maioria dos JSONs do mundo real já é. APIs, exportações de dados e logs quase sempre retornam uma lista de registros (um array de objetos) ou um único registro (um objeto), e os dois cabem naturalmente numa planilha: um objeto por linha, uma chave por coluna.

Onde as pessoas travam não é na conversão em si, mas no formato dos dados. O JSON permite aninhamento — objetos dentro de objetos, listas dentro de objetos — enquanto o CSV não tem noção nenhuma de aninhamento. Então a pergunta por trás de “é possível converter JSON para CSV?” costuma ser uma de três perguntas menores: meus dados aninhados vão sobreviver, algo vai se perder, e eu preciso de software especial? As respostas são sim, com achatamento; quase nada, se você tiver cuidado; e não — uma ferramenta gratuita de navegador basta para a maioria dos arquivos.

O que o CSV exige, e o que o JSON entrega

Um arquivo CSV é propositalmente simples: a primeira linha nomeia as colunas, cada linha seguinte traz os valores na mesma ordem, e esse é o formato inteiro. Não há tipos de dados (tudo é texto), nem aninhamento, nem comentários, nem fórmulas. O JSON é muito mais flexível: valores podem ser strings, números, booleanos, null, objetos ou arrays, aninhados à profundidade que você quiser.

Essa diferença é toda a história desta conversão. Transformar JSON em CSV significa decidir, para cada pedaço do documento JSON, a qual linha e coluna ele pertence. Para os formatos comuns, o mapeamento é óbvio:

Array de objetos planos vira uma linha por objeto e uma coluna por chave. Este é o caso perfeito.
Um único objeto plano vira uma linha sob uma linha de cabeçalho. Trivial.
Um array de valores simples como ["a", "b"] vira uma única coluna com um valor por linha.
Objetos aninhados, ou arrays contendo objetos, precisam ser achatados primeiro — veja na próxima seção.

Se seu JSON é do primeiro tipo — e se veio de uma resposta de API, provavelmente é — a conversão é um clique só, sem pensar. O resto deste guia é para todo o resto.

Quando o JSON vira CSV perfeitamente

A entrada ideal é assim: um array JSON em que cada objeto tem as mesmas chaves planas. Cada objeto vira uma linha, cada chave vira um cabeçalho de coluna, e nada é inventado, adivinhado ou descartado.

JSON

[
  {"name": "Ana", "email": "ana@example.com", "plan": "pro"},
  {"name": "Bo", "email": "bo@example.com", "plan": "free"}
]

Isso vira um CSV com a linha de cabeçalho name,email,plan seguida de duas linhas de dados — um mapeamento sem perdas e reversível. Este é o formato que nosso conversor gratuito resolve numa colagem só, e é também o formato que o Power Query do Excel e o snippet de Python mais abaixo esperam. Se todo objeto do seu array tem as mesmas chaves, você pode parar de ler e só converter.

Variações leves continuam ok: se alguns objetos estão sem uma chave, essas linhas simplesmente ganham uma célula vazia naquela coluna. Conversores usam a união de todas as chaves de todos os objetos, então dados irregulares degradam graciosamente em vez de falhar.

A complicação: objetos e arrays aninhados

JSON real raramente é perfeitamente plano. Um pedido pode embutir o cliente em customer.name e os totais em pricing.total. O CSV não tem “dentro”, então os conversores achatam o aninhamento nos nomes das colunas usando notação de ponto: customer.name vira uma coluna literalmente chamada customer.name, e o valor fica naquela coluna.

Para mostrar exatamente o que acontece, passamos um registro de pedido aninhado pelo motor de conversão deste site com a opção de achatamento ligada (o padrão). A entrada tinha objetos aninhados em três níveis — customer.contact.email, shipping.city, pricing.total — e o motor produziu estas colunas:

Uma lista de valores simples, como ["red", "blue"], vira uma única célula com os valores unidos por ponto e vírgula e espaço: red; blue.
Uma lista de objetos, como [{"a": 1}, {"a": 2}], não pode ser espalhada pelas colunas, então é mantida como texto JSON compacto dentro de uma célula. Nenhum dado se perde — só não é explodido pela grade.
Arrays e objetos vazios viram [] e {} em vez de sumir em silêncio, então você consegue distinguir “vazio” de “ausente”.

CSV output

orderId,customer.name,customer.contact.email,customer.contact.phone,shipping.address,shipping.city,shipping.state,shipping.zip,pricing.subtotal,pricing.tax,pricing.total,status
ORD-9821,Alex Rivera,alex.r@techcorp.com,+1-555-0192,742 Evergreen Terrace,Springfield,OR,97477,249.99,21.25,271.24,shipped

Todo valor aninhado encontrou sua coluna, e nada foi descartado. Dois detalhes das regras de achatamento valem ser conhecidos, porque afetam listas:

O que muda na conversão (e o que não muda)

A conversão é fiel, mas não é invisível. Veja exatamente o que muda quando o JSON vira CSV:

Tipos viram texto. 42, true e "2026-10-06" caem no CSV como caracteres. Planilhas costumam redetectar números e datas ao importar, mas o CSV em si não carrega informação de tipo — um CEP como 07477 pode perder o zero inicial se a planilha adivinhar “número”. Formate a coluna como texto na importação quando isso importar.
null vira uma célula vazia. Uma chave ausente se comporta igual: se um objeto em cem não tem e-mail, aquela linha simplesmente fica em branco na coluna de e-mail.
A ordem das chaves vira a ordem das colunas. Objetos JSON são não ordenados por especificação; conversores usam a ordem de primeira aparição, então as colunas seguem a ordem em que as chaves aparecem primeiro nos seus dados.
A codificação continua UTF-8. Se caracteres acentuados virarem lixo no Excel, o arquivo foi lido como ANSI em vez de UTF-8 — importe de novo e defina a origem do arquivo como 65001: UTF-8.
O delimitador é configurável. Vírgula é o padrão, mas se o Excel da sua região espera ponto e vírgula, exporte com delimitador de ponto e vírgula em vez de brigar com a importação.

O que não muda: os valores em si, o número de registros e — com o achatamento ligado — toda a estrutura aninhada, reorganizada em colunas pontilhadas. Um hábito ainda vale a pena manter: arquive o JSON original. O CSV é uma simplificação de mão única, e converter de volta não vai restaurar os tipos de dados.

É possível converter JSON para CSV de graça?

Sim — esta é uma tarefa resolvida e comoditizada, e você não deveria pagar por ela. Conversores online gratuitos resolvem os casos comuns em segundos: cole seu JSON ou arraste um arquivo .json, depois baixe o CSV. O nosso é gratuito, sem conta, roda inteiramente no seu navegador e deixa você alternar achatamento, delimitador e cabeçalhos antes de baixar.

Abrir o conversor gratuito de JSON para CSV

Dá para fazer sem enviar seu arquivo para lugar nenhum?

Sim — e para dados sensíveis você deveria exigir isso. Existem dois tipos de conversores online. Conversores do lado do servidor enviam seu arquivo, convertem na máquina de outra pessoa e devolvem um link de download. Conversores do lado do cliente rodam a conversão inteira como JavaScript na sua própria aba do navegador, então os dados nunca saem do seu dispositivo.

O conversor deste site é do segundo tipo: cole ou arraste um arquivo e o CSV é gerado localmente na sua máquina. (A única requisição de rede que ele faz é quando você pede explicitamente que ele busque JSON de uma URL que você colou.) Como regra prática, se seu JSON contém chaves de API, e-mails de clientes ou qualquer coisa que você não enviaria por e-mail para um estranho, use um conversor do lado do cliente, seu editor ou um script local — nunca uma ferramenta que envia primeiro e converte depois.

Como saber de que tipo uma ferramenta é? Abra, cole alguns dados e observe a aba de rede do navegador durante a conversão — ou, mais simples, desconecte da rede depois que a página carregar. Um conversor do lado do cliente continua funcionando offline.

Excel ou Google Sheets fazem isso?

O Excel faz, nativamente, e é a melhor opção quando a planilha é seu destino final mesmo. Vá em Dados, depois Obter Dados, depois De Arquivo, depois De JSON, e escolha seu arquivo. O Power Query mostra os registros como uma tabela; expanda as colunas aninhadas com o ícone de expansão no cabeçalho da coluna, depois Fechar e Carregar e salve como CSV. Os dados aninhados são tratados visualmente em vez de notação de ponto, o que algumas pessoas preferem.

O Google Sheets não importa JSON nativamente — não há opção Arquivo, Importar para arquivos .json. Suas opções realistas são converter para CSV primeiro com uma ferramenta gratuita e depois usar Arquivo, Importar, ou rodar um pequeno Apps Script que busca e faz o parse do JSON. Para a maioria das pessoas, converter primeiro é mais rápido que programar no Sheets.

Um detalhe específico do Excel que vale saber: se tudo cair numa única coluna, seu Excel provavelmente espera ponto e vírgula como delimitador (comum em regiões europeias). Reexporte o CSV com delimitador de ponto e vírgula em vez de brigar com o assistente de importação.

Dá para converter com código em vez disso?

Se você converte o mesmo formato de JSON numa agenda — uma exportação diária, uma etapa de build, um pipeline de dados — um breve script de Python vence clicar numa ferramenta toda vez. Este é o snippet que equipes de dados usam: ele achata objetos aninhados em colunas com notação de ponto e escreve um BOM para o Excel detectar a codificação UTF-8 automaticamente.

Python

import pandas as pd

# Flat or list-of-objects JSON
df = pd.read_json("data.json")

# Nested objects? Flatten them to dot-notation columns first
df = pd.json_normalize(df.to_dict("records"))

# utf-8-sig adds a BOM so Excel detects the encoding correctly
df.to_csv("data.csv", index=False, encoding="utf-8-sig")

Para trabalhos pontuais no terminal, o jq converte sem Python. Este comando lê data.json, pega dois campos por objeto e imprime as linhas CSV direto no stdout — útil para logs e respostas de API que você já está passando por pipes:

Uma alternativa de uma linha no terminal

O comando jq abaixo foi testado nesta máquina: ele recebe um array de objetos, junta as tags de cada objeto com "; " e emite CSV válido com as aspas resolvidas para você.

Terminal

$ echo '[{"name":"Ana","tags":["x","y"]}]' | jq -r '.[] | [.name, (.tags|join("; "))] | @csv'
"Ana","x; y"

O filtro @csv é a parte que faz o trabalho de verdade: ele coloca aspas nos campos que precisam e escapa aspas embutidas conforme a RFC 4180, então você não precisa pensar nos casos de borda.

E arquivos JSON muito grandes?

Sim, mas não numa aba do navegador. Conversores baseados em navegador lidam confortavelmente com arquivos de alguns megabytes; além disso, as abas ficam lentas ou congelam porque o documento inteiro vive na memória de uma vez. Para arquivos grandes, converta localmente:

Python com pandas processa centenas de megabytes num laptop comum — o snippet acima funciona sem mudanças.
O jq processa JSON como um stream e nunca precisa do arquivo inteiro na memória para projeções simples de campos.
Para arquivos realmente enormes (gigabytes), divida a entrada primeiro — um objeto JSON por linha processa linha a linha — ou carregue no SQLite ou DuckDB e exporte CSV de lá.

Qualquer que seja o tamanho, valide o JSON antes de converter. Conversores rejeitam JSON inválido de cara, e achar o erro de sintaxe num arquivo de 2 GB é muito mais fácil com um validador de stream do que por tentativa e erro.

Qual método você deve escolher?

Todo método acima produz o mesmo CSV para a mesma entrada — a diferença é conveniência, privacidade e escala. Combine sua situação com uma linha:

Arquivo pontual, alguns megabytes ou menos: um conversor online gratuito. De longe o mais rápido.
Dados sensíveis: um conversor do lado do cliente ou um script local, para nada ser enviado.
A mesma conversão numa agenda: um script de Python que você pode reexecutar e versionar.
Um arquivo enorme: ferramentas locais — Python, jq ou DuckDB — nunca uma aba do navegador.
A planilha é o destino final: Power Query do Excel, pulando o intermediário.

E se você só precisava da resposta para a pergunta do título: sim, dá para converter JSON para CSV. Encontre sua linha acima e você termina em minutos.

Guias relacionados

Perguntas frequentes

É possível converter qualquer arquivo JSON para CSV?

Quase. Qualquer JSON que possa ser expresso como linhas e colunas converte de forma limpa, e estruturas aninhadas são achatadas primeiro em colunas com notação de ponto. A única entrada estranha é um documento sem nenhuma estrutura de registros — digamos, um objeto profundamente aninhado sem arrays — que ainda converte, mas produz uma tabela larga e esparsa. Usável, só não bonito.

Vou perder dados convertendo JSON para CSV?

Os valores sobrevivem; os tipos, não. Números, booleanos e datas viram texto simples, nulls viram células vazias, e o aninhamento é reorganizado em colunas achatadas. Um bom conversor nunca descarta nada em silêncio — mas guarde o arquivo JSON original, porque converter o CSV de volta não vai restaurar os tipos de dados originais.

Dá para converter JSON para CSV sem instalar nada?

Sim. Um conversor online gratuito faz isso direto no seu navegador, sem instalar e sem conta — cole o JSON, baixe o CSV. Se você já tem o Excel, Dados > Obter Dados > De JSON converte nativamente sem nenhum software extra.

É seguro colar meu JSON num conversor online?

Depende de onde a conversão acontece. Conversores do lado do cliente, como o deste site, rodam tudo na sua aba do navegador, então seus dados nunca saem do seu dispositivo — seguro mesmo para arquivos sensíveis. Evite ferramentas que enviam seu arquivo para um servidor primeiro, principalmente quando os dados contêm informações pessoais ou segredos.

Por que meu CSV convertido parece quebrado no Excel?

Dois suspeitos habituais: codificação e delimitador. Se caracteres acentuados aparecem como lixo, o arquivo foi lido como ANSI em vez de UTF-8 — importe de novo e defina a origem do arquivo como 65001: UTF-8. Se tudo cai numa coluna só, seu Excel espera ponto e vírgula (comum em regiões europeias) — reexporte com delimitador de ponto e vírgula.

Dá para converter o CSV de volta para JSON depois?

Sim, de CSV para JSON é a viagem de volta e é igualmente fácil — veja nosso guia "Como converter CSV para JSON" para os três métodos confiáveis. Uma ressalva: não vai ficar idêntico ao original. Colunas achatadas com notação de ponto continuam planas a menos que você as desachate, e todo valor volta como string.

Quanto tempo leva converter JSON para CSV?

Milissegundos para arquivos típicos: colar, baixar, pronto. O tempo só vira fator com arquivos muito grandes, de centenas de megabytes, onde uma aba do navegador pode sofrer e um script local é a escolha mais rápida e segura.