CNPJAPI

Exportar lista de empresas para Excel ou CSV

Depois de montar um segmento na CNPJAPI, você exporta a lista de empresas em Excel (XLSX) ou CSV para trabalhar na sua planilha, no seu CRM ou no seu BI. A exportação é um recurso self-service do portal, a partir dos dados oficiais da Receita Federal.

Visão geral do recurso: Listas de empresas segmentadas.

Passo a passo

  1. No portal (https://app.cnpjapi.com.br), monte o segmento em Segmentação (/busca/segmentacao) e clique em Segmentar para ver o preview (quantas empresas e a distribuição). Como montar: lista por CNAE e lista por cidade e estado.
  2. Clique em Exportar. Escolha:
    • Formato: XLSX (Excel) ou CSV.
    • Escopo: todo o segmento (até o limite de linhas por arquivo do seu plano) ou até um número de linhas que você definir (útil para uma amostra).
  3. Confira o resumo de cobrança antes de gerar: quantas linhas o arquivo terá, quanto sai da franquia do plano e quanto de crédito, se for o caso. Nada é truncado escondido.
  4. Confirme. A geração é assíncrona: acompanhe o andamento em Exportações (/busca/exportacoes).
  5. Quando ficar pronta, você recebe um aviso; baixe o arquivo (disponível por 7 dias). Baixar de novo dentro do prazo não cobra outra vez.

O que vem no arquivo

Uma linha por empresa, com cabeçalho, trazendo os campos do registro oficial: CNPJ, razão social, nome fantasia, situação cadastral, CNAE, natureza jurídica, porte, endereço completo, telefone e e-mail (quando constam) e a marcação de Simples/MEI. Os códigos vêm com a descrição.

XLSX ou CSV: qual escolher

  • XLSX (Excel): abre direto no Excel/LibreOffice, com os valores já formatados como texto (preserva zeros à esquerda de CEP e códigos). Melhor para trabalho manual em planilha.
  • CSV: formato universal, ideal para importar em CRM, banco de dados ou ferramenta de BI. Ao abrir no Excel, importe como texto para não perder zeros à esquerda.

Cobrança e cota

A exportação é cobrada por linha: uma franquia mensal inclusa no plano (Avançado 10.000/mês, Business 50.000/mês) mais créditos avulsos para volume adicional, sem expiração. O preview não é cobrado por linha - a cobrança fica só na extração. Você acompanha franquia, consumo e saldo de créditos no portal.

Cada arquivo vai até o teto por plano (50.000 linhas no Avançado, 100.000 no Business); um segmento maior que o teto é gerado até esse limite, então divida em recortes menores (por UF, cidade ou CNAE) para levar todos. Como o teto por arquivo pode ser maior que a franquia mensal, um arquivo grande pode consumir créditos além da franquia - o portal mostra a conta antes de gerar.

Dicas

  • Calibre no preview antes de exportar: como a cobrança é por linha, feche os filtros primeiro.
  • Amostra rápida: use o escopo "até N linhas" para conferir o formato antes de puxar o segmento inteiro.
  • Reimportou e sumiram zeros à esquerda? Importe a coluna como texto (CEP, códigos e CNPJ têm zeros significativos).

Uso responsável

O cadastro de empresas é público, mas o uso da lista é sua responsabilidade: ao usar contatos, respeite a LGPD e as regras de comunicação. Os contatos são os do registro oficial (podem faltar ou estar desatualizados), não um mailing validado. Veja a nota em Listas de empresas segmentadas.