Guias de integração

Guias práticos, orientados a tarefa, para consultar CNPJ pela API da CNPJAPI na sua linguagem. Cada guia mostra uma chamada real ao endpoint GET https://api.cnpjapi.com.br/{cnpj}, a autenticação por API key e como ler a resposta em JSON.

Para a referência completa (campos, limites, erros), veja a documentação da API.

Escolha a sua linguagem

Python - com a biblioteca requests.
Node.js - com fetch nativo.
C# / .NET - com HttpClient.
PHP - com cURL.
Go - com net/http.
Java - com java.net.http.HttpClient.

Muitos CNPJs?

Consultar em lote - até 20 CNPJs numa única chamada (plano pago). Sem plano pago, o padrão é uma chamada por CNPJ, respeitando o rate limit.

CNPJ alfanumérico

CNPJ alfanumérico: validar o dígito verificador e consultar pela API - o formato com letras que a Receita emite desde 31/07/2026: cálculo do dígito com código pronto, expressão regular, banco de dados e consulta pela API.

Sem programar (no-code)

Visão geral e "qual escolher": Consultar CNPJ sem programar.

Na planilha:

Consultar CNPJ no Excel - pelo Power Query, enriquecendo uma coluna inteira de CNPJs. Só Excel para Windows.
Consultar CNPJ no Google Sheets - com uma função =CNPJ() via Apps Script, em qualquer sistema.

Em ferramentas de automação (enriquecer leads/linhas automaticamente):

Consultar CNPJ no Make (Integromat) - com o módulo HTTP, num cenário sem código.
Consultar CNPJ no Power Automate - com a ação HTTP + Parse JSON, no ecossistema Microsoft.

Em apps feitos com IA:

Consultar CNPJ no Lovable - com um prompt pronto e uma função no servidor do app que guarda a API key em segredo.

Gerar listas de empresas (segmentação)

O caminho inverso da consulta: em vez de partir de um CNPJ, você parte de critérios e obtém a lista de empresas. É um recurso self-service do portal (não a API). Veja a visão geral em Listas de empresas segmentadas.

Lista de empresas por CNAE - monte o segmento por ramo de atividade e exporte em Excel ou CSV.
Lista de empresas por cidade e estado - filtre por UF e município para recortes regionais.
Lista de empresas por raio ou área no mapa - empresas perto de um CEP (raio) ou dentro de uma área desenhada no mapa.
Acompanhar empresas novas por cidade e segmento - alerta mensal quando abrir empresa nova do seu CNAE nas cidades que você atende.
Exportar lista para Excel ou CSV - formato, escopo, cobrança por linha e download.

Além da consulta de CNPJ

Migrar da ReceitaWS - já usa a ReceitaWS? Troque só o host; a resposta vem no mesmo formato, campo a campo.
Consultar Inscrição Estadual (IE) - a IE de um CNPJ na fonte oficial da SEFAZ, por UF ou varredura nacional.
Consultar a dívida ativa da União de um CNPJ - se a empresa constava em cobrança na base trimestral da PGFN, com o mês da extração, em toda consulta nos planos pagos.
Consultar parcelamentos de um CNPJ com a Receita Federal - se a empresa tinha parcelamento ativo na base mensal da Receita, por tipo e com o saldo, com a data da publicação, em toda consulta nos planos pagos.
Verificar sanções e embargos de um CNPJ - CEIS, CNEP, CEPIM, acordos de leniência e embargos do IBAMA em toda consulta, nos planos pagos.
Rejeição 181 e 182 na NF-e: validar o cadastro do destinatário - a partir de 16/11/2026, a SEFAZ rejeita a NF-e quando o CNPJ do destinatário não está com situação Ativa na Receita. Como conferir antes de emitir.
Rejeição 180 na NF-e: conferir o regime tributário (CRT) do emitente - a partir de 16/11/2026, a SEFAZ rejeita a nota quando o CRT não bate com o regime do CNPJ do emitente na Receita (MEI desenquadrado, empresa excluída do Simples). Qual CRT usar e como conferir.

Código no GitHub

Os exemplos completos e rodáveis de todas as linguagens ficam no repositório oficial: https://github.com/guidi-sistemas/cnpjapi-examples.

Antes de começar

Você vai precisar de uma API key. Crie sua conta gratuita em https://app.cnpjapi.com.br, gere a chave e envie-a no cabeçalho Authorization: Bearer de cada requisição (veja Autenticação).