🏢 CNPJ Enricher — Brazilian Company Data

🔗 View on Apify Store | 🇺🇸 English | 🇧🇷 Português

Enrich CNPJ numbers with complete company data from official Brazilian government sources. Get razão social, CNAE, endereço, QSA (partners/directors), capital social, situação cadastral, and more.

✨ Features

• 🏛️ Official sources — Data from official Brazilian government databases
• 📋 Full company data — Legal name, CNAE, address, partners, capital, company size
• 🔄 Smart fallback — Multiple data sources for maximum reliability
• ✅ Format flexible — Accepts CNPJs with or without formatting (12.345.678/0001-00 or 12345678000100)
• ⏱️ Rate-limit compliant — Respects API limits with configurable delay
• 🛡️ Validated output — Every output item validated before delivery
• 💰 Ultra low cost — $0.01/company, 50 free results
• 🚀 Lightweight — No browser needed, minimal resources

📥 Input

Parameter	Type	Required	Default	Description
cnpjs	string[]	✅	—	List of CNPJ numbers (formatted or raw)
delayBetweenRequests	integer	❌	21000	Delay between requests in ms

Input Example

{
  "cnpjs": [
    "27.865.757/0001-02",
    "00000000000191",
    "33000167000101"
  ]
}

📤 Output

Every company includes these fields:

Field	Type	Description
cnpj	string	CNPJ number (digits only)
razao_social	string	Legal company name
nome_fantasia	string	Trade name
situacao_cadastral	string	Registration status (ATIVA, BAIXADA, etc.)
data_abertura	string	Opening date (YYYY-MM-DD)
cnae_principal	object	Primary economic activity {codigo, descricao}
cnaes_secundarios	object[]	Secondary activities
endereco	object	Full address {logradouro, numero, bairro, municipio, uf, cep}
qsa	object[]	Partners/directors [{nome, qualificacao}]
capital_social	number	Registered capital (BRL)
porte	string	Company size (MICRO EMPRESA, DEMAIS, etc.)
natureza_juridica	string	Legal nature
telefone	string	Phone number
email	string	Email
source	string	Data source identifier

Output Example

{
  "cnpj": "27865757000102",
  "razao_social": "GLOBO COMUNICACAO E PARTICIPACOES S/A",
  "nome_fantasia": "TV/REDE/GLOBO.COM/CANAIS GLOBO/GLOBOPLAY/ELETROMIDIA",
  "situacao_cadastral": "ATIVA",
  "data_abertura": "1986-01-31",
  "cnae_principal": {
    "codigo": "6021700",
    "descricao": "Atividades de televisão aberta"
  },
  "cnaes_secundarios": [
    {"codigo": "4752100", "descricao": "Comércio varejista especializado de equipamentos de telefonia e comunicação"}
  ],
  "endereco": {
    "logradouro": "R LOPES QUINTAS",
    "numero": "303",
    "bairro": "JARDIM BOTANICO",
    "municipio": "RIO DE JANEIRO",
    "uf": "RJ",
    "cep": "22460901"
  },
  "qsa": [
    {"nome": "PAULO DAUDT MARINHO", "qualificacao": "Diretor"},
    {"nome": "GEORGES AYOUB RICHE", "qualificacao": "Diretor"}
  ],
  "capital_social": 6983568523.86,
  "porte": "DEMAIS",
  "natureza_juridica": "205-4 - Sociedade Anônima Fechada",
  "source": "receitaws"
}

📋 Use Cases

• Lead Enrichment — Add company data to B2B lead lists
• Due Diligence — Verify company registration before partnerships
• Market Research — Map competitors by CNAE codes
• Compliance/KYC — Check situação cadastral (ATIVA/BAIXADA)
• Financial Analysis — Compare capital social across companies
• Partner Screening — Review QSA (partners/directors) before deals

❓ FAQ

Q: Does this need any API key? A: No! This actor uses free public APIs and doesn't require authentication.

Q: What happens if a data source is unavailable? A: The actor automatically tries alternative sources. If all fail, the CNPJ is logged and skipped — no fake data is ever produced.

Q: What CNPJ formats are accepted? A: Both formatted (12.345.678/0001-00) and raw (12345678000100) are accepted.

Q: Why is there a delay between requests? A: To respect the free-tier rate limits of the government APIs. You can adjust the delay via delayBetweenRequests.

Q: Can I query hundreds of CNPJs? A: Yes! The actor processes them sequentially with a configurable delay. For large batches, consider running during off-peak hours.

� Pricing

This actor uses Pay Per Event (PPE) pricing:

Metric	Cost
Per company enriched	$0.01
Free tier	50 results/month

💡 Try it free — first 50 results every month at no cost!

�🔗 Related Actors

• Google Maps BR — Business data + reviews
• Mercado Livre Scraper — E-commerce product data
• Instagram Reels Scraper — Social media metrics

📝 Changelog

v1.0 (Current)

• ✅ CNPJ enrichment from official sources
• ✅ Flexible CNPJ format input
• ✅ Full QSA extraction (partners/directors)
• ✅ Rate-limit compliant with configurable delay
• ✅ Validated output

---

🏢 CNPJ Enricher — Dados de Empresas Brasileiras

🇺🇸 English | 🇧🇷 Português

Enriqueça CNPJs com dados completos de empresas direto das fontes oficiais do governo brasileiro. Obtenha razão social, CNAE, endereço, QSA (sócios/diretores), capital social, situação cadastral e mais.

✨ Funcionalidades

• 🏛️ Fontes oficiais — Dados de bancos de dados oficiais do governo brasileiro
• 📋 Dados completos — Razão social, CNAE, endereço, QSA, capital social, porte
• 🔄 Fallback inteligente — Múltiplas fontes de dados para máxima confiabilidade
• ✅ Formato flexível — Aceita CNPJ com ou sem formatação (12.345.678/0001-00 ou 12345678000100)
• ⏱️ Respeita rate limit — Respeita limites das APIs com delay configurável
• 🛡️ Output validado — Todo item de saída verificado antes da entrega
• 💰 Custo ultra baixo — $0.01/empresa, 50 resultados grátis
• 🚀 Leve — Sem browser, recursos mínimos

📥 Entrada

Parâmetro	Tipo	Obrigatório	Padrão	Descrição
cnpjs	string[]	✅	—	Lista de CNPJs (formatados ou só números)
delayBetweenRequests	inteiro	❌	21000	Delay entre requests em ms

Exemplo de Entrada

{
  "cnpjs": [
    "27.865.757/0001-02",
    "00000000000191",
    "33000167000101"
  ]
}

📤 Saída

Cada empresa inclui estes campos:

Campo	Tipo	Descrição
cnpj	string	Número do CNPJ (somente dígitos)
razao_social	string	Razão social da empresa
nome_fantasia	string	Nome fantasia
situacao_cadastral	string	Situação cadastral (ATIVA, BAIXADA, etc.)
data_abertura	string	Data de abertura (AAAA-MM-DD)
cnae_principal	objeto	Atividade econômica principal {codigo, descricao}
cnaes_secundarios	objeto[]	Atividades secundárias
endereco	objeto	Endereço completo {logradouro, numero, bairro, municipio, uf, cep}
qsa	objeto[]	Quadro societário [{nome, qualificacao}]
capital_social	número	Capital social registrado (R$)
porte	string	Porte da empresa (MICRO EMPRESA, DEMAIS, etc.)
natureza_juridica	string	Natureza jurídica
telefone	string	Telefone
email	string	E-mail
source	string	Identificador da fonte de dados

📋 Casos de Uso

• Enriquecimento de leads — Adicione dados empresariais a listas B2B
• Due Diligence — Verifique o cadastro antes de fechar parcerias
• Pesquisa de mercado — Mapeie concorrentes por código CNAE
• Compliance/KYC — Cheque situação cadastral (ATIVA/BAIXADA)
• Análise financeira — Compare capital social entre empresas
• Triagem de parceiros — Revise QSA (sócios/diretores) antes de negócios

❓ Perguntas Frequentes

P: Precisa de alguma chave de API? R: Não! Este actor usa APIs públicas gratuitas e não exige autenticação.

P: O que acontece se uma fonte de dados estiver indisponível? R: O actor automaticamente tenta fontes alternativas. Se todas falharem, o CNPJ é logado e pulado — nunca são gerados dados fictícios.

P: Quais formatos de CNPJ são aceitos? R: Tanto formatado (12.345.678/0001-00) quanto somente números (12345678000100).

P: Por que há um delay entre as consultas? R: Para respeitar os limites de taxa das APIs governamentais gratuitas. Você pode ajustar o delay via delayBetweenRequests.

P: Posso consultar centenas de CNPJs? R: Sim! O actor processa sequencialmente com delay configurável. Para lotes grandes, considere executar em horários de baixa demanda.

� Preços

Este actor usa precificação Pay Per Event (PPE):

Métrica	Custo
Por empresa enriquecida	$0.01
Tier gratuito	50 resultados/mês

💡 Teste grátis — primeiros 50 resultados todo mês sem custo!

�🔗 Actors Relacionados

• Google Maps BR — Dados de empresas + avaliações
• Mercado Livre Scraper — Dados de produtos e-commerce
• Instagram Reels Scraper — Métricas de redes sociais