Conversor online gratuito de JSON para CSV

Uma planilha, um importador de banco de dados ou um sistema de relatórios pode exigir CSV tabular em vez de JSON estruturado. A conversão torna os registros simples mais fáceis de editar no Excel ou no LibreOffice Calc e fornece o layout esperado por muitas ferramentas de importação em massa.

O que é JSON

JSON (JavaScript Object Notation) é um formato de texto composto por objetos, arrays, pares chave-valor, números, strings, valores Boolean e null. APIs Web, aplicativos de navegador, sistemas de configuração, bancos de dados e linguagens de programação geralmente produzem arquivos com a extensão .json.

JSON pode armazenar objetos e arrays aninhados, portanto um registro pode conter vários níveis de dados relacionados. Essa flexibilidade não corresponde diretamente a uma tabela simples de planilha. Um arquivo JSON Lines ou NDJSON, no qual cada linha é um objeto JSON separado, também exige um procedimento de importação diferente do de um documento JSON padrão.

O que é CSV

CSV (comma-separated values) representa registros tabulares como linhas, com um campo por coluna. A primeira linha geralmente contém os nomes das colunas. Um campo que contenha um delimitador, aspas ou uma quebra de linha deve estar entre aspas; as aspas dentro de um campo entre aspas normalmente são representadas por duas aspas.

Excel, LibreOffice Calc, importadores de bancos de dados, software estatístico e scripts de processamento de dados são compatíveis com CSV. Ele funciona bem para listas simples, filtragem, classificação e importações em massa, mas não mantém nativamente objetos aninhados, arrays, tipos de dados, fórmulas ou formatação de células. As implementações de CSV podem usar ponto e vírgula ou tabulação em vez de vírgula; portanto, é necessário verificar o requisito de delimitador do destino.

Como converter o arquivo

Para uma conversão pontual, use gratuitamente o conversor de JSON para CSV em 101convert.com, sem instalar software:

1. Abra o conversor e carregue o arquivo .json ou cole um documento JSON.
2. Se houver opções de seleção ou nivelamento de campos, escolha o array que contém os registros e os campos que devem se tornar colunas.
3. Inicie a conversão e baixe o arquivo .csv resultante.
4. Abra o CSV no LibreOffice Calc, Excel ou outro aplicativo de planilha e verifique o delimitador, a codificação de caracteres, os cabeçalhos, a quantidade de linhas e alguns valores representativos.

Não carregue dados confidenciais ou regulamentados, a menos que o serviço seja aprovado para esse tipo de dado.

Para conversões repetíveis ou privadas, os módulos json e csv da biblioteca padrão do Python evitam a instalação de um pacote adicional. Este exemplo espera um array de objetos no nível superior:

import csv
import json

with open("input.json", encoding="utf-8") as source:
    records = json.load(source)

if not isinstance(records, list) or any(not isinstance(record, dict) for record in records):
    raise ValueError("Expected a top-level array of objects")

columns = list(dict.fromkeys(
    key for record in records for key in record
))

with open("output.csv", "w", newline="", encoding="utf-8-sig") as target:
    writer = csv.DictWriter(
        target, fieldnames=columns, extrasaction="ignore"
    )
    writer.writeheader()
    writer.writerows(records)

Salve o código como json_to_csv.py e execute python json_to_csv.py. O script preserva a ordem em que as chaves aparecem pela primeira vez, grava células vazias para chaves ausentes e deixa valores aninhados inadequados para uma conversão simples para CSV. A codificação utf-8-sig adiciona uma marca de ordem de bytes UTF-8 que ajuda algumas versões do Excel para Windows a detectar texto Unicode; use utf-8 simples quando o sistema receptor não aceitar uma marca de ordem de bytes.

Algumas versões do Microsoft Excel podem importar JSON por meio de Data → Get Data → From File → From JSON. No Power Query, expanda a lista ou o registro do nível superior, expanda os registros aninhados em colunas e use Close & Load; exporte a tabela resultante com File → Save As e selecione CSV. Se a versão instalada do Excel não tiver esse conector, converta o arquivo primeiro e abra o CSV pela caixa de diálogo de importação. No LibreOffice Calc, use File → Open para abrir o CSV resultante e selecione UTF-8, o separador necessário e o caractere de aspas correto.

Limites de qualidade e compatibilidade

A entrada mais conveniente é um array no nível superior, como [{"id":1,"name":"A"},{"id":2,"name":"B"}]. Um objeto no nível superior pode representar um único registro, um contêiner que inclui o array de registros real ou metadados não relacionados. O conversor deve identificar o array pretendido antes de produzir linhas significativas.

Objetos e arrays aninhados exigem uma política explícita. Eles podem ser nivelados em colunas como address.city, serializados como texto JSON dentro de um único campo CSV entre aspas ou omitidos. Os valores de arrays podem ser unidos em texto. Conversores diferentes usam políticas diferentes; portanto, inspecione os campos aninhados e várias linhas de saída, em vez de verificar apenas os cabeçalhos.

O CSV não possui uma distinção nativa confiável entre números, datas, valores Boolean e strings. O software de planilha pode converter automaticamente identificadores, zeros à esquerda, números inteiros longos ou datas ISO. Importe as colunas como texto quando a grafia original precisar permanecer inalterada e confirme se valores vazios, null e campos ausentes têm o significado necessário.

Use UTF-8 para caracteres não ASCII e confirme se o destino espera vírgulas, ponto e vírgulas, tabulações, finais de linha CRLF ou uma marca de ordem de bytes. Considere CSV não confiável potencialmente perigoso no software de planilha: valores que começam com =, +, - ou @ podem ser interpretados como fórmulas. Inspecione ou neutralize esses valores antes de abrir o arquivo.