Neste artigo
- O que mudou no OpenCNPJ desde a publicação deste guia?
- Como consultar um CNPJ com a API do OpenCNPJ?
- Consulta rápida via curl
- Exemplo de resposta
- Quais bases a API do OpenCNPJ entrega além da Receita?
- Qual é o limite da API do OpenCNPJ?
- OpenCNPJ ou BrasilAPI para consultar CNPJ?
- Como consultar CNPJ com Node.js?
- Como baixar a base completa de CNPJs?
- O OpenCNPJ é realmente gratuito?
- Preciso de chave ou token para usar a API?
- Com que frequência a base é atualizada?
- Posso fazer consultas em massa de vários CNPJs?
- Posso hospedar a base por conta própria?
- Existe suporte pago ou bibliotecas prontas?
Consultar CNPJ de graça e sem cadastro é possível com o OpenCNPJ, uma API pública que devolve os dados da Receita Federal em JSON com uma única requisição HTTP. Você não precisa de chave, token ou plano pago: basta chamar o endpoint com o número do CNPJ e ler a resposta.
O projeto é open source e mantido sem fins lucrativos, segundo a documentação oficial, e serve tanto para validar uma empresa durante um cadastro quanto para enriquecer bases de clientes. Quem nunca trabalhou com esse tipo de integração pode começar pelo guia que explica o que é uma API em linguagem simples.
O que mudou no OpenCNPJ desde a publicação deste guia?
O serviço cresceu e ganhou recursos novos desde setembro de 2025, quando este guia foi publicado. As mudanças abaixo foram confirmadas na documentação oficial e no endpoint de informações da própria API, consultado em 31 de outubro de 2026.
- CNPJ alfanumérico aceito: o endpoint recebe o novo formato com letras anunciado pela Receita Federal, como
12.ABC.345/01DE-35. O guia sobre o CNPJ alfanumérico para desenvolvedores explica o que isso muda nas integrações. - Filtro de datasets: além do cadastro da Receita, a API aceita o parâmetro
datasetspara trazer dados de bases como CEIS, CNEP, licitações, contratos, convênios e emendas parlamentares na mesma resposta. - BigQuery público: o projeto passou a manter tabelas públicas no BigQuery para consultas analíticas, filtros por CNAE e cruzamentos de milhões de registros sem transformar a análise em milhares de chamadas HTTP.
- Download por base: o arquivo único de download deu lugar a releases por dataset, em NDJSON e ZIP. A base da Receita tinha, segundo o endpoint oficial de informações, 73.797.761 registros com atualização de 14 de outubro de 2026.
Como consultar um CNPJ com a API do OpenCNPJ?
A consulta é uma requisição GET no endpoint https://api.opencnpj.org/ seguido do número do CNPJ. O endpoint aceita o CNPJ só com números, com pontuação completa e também no formato alfanumérico novo. A resposta vem em JSON, pronta para usar em aplicativos, automações e integrações.
GET https://api.opencnpj.org/00000000000191
Consulta rápida via curl
No terminal, duas linhas resolvem. O exemplo abaixo usa o CNPJ do Banco do Brasil, que é público e serve de teste clássico:
# só números
curl -s https://api.opencnpj.org/00000000000191 | jq
# com pontuação
curl -s "https://api.opencnpj.org/00.000.000/0001-91" | jq
Exemplo de resposta
A resposta abaixo foi encurtada, mas mantém os campos principais devolvidos pela API na data da atualização deste guia:
{
"cnpj": "00000000000191",
"razao_social": "BANCO DO BRASIL SA",
"nome_fantasia": "DIRECAO GERAL",
"situacao_cadastral": "Ativa",
"data_situacao_cadastral": "2005-11-03",
"matriz_filial": "Matriz",
"cnae_principal": "6422100",
"natureza_juridica": "Sociedade de Economia Mista",
"municipio": "BRASILIA",
"uf": "DF",
"capital_social": "120000000000,00",
"porte_empresa": "Demais",
"opcao_simples": "N",
"opcao_mei": "N"
}
A resposta completa inclui endereço, contatos, CNAEs secundários com descrição e qualificação do responsável. O contrato inteiro dos campos está publicado no endpoint https://api.opencnpj.org/schema, que devolve o schema JSON oficial da resposta.
Quais bases a API do OpenCNPJ entrega além da Receita?
O parâmetro datasets escolhe uma ou mais bases na mesma consulta, separadas por vírgula. Segundo a documentação oficial, são aceitos os datasets receita, cno, rntrc, favorecidos_pj, ceis, cepim, cnep, acordos_leniencia, licitacoes, contratos, renuncias_fiscais, notas_fiscais, convenios, emendas_parlamentares e emendas_documentos. Sem filtro, o retorno padrão é o da Receita Federal.
GET https://api.opencnpj.org/00000000000191?datasets=receita,ceis,cnep
Esse recurso muda o tipo de sistema que dá para construir: além de validar cadastro, dá para cruzar a situação cadastral com sanções, contratos públicos e emendas na mesma chamada. Quem quiser inspiração para transformar dados públicos em produto encontra um exemplo real no artigo sobre APIs de dados públicos brasileiros.
Qual é o limite da API do OpenCNPJ?
Hoje não existe cota fixa de consultas por dia ou por mês. A documentação oficial de limites explica que o endpoint não exige chave, cadastro ou plano pago, e que picos temporários, inclusive acima de 100 requisições por segundo, são aceitos quando o padrão de uso continua sendo consulta pontual por CNPJ. A proteção entra quando uma origem mantém volume muito alto de forma contínua: nesses casos a API responde com código 429 até o tráfego normalizar.
⚠️ Atenção: a regra prática documentada pelo projeto é separar consulta pontual de varredura. Para descobrir empresas, montar listas ou gerar estatísticas, a orientação oficial é usar o BigQuery público ou baixar os datasets, e não repetir chamadas HTTP em massa.
OpenCNPJ ou BrasilAPI para consultar CNPJ?
As duas são gratuitas, comunitárias e sem autenticação, e as duas servem para consultar CNPJ. A BrasilAPI se descreve como um projeto experimental que centraliza endpoints modernos com baixa latência, e seu endpoint de CNPJ devolve dados cadastrais com o quadro de sócios. O OpenCNPJ mantém base própria atualizada por release e entrega módulos extras por dataset, além de tabelas analíticas no BigQuery. A tabela abaixo resume os dois caminhos:
| Critério | OpenCNPJ | BrasilAPI |
|---|---|---|
| Gratuidade | Gratuita, sem plano pago | Gratuita |
| Autenticação | Sem chave ou token | Sem chave ou token |
| Dados de CNPJ | Receita + datasets extras (CEIS, CNEP, licitações, contratos e outros) | Dados cadastrais com quadro de sócios |
| Uso analítico | BigQuery público e downloads NDJSON por base | Foco em consulta pontual por endpoint |
Para validação em formulário e enriquecimento de cadastro, qualquer um dos dois resolve. Para análise em volume, o caminho do OpenCNPJ é mais direto porque existe o BigQuery público e o download dos datasets.
Como consultar CNPJ com Node.js?
Em Node.js, uma função com fetch já basta, sem instalar dependência nenhuma. O exemplo abaixo trata os dois erros previstos no contrato da API: CNPJ não encontrado devolve 404, e abuso de volume devolve 429.
async function consultarCnpj(cnpj) {
const res = await fetch(`https://api.opencnpj.org/${cnpj}`);
if (res.status === 404) {
throw new Error('CNPJ não encontrado');
}
if (res.status === 429) {
throw new Error('Muitas requisições, tente novamente em instantes');
}
if (!res.ok) {
throw new Error(`Erro na consulta: ${res.status}`);
}
return res.json();
}
const empresa = await consultarCnpj('00000000000191');
console.log(empresa.razao_social, empresa.situacao_cadastral);
Em produção, vale guardar a resposta em cache quando a mesma empresa é consultada com frequência, porque os dados só mudam quando a base é republicada. Quem prefere Python pode ver como estruturar uma integração parecida no tutorial de FastAPI para criar uma API em minutos.
Como baixar a base completa de CNPJs?
Quem precisa processar a base inteira na própria infraestrutura tem dois caminhos documentados. O primeiro é o download por dataset: a base da Receita está disponível em ZIP no endereço oficial file.opencnpj.org/releases/receita/data.zip, que no endpoint de informações do dia 31 de outubro de 2026 apontava cerca de 14,4 GB compactados para 73,8 milhões de registros. O segundo caminho é o BigQuery público, indicado para filtros, agregações e cruzamentos sem baixar nada.
Para conferir se saiu release nova, o endpoint https://api.opencnpj.org/info devolve a data de atualização de cada dataset. A base acompanha a publicação mensal de dados abertos da Receita Federal, então conferir esse endpoint é mais confiável do que decorar calendário.
Perguntas frequentes
O OpenCNPJ é realmente gratuito?
Sim. A documentação oficial afirma que todos os serviços são gratuitos, inclusive para uso comercial, e que não existe plano pago para aumentar limite. O projeto é mantido sem fins lucrativos e aceita doações para sustentar a infraestrutura.
Preciso de chave ou token para usar a API?
Não. O endpoint é aberto, sem cadastro e sem autenticação. Basta fazer a requisição com o CNPJ que a resposta chega em JSON.
Com que frequência a base é atualizada?
A base da Receita é republicada conforme a publicação mensal de dados abertos da Receita Federal. A data mais recente de cada dataset aparece no endpoint https://api.opencnpj.org/info. Na atualização deste guia, em 31 de outubro de 2026, a base da Receita apontava atualização de 14 de outubro de 2026.
Posso fazer consultas em massa de vários CNPJs?
Consulta pontual por CNPJ aceita picos, inclusive acima de 100 requisições por segundo, segundo a documentação. Volume contínuo alto pode receber erro 429. Para varrer segmentos ou enriquecer listas grandes, a orientação oficial é usar o BigQuery público ou baixar os datasets.
Posso hospedar a base por conta própria?
Sim. Os downloads por dataset, em NDJSON e ZIP, servem exatamente para isso: carregar a base na sua infraestrutura com controle total de processamento e cache.
Existe suporte pago ou bibliotecas prontas?
Não existe suporte dedicado. O projeto é aberto e comunitário, com documentação oficial e uma página de bibliotecas mantidas pela comunidade para diferentes linguagens. Em caso de dúvida sobre integração, o schema público da resposta é o contrato de referência.
Se você usa dados da Receita Federal no seu sistema, vale acompanhar também as notícias sobre o CNPJ alfanumérico da Receita Federal, porque a transição de formato afeta validações, máscaras e bancos de dados de qualquer integração com CNPJ.