Converter JSON para CSV — fechando a lacuna dolorosa entre API e Excel
APIs falam JSON, a contabilidade fala Excel. Qualquer pessoa que canalize regularmente dados do Stripe, PayPal, Firebase, MongoDB ou de um REST interno para um relatório de Excel conhece a dor: a resposta tem três níveis de profundidade, contém arrays de subobjetos e alguns campos opcionais que aparecem e somem. Os conversores online padrão falham exatamente nesses três pontos — nós resolvemos os três.
Achatamento real de aninhados — não só chaves de nível superior
Uma resposta típica de cobrança do Stripe tem: id, amount, currency, customer.id, customer.name, customer.address.city, customer.address.postal_code, payment_method_details.card.brand, payment_method_details.card.last4, balance_transaction.fee_details[0].amount, …. Conversores ingênuos gravam só os campos de nível superior. Nós percorremos a árvore inteira recursivamente e produzimos uma coluna para cada caminho folha. O usuário de Excel pode filtrar por cidade, agrupar por bandeira do cartão — direto em uma tabela dinâmica.
Três estratégias para os arrays dentro dos registros
Arrays são complicados: um pedido pode ter 1, 5 ou 20 itens. Três estratégias sensatas: (a) array como string JSON em uma coluna — compacto, preserva a estrutura, visível como texto no Excel. (b) Expandido por índice — items.0.qty, items.0.price, items.1.qty, … — útil quando todos os arrays têm tamanho parecido. (c) Unidos por barra vertical para arrays de strings puras — tags "vermelho|verde|azul" em uma célula. Escolha por exportação.
Entrada NDJSON detectada automaticamente
NDJSON (Newline-Delimited JSON) é o formato padrão para logs, exportações do BigQuery, saída do mongoexport e resultados batch de LLM. Em vez de um array envolvente, um objeto JSON por linha. Detectamos o formato pelo primeiro caractere (chave em vez de colchete) e interpretamos de acordo. Mais eficiente em memória que um array gigante — e, para conjuntos de milhões de registros, a única opção viável no navegador.
União de chaves em vez de suposições de esquema
O JSON do mundo real raramente é consistente com um esquema: campos opcionais que são omitidos, campos novos que aparecem, outros que somem. Escaneamos todos os registros e construímos a união de todos os caminhos. Colunas são criadas para cada campo que já apareceu, valores ausentes são gravados como células vazias. Os relatórios do Excel não quebram só porque o registro 47 de repente tem um campo refund_reason.
UTF-8 com ou sem BOM — conforme a versão do Excel
Se o CSV vai ser aberto no Excel com clique duplo, um BOM UTF-8 no início do arquivo ajuda a renderizar corretamente os acentos em nomes e endereços. Para ferramentas web modernas, Google Planilhas ou importações em banco de dados, omita o BOM — é o padrão limpo hoje. Uma caixinha de seleção, fim da frustração com os cabeçalhos.
LGPD e privacidade
Respostas de API costumam conter dados pessoais — clientes do Stripe, usuários do Firebase, pedidos do MongoDB. Passá-las por um conversor de nuvem estrangeiro é juridicamente arriscado (LGPD, possível transferência internacional). O BrowserCrunch processa tudo no seu navegador. Extra: funciona offline depois que a página carrega.
Ferramentas CSV relacionadas no BrowserCrunch
Sentido inverso? Nosso conversor CSV para JSON com detecção de tipos e saída NDJSON. Para fluxos de escritório: Excel para CSV e CSV para Excel. Para relatórios: CSV como tabela PDF.