Sobre esta ferramenta
Este conversor de JSON para CSV transforma um array de objetos JSON, como uma resposta de API ou uma exportação de banco de dados, em uma tabela CSV que abre no Excel, no Google Planilhas ou no LibreOffice. Objetos aninhados são achatados em colunas com caminhos separados por ponto, arrays viram colunas numeradas, e as colunas de todos os registros são combinadas na ordem em que aparecem pela primeira vez.
Cole o JSON ou abra um arquivo .json de até 5 MB, escolha o delimitador e se quer escrever uma linha de cabeçalho, e depois copie ou baixe o CSV. Campos que contêm o delimitador, aspas ou quebras de linha são colocados entre aspas, como exige a RFC 4180. Tudo acontece no seu navegador.
Como funciona
A entrada pode ser um array de objetos (uma linha por objeto), um array de arrays (uma linha por array interno), um array de valores simples (uma coluna chamada value) ou um único objeto (uma linha). JSON inválido é informado com a linha e a coluna, quando o navegador as fornece.
Objetos aninhados viram colunas nomeadas com caminhos separados por ponto, por exemplo user.name e user.address.city. Arrays viram colunas numeradas com índices a partir de zero, como tags.0 e tags.1, de modo que todos os valores são mantidos mesmo quando os registros têm arrays de tamanhos diferentes. Arrays e objetos vazios, chaves ausentes e null viram células vazias. Números e booleanos são escritos como aparecem no JSON.
O CSV usa quebras de linha CRLF. Escolha o ponto e vírgula se a sua planilha usa a vírgula como separador decimal, e ative a marca de ordem de bytes quando o Excel exibir letras acentuadas incorretamente.
Exemplo
Considere dois registros com um objeto user aninhado e um array tags:
[{"id": 1, "user": {"name": "Ada", "email": "[email protected]"}, "tags": ["math", "code"]}, {"id": 2, "user": {"name": "Alan"}, "tags": ["logic"]}]
O CSV tem as colunas id, user.name, user.email, tags.0 e tags.1. A primeira linha é 1,Ada,[email protected],math,code. A segunda linha é 2,Alan, seguida de um e-mail vazio, logic e uma célula tags.1 vazia, porque Alan não tem e-mail e tem só uma tag.
Premissas e limites
A entrada é limitada a 5 MB de texto; acima de 300.000 caracteres, o resultado só é atualizado quando você clica em Converter. O JSON é interpretado pelo analisador padrão do navegador, então inteiros maiores que 9.007.199.254.740.991 podem perder precisão e chaves duplicadas mantêm apenas o último valor. Arrays dentro de arrays de arrays são escritos como texto JSON em uma célula. A ferramenta não protege contra fórmulas de planilha, então um valor que começa com = pode ser avaliado quando o arquivo é aberto em uma planilha. Os dados nunca saem do seu navegador.
Perguntas frequentes
Como converter JSON para CSV para o Excel?
Cole o JSON ou abra o arquivo, mantenha Escrever uma linha de cabeçalho ativado e baixe o CSV. Se o Excel mostrar letras acentuadas ou símbolos incorretamente, ative a opção de marca de ordem de bytes. Se o Excel colocar tudo em uma coluna só, escolha o delimitador ponto e vírgula, que é o que o Excel espera em idiomas que usam vírgula decimal, como o português do Brasil.
Como são tratados objetos e arrays aninhados?
Cada valor aninhado ganha sua própria coluna. As chaves de objetos são unidas por pontos, como address.city, e os elementos de arrays são numerados a partir de zero, como items.0.sku e items.1.sku. Isso mantém todos os valores e permite reconstruir a estrutura depois, mas arrays muito longos geram muitas colunas.
E se meus registros tiverem chaves diferentes?
O conversor reúne todas as chaves de todos os registros. As colunas aparecem na ordem em que ocorrem pela primeira vez, e um registro sem determinada chave recebe uma célula vazia nessa coluna.
Meu JSON é um objeto com um array data dentro. O que faço?
Um único objeto vira uma linha, então uma resposta de API como {"data": [...]} se transforma em colunas chamadas data.0.id, data.1.id e assim por diante. Cole só a parte do array, do [ de abertura até o ] de fechamento, para obter uma linha por registro.
Por que alguns valores ficam entre aspas?
O CSV exige aspas em volta de valores que contêm o delimitador, uma aspa dupla ou uma quebra de linha, e as aspas dentro desses valores são duplicadas. O conversor também coloca entre aspas valores com espaços no início ou no fim, para que as planilhas mantenham esses espaços.
Link com os seus valores
Adicione estes parâmetros ao endereço desta página para abri-la com os valores já preenchidos, por exemplo para compartilhar um cálculo ou criar um link a partir de um assistente de IA. O resultado é calculado no navegador: o HTML da página mostra um exemplo com os valores padrão, e a ferramenta define o atributo data-url-params quando os valores do link são aplicados.
| Parâmetro | Valor | Se omitido |
|---|---|---|
jsonEntrada JSON | não aceito em links: digite na página | |
delimiterDelimitador | um destes: comma, semicolon, tab, pipe | padrão: comma |
headerEscrever uma linha de cabeçalho | true ou false | padrão: true |
byte_order_markAdicionar marca de ordem de bytes (BOM) para o Excel ler UTF-8 corretamente | true ou false | padrão: false |
Exemplos
?delimiter=semicolon&byte_order_mark=true?delimiter=tab&header=false
Escreva decimais com ponto. Codifique um espaço como %20, + como %2B, # como %23 e & como %26.
Elementos do resultado: [data-result-block="csv-json"]