What is JSON to CSV online: o significado explicado (guia 2026)

Palavra 1: JSON, o formato que as APIs falam

JSON significa JavaScript Object Notation, mas você pode ignorar o nome. O que importa é de onde ele vem: JSON é como APIs, aplicativos web e muitas ferramentas de desktop escrevem dados estruturados. Quando você exporta dados de uma plataforma de loja, um processador de pagamentos, uma ferramenta no-code ou o backend de um aplicativo de celular, eles quase sempre chegam como um arquivo JSON ou um bloco de JSON dentro de um e-mail.

É texto puro. Chaves seguram objetos, colchetes seguram listas, e cada chave fica entre aspas. Aqui está o tipo de registro que uma API real poderia retornar:

JSON: um registro de pedido, como uma API retornaria

{
  "id": "A-101",
  "customer": { "name": "Amelia", "city": "Austin" },
  "tags": ["new", "vip"]
}

Ninguém se senta para escrever JSON à mão por diversão. Você acaba com JSON porque uma ferramenta entregou ele para você. Essa é toda a história por trás da expressão: uma pessoa com dados nesse formato, precisando deles em outro formato, buscando o caminho mais rápido e honesto para chegar lá.

JSON foi feito para máquinas. Ele aninha livremente, objetos dentro de objetos, listas dentro de objetos, o que o torna flexível para programadores e estranho para todo mundo. Você não consegue abrir esse registro no Excel e ver nada sensato sem convertê-lo antes.

Palavra 2: CSV, o formato que as planilhas leem

CSV significa Comma-Separated Values, valores separados por vírgula. Também é texto puro, mas com a estrutura mais simples possível: cada linha é uma linha da tabela, e vírgulas separam as colunas. Excel, Google Sheets, LibreOffice e praticamente toda ferramenta de dados do planeta abrem arquivos CSV sem reclamar.

Os mesmos três fatos do JSON acima, escritos como CSV, ficam assim:

CSV: os mesmos três fatos, uma linha por registro

id,name,city
A-101,Amelia,Austin

Esse é o formato inteiro. Sem aninhamento, sem tipos, sem formatação, só linhas e vírgulas. Uma célula CSV não pode conter um objeto. Ela só pode conter texto.

CSV foi feito para pessoas e planilhas. Ordenar, filtrar, tabelas dinâmicas, listas de e-mail, importar para outro sistema: tudo isso espera CSV ou uma planilha. Quando um chefe diz "me mande isso como planilha", CSV costuma ser o que ele quer dizer, e abre em qualquer programa que a pessoa tenha instalado.

Palavra 3: online, feito no navegador

"Online" é a palavra menos técnica da expressão e a que mais esconde por trás. Significa que a conversão acontece numa página web, numa aba do navegador, sem nada para instalar. Você cola seu JSON numa caixa, a página converte, você baixa o CSV.

Mas nem todo conversor online funciona do mesmo jeito, e a diferença importa. Um conversor client-side faz o trabalho dentro do seu navegador: seus dados nunca saem da aba. Um conversor baseado em upload envia seu arquivo para o servidor de outra pessoa, converte lá e devolve o resultado. Os dois parecem idênticos no navegador. A diferença é por onde seus dados viajam.

O conversor desta página é client-side. A única requisição de rede que a página faz é o botão opcional de buscar por URL, e só quando você clica nele. Dados colados e enviados por upload são convertidos localmente. Há um teste de 30 segundos para isso mais adiante no guia, e você pode executá-lo em qualquer conversor que encontrar.

Onde você encontra a expressão "JSON to CSV online"

A expressão aparece em alguns lugares específicos, e reconhecer em qual deles você está diz o que você realmente precisa. O mais comum é a caixa de busca: alguém te manda um arquivo JSON por e-mail e diz "você pode colocar isso numa planilha", e você digita a expressão no Google.

O segundo lugar é no próprio botão. Sites de conversão, documentações de API e ferramentas de dados rotulam seus botões com a expressão, então você também a encontra como a coisa em que clica. O terceiro é num requisito: uma página de documentação de API que só exporta JSON, um cliente que envia payloads de webhook, um tutorial que assume que você tem CSV.

Nos três casos, quem pergunta normalmente não liga para formatos. A pessoa se importa com o resultado: dados que ela pode abrir, ordenar e repassar. A expressão é só o jeito mais curto de nomear esse trabalho.

O que você realmente quer quando digita isso

Quase todo mundo que digita essa expressão quer uma de três coisas. A primeira e mais comum é a conversão em si: você tem o JSON na sua frente e precisa do CSV agora. Isso é um trabalho de 60 segundos com um bom conversor, e não há mais nada para aprender.

A segunda é segurança: é seguro e é grátis? Seguro depende da arquitetura do conversor, que a próxima seção cobre. Grátis é quase sempre sim para tamanhos razoáveis de arquivo; os conversores que cobram vendem recursos de volume ou de API de que você não precisa para um arquivo avulso.

A terceira é uma recomendação: em qual site posso confiar? A resposta honesta é que o site específico importa menos que a arquitetura. Um conversor client-side sem cadastro, que converte seu texto colado mesmo com a rede desligada, é confiável por construção: não há para onde seus dados irem.

Conversor de verdade ou página armadilha: o teste de 30 segundos

A expressão é popular o bastante para que páginas armadilha disputem por ela. Uma página armadilha parece um conversor e existe para colher cadastros, mostrar anúncios disfarçados de botões de download ou coletar os dados que você cola. Quatro sinais de alerta: um muro de cadastro antes de mostrar qualquer coisa, um grande botão "Download" que na verdade é um anúncio, nenhuma caixa de colagem para você ser obrigado a enviar um arquivo, e uma mensagem de erro que não diz nada quando seu JSON tem um problema.

O teste de 30 segundos corta tudo isso. Abra o conversor, desligue seu Wi-Fi, cole seu JSON e converta. Se funcionar com a rede desligada, a conversão está acontecendo no seu navegador: seus dados fisicamente não podem sair da sua máquina, porque não há conexão por onde viajem.

Execute esse teste no conversor desta página e ele passa. O caminho de colar, o caminho de enviar arquivo e a tabela de prévia funcionam todos offline; só o botão de buscar por URL precisa da rede, e só quando você clica nele. Faça o mesmo teste em qualquer outro conversor antes de colar algo sensível.

O que realmente acontece com seus dados

Então o que o conversor faz entre a sua colagem e o seu download? Ele achata o JSON. CSV não tem aninhamento, então o conversor puxa cada valor aninhado para o nível superior: objetos viram colunas com notação de ponto como customer.name, listas curtas viram uma única célula unida, e qualquer coisa com vírgula dentro recebe aspas para o CSV continuar válido.

Aqui está a saída exata do conversor desta página num registro com um objeto de cliente aninhado, uma lista de tags e uma observação contendo uma vírgula. Verificada byte por byte no motor real:

JSON de entrada (aninhado)

[{
  "id": "A-101",
  "customer": { "name": "Amelia", "city": "Austin" },
  "tags": ["new", "vip"],
  "note": "ships, fast"
}]

O que realmente acontece com seus dados (continuação)

E o CSV que ele produz:

CSV de saída (verificado contra o motor real)

id,customer.name,customer.city,tags,note
A-101,Amelia,Austin,new; vip,"ships, fast"

Leia da esquerda para a direita. O objeto de cliente virou duas colunas, customer.name e customer.city. A lista de tags virou uma célula, new; vip, unida com ponto e vírgula e espaço. A observação "ships, fast" está entre aspas porque contém uma vírgula; sem as aspas, uma planilha a dividiria em duas colunas. Valores nulos e listas vazias viram células vazias. Nada é inventado e nada é apagado, mas o formato muda: uma árvore vira uma tabela.

Esse passo de achatamento é todo o conteúdo técnico de "JSON to CSV". Todo o resto, os botões, as opções, o tratamento de arquivo, é embalagem ao redor disso. Se você quer a história completa da própria palavra achatamento, o guia de termos linkado abaixo cobre isso.

Guias relacionados

Perguntas frequentes

O que significa "JSON to CSV online" em termos simples?

Significa transformar dados JSON em um arquivo CSV de planilha usando um site em vez de um software instalado. Você cola seu JSON numa página web, a página converte e você baixa o CSV. O trabalho inteiro costuma levar menos de um minuto.

Um conversor online de JSON para CSV é o mesmo que fazer isso no Excel?

Não, e cada um é melhor em coisas diferentes. Um conversor online é o mais rápido para um arquivo avulso: cole, converta, baixe, pronto. O Excel, via Power Query, é melhor quando você repete a mesma conversão toda semana, porque dá para salvar os passos. Para um único arquivo, o caminho online dá menos trabalho.

Preciso instalar alguma coisa para converter JSON em CSV online?

Não. Esse é todo o sentido da palavra "online" na expressão. Uma aba do navegador e uma conexão com a internet bastam. Se um site que se diz um conversor online pede para você baixar e instalar um programa primeiro, isso é um produto diferente usando a expressão como fantasia.

É seguro colar meu JSON num conversor online?

Depende de onde a conversão acontece. Um conversor client-side faz o trabalho no seu navegador, então seus dados nunca saem da sua aba: verifique com o teste de 30 segundos, desligue o Wi-Fi e converta. Um conversor baseado em upload envia seu arquivo para um servidor, então trate como mandar os dados por e-mail para um desconhecido. Nunca cole senhas, chaves de API ou dados pessoais num conversor baseado em upload.

Por que um conversor online precisa achatar meu JSON?

Porque CSV não tem aninhamento. Uma célula CSV só pode conter texto, então qualquer coisa aninhada, objetos dentro de objetos, listas dentro de objetos, precisa ser reescrita antes de caber. O achatamento puxa os valores aninhados para o nível superior: objetos viram colunas com notação de ponto como customer.city, listas curtas viram uma única célula unida. Os valores não mudam, só o formato.

Qual a diferença entre uma ferramenta online e uma para baixar?

Uma ferramenta online roda no navegador sem nada para instalar, o que é ideal para uso ocasional. Uma ferramenta para baixar, como jq ou um script Python, roda na sua máquina, o que é melhor para arquivos muito grandes, pipelines automatizados e dados que você nunca quer perto de uma aba do navegador. A maioria das pessoas só precisa do tipo online.

Por que meu CSV abriu como uma coluna só quando abri no Excel?

Isso é uma incompatibilidade de delimitador, não um arquivo quebrado. O Excel divide as colunas usando o separador de lista do seu sistema, que é vírgula em algumas regiões e ponto e vírgula em outras. Se tudo cai numa coluna só, reimporte o arquivo e escolha o delimitador certo, ou regenere o CSV com a opção de ponto e vírgula ou tabulação que o conversor oferece.

Teste de verdade nesta aba

Cole o seu JSON e receba um CSV em menos de um minuto, com o achatamento e as aspas que este guia descreve. Grátis, sem cadastro, roda inteiramente no seu navegador.

Abrir o conversor de JSON para CSV

Todos os guias