apipj
Entrar Criar chave grátis

Guias · Por apipj (MASTER BI TECNOLOGIA LTDA) · atualizado em · 9 min de leitura

Consulta de CNPJ em lote: cole a lista e baixe a planilha

Tem uma planilha de clientes, fornecedores ou leads só com o CNPJ e precisa da razão social, da situação cadastral, do CNAE e do endereço de cada empresa? Cole a lista abaixo, ou envie o arquivo .csv ou .txt, e baixe um CSV que abre direto no Excel. Os números são conferidos no seu navegador antes de qualquer consulta: inválidos e repetidos saem da fila e não gastam cota. Os válidos são consultados na API de CNPJ do apipj, um a um, dentro do limite por minuto e da cota mensal do seu plano. A conta é grátis e não pede cartão.

A ferramenta precisa de JavaScript ativado no navegador.

Um por linha, ou separados por vírgula ou ponto e vírgula, com ou sem pontuação.
O arquivo é lido no seu navegador, sem envio. Numa planilha, a coluna de CNPJ é encontrada sozinha.
2. Escolha as colunas do arquivo

Prefiro criar conta com e-mail

Já tem conta? Entrar e voltar para cá.

Como funciona

  1. Cole ou envie a lista. Um CNPJ por linha, ou separados por vírgula ou ponto e vírgula, com ou sem pontuação, numéricos ou alfanuméricos. Num arquivo .csv ou .txt, a ferramenta usa a coluna que tem "CNPJ" no cabeçalho ou, sem cabeçalho, a coluna com mais CNPJs válidos. O arquivo é lido no navegador e não é enviado a lugar nenhum.
  2. Validação antes de consultar. Cada número passa pelo cálculo do dígito verificador, o mesmo do validador de CNPJ. O mesmo CNPJ escrito duas vezes, com e sem máscara, conta uma vez só. CNPJ numérico que perdeu os zeros à esquerda numa planilha (11 a 13 dígitos) é completado com zeros, se o dígito verificador conferir. A página mostra quantos são válidos, inválidos e repetidos.
  3. Consulta com a sua conta. Logado, a página consulta os válidos com a sua sessão, no ritmo do seu plano: uma consulta a cada 60 segundos divididos pelo limite por minuto (6 segundos no Gratuito, que faz 10 por minuto; 2 no Dev; 0,3 no Pro). A barra mostra o progresso e o tempo que falta; dá para pausar, retomar e cancelar. Se a API pedir para esperar, a ferramenta espera o tempo indicado e continua.
  4. Baixe a planilha. Marque as colunas que quer, confira a prévia e baixe o CSV. O botão funciona também no meio da consulta: o que ainda não foi consultado sai como "não consultado".

Quanto tempo leva

A ferramenta nunca passa do limite por minuto do seu plano, então o tempo é a quantidade de CNPJs válidos dividida por esse limite. Os limites são os da página de preços:

CNPJs na listaGratuito (10 por minuto)Dev (30 por minuto)Pro (200 por minuto)
100cerca de 10 mincerca de 3 min 20 scerca de 30 s
1.000cerca de 1 h 40 mincerca de 33 mincerca de 5 min
10.000cerca de 16 h 40 mincerca de 5 h 33 mincerca de 50 min
50.000cerca de 3 dias e 11 hcerca de 1 dia e 4 hcerca de 4 h 10 min

Para uma lista de 1.000 clientes, a diferença entre os planos é de 1 h 40 min no Gratuito para 33 min no Dev e 5 min no Pro. Se a sua lista é grande, assine direto pelo painel: Dev, R$ 12,90 por mês ou Pro, R$ 59,90 por mês. A comparação completa está em preços.

Deixe a aba aberta até o fim: a consulta roda na página. Se o sandbox ou outra aba consultarem com a mesma conta ao mesmo tempo, as duas dividem o limite por minuto da conta, e a ferramenta espera quando a API pede. As chaves de API têm limite por minuto próprio, mas a cota mensal é uma só por conta.

Enriquecer uma lista de clientes ou leads

Cada CNPJ encontrado vira uma linha do CSV com as colunas que você marcar:

  • Identificação: CNPJ com máscara, razão social, nome fantasia, natureza jurídica (código e descrição) e porte (micro empresa, empresa de pequeno porte ou demais).
  • Situação cadastral: ativa, baixada, inapta, suspensa ou nula, com a data da situação.
  • Atividade: CNAE principal, com código e descrição.
  • Endereço: logradouro, número, complemento, bairro, CEP, município, UF e o código IBGE do município, útil para nota fiscal e para cruzar com dados do IBGE.
  • Contato declarado à Receita: telefone e e-mail, quando a empresa informou. Muitas vezes são os do escritório de contabilidade.
  • Regime: se é optante do Simples Nacional e se é MEI.

A coluna resultado diz o que aconteceu em cada linha: encontrado, não encontrado (o CNPJ é válido, mas não está na carga do mês), inválido, erro na consulta ou não consultado. O CSV não traz o quadro de sócios nem os CNAEs secundários; esses campos vêm na resposta da API, uma empresa por vez.

Para quem é

  • Financeiro e contas a receber: conferir se os clientes da carteira continuam ativos antes de faturar ou renegociar e separar os baixados e inaptos.
  • Compras e cadastro de fornecedores: checar situação, CNAE e Simples de uma lista de fornecedores antes de homologar. O guia validar fornecedor pelo CNPJ traz o checklist.
  • Vendas e pré-vendas: completar uma lista de leads que só tem o CNPJ com razão social, cidade, UF, porte e atividade, para segmentar a prospecção.
  • CRM e cadastro de clientes: atualizar o cadastro de clientes pelo CNPJ (razão social, endereço, situação) e importar o CSV de volta no CRM, casando as linhas pela coluna cnpj.

O arquivo CSV

  • Abre direto no Excel em português: UTF-8 com BOM e ponto e vírgula como separador, então os acentos aparecem certos e cada campo cai na sua coluna. No Google Planilhas, use Arquivo > Importar e escolha ponto e vírgula como separador. Se a lista já mora numa planilha, a função =CNPJ() no Google Planilhas preenche as colunas sem sair dela.
  • Zeros à esquerda preservados: CNPJ e CEP saem com máscara, o CNAE no formato 0000-0/00 e a natureza jurídica no formato 000-0, que o Excel trata como texto.
  • Datas em DD/MM/AAAA; Simples e MEI em Sim ou Não.
  • Mesma ordem da sua lista, sem repetidos; os inválidos vêm no fim, com o texto como estava.
  • Só CSV. Para ter um .xlsx, abra o CSV no Excel e salve como pasta de trabalho.

Limites

  • Dados mensais, não em tempo real. A base é a carga dos dados abertos que a Receita Federal publica todo mês; a atual é de 09/2026. A resposta não tem valor de certidão, e uma empresa aberta ou alterada depois da carga só aparece na seguinte.
  • Só a sua lista, dentro da sua cota. A ferramenta consulta os CNPJs que você trouxe, um a um, e cada consulta conta na cota mensal do seu plano: 50.000 no Gratuito, 200.000 no Dev e 600.000 no Pro. Não é download nem exportação da base, e não busca empresas por atividade, cidade ou qualquer outro filtro.
  • Não encontrado também conta. CNPJ válido que não está na carga gasta uma consulta, porque a API precisa procurar. Inválidos e repetidos não gastam: saem antes, no navegador.
  • Cota esgotada no meio da lista: a consulta para, o que já veio continua no CSV e os que faltaram saem como "não consultado". Depois de mudar de plano, o botão "Continuar" retoma de onde parou.
  • Até 50.000 CNPJs válidos por vez. Para mais, divida a lista ou use a API com uma chave num script.
  • A aba precisa ficar aberta. Fechar ou recarregar a página interrompe a consulta e descarta o que não foi baixado. Em listas longas, prefira deixar a aba visível: navegadores podem desacelerar páginas em segundo plano.
  • O que sai do seu computador: só os CNPJs válidos, enviados à API do apipj. As outras colunas do arquivo (nomes, valores, contatos) não saem do navegador.

Para automatizar

Para atualizar a carteira todo mês sem abrir o navegador, use a API com uma chave de API num script. Os guias de Python, JavaScript e PHP mostram a consulta com tratamento de erros e de limite, e o guia de fornecedores traz a reconsulta mensal da carteira.

Perguntas frequentes

Preciso de conta para consultar CNPJ em lote?

Sim. A leitura da lista e a contagem de válidos, inválidos e repetidos funcionam sem conta, mas a consulta dos dados exige uma conta grátis, sem cartão: 10 consultas por minuto e 50.000 por mês.

Quantos CNPJs posso consultar de uma vez?

Até 50.000 CNPJs válidos por lote, desde que caibam no que resta da cota mensal do seu plano. O tempo depende do limite por minuto: 100 CNPJs levam cerca de 10 min no Gratuito, 3 min 20 s no Dev e 30 s no Pro.

CNPJ inválido ou repetido gasta consulta?

Não. Eles são separados no navegador e nunca chegam à API. Gasta consulta cada CNPJ válido enviado, encontrado ou não.

A minha planilha é enviada para algum servidor?

Não. O arquivo é lido pelo navegador. Só os CNPJs válidos vão para a API, um por consulta; nomes, valores e outras colunas ficam no seu computador.

Dá para baixar em Excel (XLSX)?

O arquivo é CSV, que o Excel em português abre com duplo clique, com acentos e colunas certos. Para ter um .xlsx, salve como pasta de trabalho no próprio Excel.

Posso consultar os sócios em lote?

O CSV desta página não traz sócios. O quadro de sócios vem na resposta da API de CNPJ, consulta a consulta; para testar no navegador, use o sandbox.