CNPJ & Company Data Brazil — Consulta e Descoberta por CNAE/UF

Consulte dados públicos de empresas brasileiras pelo CNPJ em lote ou descubra empresas por CNAE/estado — direto do registro público da Receita Federal, sem login e sem chave de API.

Um actor, dois modos:

• Lookup (consulta em lote): você envia uma lista de CNPJs → recebe o registro completo de cada empresa (razão social, sócios/QSA, CNAE, endereço, situação, capital…).
• Discovery (descoberta por filtro): você envia um filtro (CNAE + UF/município) → recebe a lista de empresas que batem, paginada.

Casos de uso

• Prospecção B2B: descubra todas as empresas de um setor num estado (por CNAE + UF) — sem comprar listas de leads prontas.
• KYC / compliance: verifique um CNPJ contra o registro oficial e capture o quadro societário (QSA) para triagem.
• Enriquecimento de leads: transforme uma lista/CSV de CNPJs em perfis de empresa estruturados.
• Pesquisa de mercado por setor: mapeie a densidade de empresas de um CNAE por região.

Qual modo usar?

Você tem…	Você quer…	Use o modo
Uma lista de CNPJs	os dados completos de cada um	Lookup
Um setor (CNAE) + região	encontrar as empresas que existem ali	Discovery

Inputs

Campo	Modo	Descrição	Exemplo
mode	ambos	"lookup" ou "discovery" (obrigatório)	"lookup"
cnpjs	lookup	Lista de CNPJs (qualquer formato)	["47.960.950/0001-21", "19131243000197"]
cnpjInput	lookup	Cole um CSV/texto com CNPJs — todos são extraídos, validados e deduplicados	"razao,cnpj\nMagalu,47960950000121"
cnae	discovery	CNAE (subclasse) a buscar — obrigatório na descoberta	"4713004"
uf	discovery	Estado (2 letras) — opcional	"SP"
municipio	discovery	Código IBGE do município — opcional	"3516200"
situacao	discovery	Mantém só empresas nessa situação — opcional	"ATIVA"
maxResults	discovery	Limite de empresas retornadas (controla volume/custo)	1000

Exemplo — Lookup: { "mode": "lookup", "cnpjs": ["47960950000121", "00000000000191"] } Exemplo — Discovery: { "mode": "discovery", "cnae": "4713004", "uf": "SP", "situacao": "ATIVA", "maxResults": 1000 }

Output

Um registro por empresa. Exemplo real (Magazine Luiza, 47960950000121 — sócios e CNAEs secundários truncados aqui; o registro real traz os 5 sócios e 35 CNAEs secundários):

{
  "cnpj": "47960950000121",
  "razaoSocial": "MAGAZINE LUIZA S/A",
  "nomeFantasia": "MAGAZINE LUIZA",
  "situacaoCadastral": "ATIVA",
  "dataSituacao": "2005-11-03",
  "cnaePrincipal": "4713004",
  "cnaeDescricao": "Lojas de departamentos ou magazines, exceto lojas francas (Duty free)",
  "cnaesSecundarios": [
    { "codigo": "3329501", "descricao": "Serviços de montagem de móveis de qualquer material" }
  ],
  "naturezaJuridica": "Sociedade Anônima Aberta",
  "capitalSocial": 14202162000,
  "porte": "DEMAIS",
  "opcaoSimples": null,
  "opcaoMei": null,
  "endereco": {
    "logradouro": "VOLUNTARIOS DA FRANCA",
    "numero": "1465",
    "bairro": "CENTRO",
    "municipio": "FRANCA",
    "uf": "SP",
    "cep": "14400490"
  },
  "telefones": ["1637112002"],
  "email": null,
  "socios": [
    { "nome": "ANDRE LUIZ DE SOUZA FATALA", "qualificacao": "Diretor", "faixaEtaria": "Entre 41 a 50 anos", "cpfMascarado": "***571038**", "dataEntrada": "2019-09-11" }
  ],
  "dataAbertura": "1966-10-24",
  "source": "minhareceita",
  "scrapedAt": "2026-07-08T01:51:20.810Z"
}

Campo	Descrição
cnpj	CNPJ (14 dígitos).
razaoSocial / nomeFantasia	Razão social / nome fantasia.
situacaoCadastral / dataSituacao	Situação (ATIVA, BAIXADA, INAPTA, SUSPENSA) e sua data.
cnaePrincipal / cnaeDescricao	CNAE principal (7 dígitos) e descrição.
cnaesSecundarios	Lista de CNAEs secundários (codigo, descricao).
naturezaJuridica / capitalSocial / porte	Natureza jurídica, capital social (número), porte.
opcaoSimples / opcaoMei	Opção pelo Simples / MEI (true/false/null quando a fonte não informa).
endereco	logradouro, numero, bairro, municipio, uf, cep.
telefones / email	Contatos, quando constam no registro.
socios	Quadro societário (QSA): nome, qualificacao, faixaEtaria, cpfMascarado (a Receita já mascara o CPF), dataEntrada.
dataAbertura	Data de início de atividade.
source	Qual fonte respondeu (minhareceita, brasilapi ou cnpjws).
scrapedAt	Timestamp ISO da coleta.

Campo ausente = null, nunca estimado.

Custo

Cobrado por registro retornado (Pay Per Event). Exemplo: a US$ 1,50 por 1.000 registros, 1.000 empresas custam cerca de US$ 1,50 e 100 empresas cerca de US$ 0,15. (Veja o preço atual na página do Store.)

Confiabilidade

O actor consulta as fontes públicas com fallback em cadeia (minhareceita → BrasilAPI → CNPJ.ws): se uma fonte estiver fora, tenta a próxima, e registra em source qual respondeu. O ritmo (pacing) respeita os limites de cada fonte para evitar bloqueios.

Diferença importante: um CNPJ que não existe (resposta 404 legítima) é reportado como tal e não é confundido com "fonte fora do ar" — se muitos CNPJs falharem em todas as fontes, o run emite um qualityAlert (indica indisponibilidade das fontes, não que as empresas não existem; basta reexecutar).

Limitações (honestas)

• Dados públicos da Receita Federal, atualizados mensalmente — não é tempo real; mudanças recentes podem não aparecer até a próxima atualização do registro.
• Dependência de fontes públicas gratuitas (minhareceita/BrasilAPI/CNPJ.ws): se todas estiverem fora no momento, o run avisa (qualityAlert) — reexecute.
• Fora do escopo desta versão: Simples Nacional detalhado, dívida ativa, processos judiciais e histórico societário (exigem fontes restritas).
• A descoberta retorna todas as situações cadastrais por padrão; use situacao para filtrar (ex.: só ATIVA).

FAQ

É legal? Sim — são dados públicos do registro da Receita Federal (Lei 12.527/2011), acessíveis sem login. Você é responsável pelo uso que faz deles.

Preciso de conta ou chave de API? Não. Sem conta, sem login, sem chave.

Qual a diferença entre os dois modos? Lookup = você já tem os CNPJs e quer os dados. Discovery = você quer descobrir quais empresas existem num setor/região (por CNAE/UF).

De onde vêm os dados? Do registro público de CNPJ da Receita Federal, via fontes públicas que o espelham (minhareceita.org como primária; BrasilAPI e CNPJ.ws como fallback).

Changelog

1.0

• Primeira versão. Dois modos: Lookup (lote de CNPJs → registro completo com QSA) e Discovery (CNAE/UF/município → lista paginada). Fallback multi-fonte, validação de CNPJ (dígito verificador), pacing por fonte e detecção de indisponibilidade das fontes.

---

English (summary)

What it does: look up Brazilian company data by CNPJ in bulk, or discover companies by CNAE/state — straight from the Receita Federal public registry, no login, no API key. One actor, two modes: Lookup (list of CNPJs → full record with partners/QSA) and Discovery (CNAE + state/city filter → paginated company list).

Use cases: B2B prospecting (find every company in a sector + state by CNAE), KYC/compliance (verify a CNPJ and capture its partners), lead enrichment (a CSV of CNPJs → structured profiles), market research by sector.

Which mode: have a list of CNPJs → use Lookup; have a sector (CNAE) + region and want the companies → use Discovery.

Inputs: mode (lookup/discovery, required); lookup: cnpjs (array) and/or cnpjInput (CSV/text — CNPJs are extracted, validated, deduplicated); discovery: cnae (required), uf, municipio, situacao, maxResults (default 1000).

Output: one record per company (see the real JSON above) — cnpj, razaoSocial, situacaoCadastral, cnaePrincipal, capitalSocial, endereco, socios (partners, with masked CPF), source, scrapedAt, and more. Missing field = null, never estimated.

Cost: billed per returned record (Pay Per Event). Example: at $1.50 per 1,000 records, 1,000 companies cost about $1.50.

Reliability: multi-source fallback (minhareceita → BrasilAPI → CNPJ.ws) with per-source pacing; source records which one answered. A non-existent CNPJ (legit 404) is reported as such and never confused with a source outage — a high all-sources-failure rate raises qualityAlert (re-run).

Limitations: public Receita Federal data, updated monthly (not real-time); depends on the availability of the free public sources; detailed Simples/tax-debt/lawsuits are out of scope in this version; discovery returns all registration statuses by default (use situacao to filter).