Consulta CNPJ em lote via API, com os dados abertos da Receita Federal

A Receita Federal publica a base do CNPJ como dados abertos, mas em arquivos de vários gigabytes. Para consultar CNPJs um a um ou em lote, o caminho prático é uma API aberta construída sobre esses arquivos. Este guia usa a Minha Receita (código aberto, sem cadastro) e mostra os cuidados com a LGPD. Exemplos testados em 3 de novembro de 2026.

1. Consultar um CNPJ

curl -s https://minhareceita.org/33000167000101

A resposta veio em 0,25 s, com 48 campos: razão social (PETROLEO BRASILEIRO S A PETROBRAS), situação cadastral, data de abertura, natureza jurídica, porte, capital social, CNAE principal (600001, extração de petróleo e gás natural), CNAEs secundários, endereço e opção pelo Simples.

Um CNPJ que não existe devolve 404 com {"message": "CNPJ 00.000.000/0000-00 não encontrado."}.

2. Em lote

A API recebe um CNPJ por chamada. Para uma lista:

import httpx, time, re
cnpjs = ["00.000.000/0001-91", "33.000.167/0001-01"]
for c in cnpjs:
    n = re.sub(r"\D", "", c)
    r = httpx.get(f"https://minhareceita.org/{n}", timeout=30)
    print(n, r.status_code, r.json().get("razao_social") if r.status_code == 200 else "")
    time.sleep(1)  # serviço comunitário, sem SLA: seja gentil

Valide o dígito verificador antes de chamar a API, porque poupa chamadas inúteis.

3. LGPD: o que não republicar

• QSA (sócios e administradores): a resposta inclui o campo qsa, com nomes de pessoas físicas. São dados pessoais. Se não precisa deles, descarte-os.
• MEI e empresário individual: a razão social costuma ser o nome e o CPF do titular. Trate esses registros como dados pessoais.

4. Limites e alternativas

• A Minha Receita informa que não recusa consultas por limite de uso, mas não tem SLA. O autor recomenda rodar um servidor próprio para volumes grandes.
• A BrasilAPI também oferece consulta de CNPJ, mas o robots.txt dela proíbe /api/ para robôs.
• Os arquivos completos da Receita Federal servem para quem precisa da base inteira, com processamento próprio.

5. Sem código

O Brazil CNPJ Company Lookup (Receita Federal) na Apify consulta listas de CNPJs com estas mesmas fontes abertas e valida o dígito antes de cada chamada. Ele remove sócios e MEI e não cobra pelos registros descartados. Exporta para CSV, Excel ou JSON. Você paga por empresa retornada.

Consultar CNPJs em lote (CSV / API) →

Perguntas frequentes

É legal consultar e usar esses dados? A base do CNPJ é publicada pela Receita Federal como dados abertos. A responsabilidade sobre o uso é de quem usa: respeite a LGPD, sobretudo quanto a sócios e MEI.

Qual a frequência de atualização? A Receita Federal atualiza os arquivos abertos mensalmente. As APIs abertas acompanham essa frequência.

Fontes: Receita Federal (dados abertos do CNPJ), Minha Receita. Exemplos testados em 2026-11-03.