Como converter JSON em CSV: 3 métodos confiáveis (guia 2026)

O que realmente acontece ao converter JSON em CSV

JSON é hierárquico: objetos se aninham dentro de objetos e arrays guardam listas de valores. CSV é plano: só linhas e colunas. Converter significa mapear cada objeto de um array JSON para uma linha, e cada chave para uma coluna.

A parte complicada é o aninhamento. Um valor como {"address": {"city": "Berlin"}} não tem uma coluna CSV direta, então os conversores o achatam para address.city. Arrays dentro de objetos (tags: ["a", "b"]) costumam ser unidos em uma única célula, por exemplo "a; b".

Método 1: conversor online gratuito (o mais rápido)

Para uma conversão pontual, uma ferramenta online é o caminho mais rápido — sem instalação, sem código. Tudo roda no seu navegador, então seus dados nunca saem do seu dispositivo.

Cole seu JSON (ou arraste um arquivo .json) no conversor acima.
Escolha um delimitador: vírgula para a maioria das ferramentas, ponto e vírgula se o seu Excel esperar isso.
Confira a pré-visualização em tabela e clique em Baixar .csv.

Testar o conversor gratuito de JSON para CSV

Método 2: Microsoft Excel (Power Query)

Se você vive no Excel e converte arquivos com frequência, o Power Query lida com JSON nativamente — sem colar nada em sites de terceiros.

Abra o Excel → guia Dados → Obter Dados → De Arquivo → De JSON.
Selecione seu arquivo .json. O Power Query mostra os dados como uma lista de registros.
Clique em Para Tabela e expanda as colunas desejadas com o ícone de expansão.
Fechar e Carregar, depois salve como CSV em Arquivo → Salvar como → CSV UTF-8.
Dica: escolha “CSV UTF-8 (delimitado por vírgula)” para preservar acentos.

Método 3: script Python (repetível)

Para desenvolvedores e tarefas recorrentes, um pequeno script Python com pandas é a opção mais repetível. Ele achata objetos aninhados com json_normalize e grava em UTF-8 com BOM para que o Excel abra o arquivo corretamente.

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")

Execute com python convert.py. O CSV gerado abre diretamente no Excel, no Google Planilhas ou em qualquer ferramenta de importação de banco de dados.

Como lidar com JSON aninhado e arrays

Objetos aninhados se achatam de forma limpa com notação de ponto: user.profile.email vira a coluna user.profile.email. Arrays aninhados são o caso-limite — o conversor precisa decidir entre unir os valores em uma célula ou dividi-los em várias linhas. Para análise, unir (por exemplo "red; blue") mantém uma linha por registro e é o padrão comum.

Se o seu JSON for um único objeto em vez de um array, coloque-o primeiro entre colchetes [ ... ] — cada linha do CSV precisa vir de um objeto dentro de uma lista.

Delimitadores: vírgula vs. ponto e vírgula

CSV significa «comma-separated», mas muitos aplicativos de planilha europeus esperam ponto e vírgula, porque a vírgula é o separador decimal por lá. Se o seu CSV abrir com tudo espremido em uma coluna, o delimitador está errado — exporte novamente com ponto e vírgula. Nosso conversor oferece vírgula, ponto e vírgula, tabulação e pipe.

Problemas comuns e soluções rápidas

A maioria das dores de cabeça se resume a quatro problemas:

Vírgulas ou aspas dentro de um campo: um CSV válido envolve o campo em aspas duplas e duplica as aspas internas ("She said ""hi"""). Qualquer bom conversor faz isso automaticamente (RFC 4180).
Caracteres estranhos no Excel: salve com codificação UTF-8 (com BOM) para que o Excel detecte.
Zeros à esquerda sumindo (CEPs, IDs): o Excel trata a coluna como número. Importe via Dados → De Texto/CSV e defina o tipo da coluna como Texto.
Arquivos enormes travando o navegador: divida o array JSON em partes menores ou use o método Python acima.

Guias relacionados

Perguntas frequentes

É seguro converter JSON em CSV online?

Sim, se o conversor rodar totalmente no seu navegador — como este. Seu arquivo é processado localmente no seu dispositivo e nunca é enviado a um servidor. Evite ferramentas que exijam o upload de dados sensíveis para um servidor desconhecido.

Como converto JSON aninhado em CSV no Excel?

Use o Power Query: Dados → Obter Dados → De Arquivo → De JSON, depois use o ícone de expansão nas colunas aninhadas para achatá-las antes de carregar. Para arquivos muito aninhados, um conversor online com achatamento em notação de ponto costuma ser mais rápido.

Por que meu CSV abre com tudo em uma só coluna?

Delimitador incompatível. Provavelmente seu arquivo usa vírgulas enquanto sua planilha espera ponto e vírgula (comum na Europa), ou vice-versa. Exporte novamente com o outro delimitador, ou use Dados → De Texto/CSV no Excel e escolha o delimitador manualmente.

Dá para converter CSV de volta para JSON?

Sim. As mesmas ferramentas funcionam ao contrário: a maioria dos conversores online faz isso, e um snippet Python de uma linha (pd.read_csv("f.csv").to_json("f.json", orient="records")) transforma as linhas do CSV de volta em um array JSON.

Preciso instalar algo para converter JSON em CSV?

Não. Um conversor no navegador faz todo o trabalho: colar, revisar, baixar. Instalar software só compensa para tarefas em lote que você executa todo dia, quando um script Python ou o Power Query economiza tempo de verdade.

A conversão de JSON para CSV perde dados?

Os valores ficam intactos, mas a estrutura muda: objetos aninhados viram colunas com notação de ponto, arrays se juntam numa única célula e a formatação dos números, como zeros à esquerda ou à direita, pode se perder. Confira sempre uma linha complicada antes de importar o CSV para o seu fluxo real.

Como converter um arquivo JSON que é um único objeto, e não um array?

Envolva-o em colchetes [ ... ] para transformá-lo num array de um elemento: cada linha do CSV precisa vir de um objeto. A maioria dos conversores online também aceita um objeto avulso e o trata automaticamente como uma única linha.