Converter uma exportação JSON de contatos para CSV

Para converter uma exportação JSON de contatos para CSV, encontre o array que guarda os registros, grave uma linha por registro e achate os campos aninhados em colunas com caminho de pontos. O conversor de JSON para CSV faz as três coisas no seu navegador: escolhe o array mesmo quando ele está dentro de data ou results, une listas de tags em uma célula e dá colunas numeradas para listas de e-mails ou telefones. Depois, o CSV abre no Excel ou vai para um importador.

Fontes: RFC 8259 (o formato JSON) e jsonlines.org (JSON Lines), lidas em 3 de novembro de 2026.

Passo 1: encontre os registros

Um CSV é uma tabela; uma exportação JSON costuma ser um invólucro com a tabela dentro:

{ "results": [ { "email": "ana@example.com", "company": { "name": "Contoso" } } ],
  "paging": { "next": { "after": "100" } } }

As linhas estão em results. Outras APIs usam data, items, contacts ou members. O conversor pontua cada array de objetos do documento e escolhe o mais provável; se errar, escolha outro caminho na lista que ele mostra.

Passo 2: decida como campos aninhados viram colunas

JSON	Colunas do CSV
"company": {"name": "Contoso"}	company.name
"tags": ["vip", "trial"]	tags = vip; trial
"emails": [{"type": "work", "value": "..."}, ...]	emails.0.type, emails.0.value, emails.1.value...

Você define quantas colunas numeradas uma lista de objetos ganha; o que passar disso fica como texto JSON em uma coluna emails.more, para nada se perder. As colunas aparecem na ordem em que são vistas pela primeira vez, e um campo que só alguns registros têm fica em branco nos outros. Números e true/false são gravados como aparecem no JSON.

Passo 3: lide com paginação e JSON Lines

Uma API devolve uma página por vez, então uma exportação completa são vários arquivos. Converta cada um e junte com o CSV merge, ou cole os registros como JSON Lines, um objeto por linha, que o conversor lê direto.

Passo 4: ajuste o CSV para o destino

1. Corte colunas. Exportações de API trazem IDs, timestamps e campos internos de que um importador não precisa. Exclua, renomeie e reordene com o editor de colunas de CSV.
2. Mantenha os IDs intactos no Excel. IDs numéricos longos e códigos postais são arredondados ou perdem zeros com um clique duplo; veja abrir um CSV no Excel sem perder os zeros à esquerda.
3. Remova duplicados. Contatos puxados de vários endpoints ou páginas podem se repetir; remova e-mails duplicados.

Limites

Registros aninhados a mais de seis níveis de profundidade não são procurados automaticamente; nesse caso, escolha o caminho. O arquivo inteiro fica na memória do navegador durante a conversão, várias vezes o tamanho dele, então uma exportação muito grande pode ser mais fácil de converter em partes. O conversor não transforma CSV de volta em JSON. E ele converte dados; não checa se os endereços ainda recebem e-mail.

Onde o SimpleVerifier entra

Se você está puxando contatos de uma API para verificá-los, dá para pular o CSV e enviá-los à nossa API de verificação em massa; verificar um CSV em massa com a API mostra o fluxo. Para algo pontual, envie o CSV em /verify e receba os arquivos de válidos, arriscados e inválidos com suas colunas mantidas. As primeiras 100 checagens são grátis com login do Google. O Pro custa US$ 39 por mês: os primeiros 100.000 e-mails de cada mês rodam em velocidade máxima, e depois listas grandes rodam mais devagar, sem bloqueio. Chamadas de API são medidas à parte por plano; veja os preços.