API de CNPJ: como integrar dados de empresas brasileiras

Toda equipe técnica B2B no Brasil em algum momento bate com a mesma pergunta: "preciso buscar dados de empresas por CNPJ programaticamente, uso os dados abertos da Receita Federal, construo minha própria coleta, ou pago uma API de mercado?". A resposta curta é "depende do que você precisa fazer com o dado". A resposta longa é este post.

Vamos cobrir o que diferencia uma API de CNPJ comercial da consulta crua da RFB, quando faz sentido pagar, e que recursos exigir do fornecedor, sem citar nomes de concorrentes.

O que é uma API de CNPJ

Uma API de CNPJ é uma interface HTTP que devolve dados de uma empresa brasileira a partir do número do CNPJ. No mínimo, retorna razão social, situação cadastral, CNAE, endereço e capital social. Em versões mais maduras, retorna também:

• QSA (Quadro de Sócios e Administradores): os sócios e administradores associados à empresa, com qualificação societária traduzida, data de entrada e faixa etária.
• CNAEs traduzidos (descrição da atividade, não só o código).
• Regime tributário (Simples Nacional, MEI).
• Enriquecimento: telefones e e-mails consolidados de fontes web públicas (site oficial, diretórios), redes sociais, decisores.
• Busca avançada: lista CNPJs por filtros (UF, CNAE, porte, capital, etc.), não só lookup por número.

Essa última camada é o que separa "consulta da Receita" de "plataforma de inteligência B2B".

Por que não usar os dados abertos da Receita Federal?

A RFB publica os dados em calendário mensal, em arquivos CSV gigantes que você precisa baixar, importar num MySQL ou PostgreSQL, e indexar. É factível para um time com infra de dados, mas o custo total inclui:

• Storage: a base aberta são dezenas de GB compactados, e bem mais depois de descompactada e indexada.
• Ingestão mensal: pipeline ETL que processa, valida, deduplica e atualiza 70M+ registros de estabelecimentos a cada publicação.
• Indexação para busca por filtros (full-text em razão social, índices em UF/CNAE/porte).
• Manutenção: cada mudança de layout da RFB quebra seu importador.
• Enriquecimento adicional (presença web, contatos institucionais): não vem na base oficial, você precisa construir ou contratar.

Para a maioria dos times de vendas, RevOps e CRMs, isso é overhead que não paga conta. É barato só se você já tem time de dados ocioso.

O que diferencia uma boa API comercial

Existem dezenas de APIs de CNPJ no mercado. A maioria entrega a mesma coisa: dados crus da RFB em CAIXA ALTA, sem tratamento. Os diferenciais reais que você deve exigir:

1. Enriquecimento no mesmo endpoint

API que só devolve dados da RFB é pouco útil em outbound. Você precisa de telefone e e-mail além do que está no cadastro, e de decisor identificado. Uma boa API integra no mesmo endpoint:

• Presença online (avaliações, horário de atendimento, site oficial e telefone publicados em diretórios públicos).
• Contatos institucionais extraídos do site oficial da empresa (e-mails de contato, formulários, redes sociais).
• Decisores identificados via fontes profissionais públicas (nomes + cargos).

Sinal de alerta: fornecedor que cobra módulo por módulo (uma cobrança pra "endereço", outra pra "telefone", outra pra "presença web") está fazendo o que se chama de "API supermercado", você paga 5 vezes pelo que deveria vir junto.

2. Normalização automática

A Receita Federal armazena tudo em CAIXA ALTA, sem máscara, com placeholders esquisitos como (0000) 00000000 para "telefone declarado vazio" e datas no formato YYYYMMDD (sem hífen). API decente entrega isso já tratado:

• Razão social em Title Case com acrônimos legais (LTDA, ME, EIRELI, S/A) preservados em CAPS.
• E-mails em lowercase, com os placeholders da RFB convertidos pra null.
• Telefones com máscara e placeholders convertidos pra null.
• CNPJ e CEP formatados com máscara (12.345.678/0001-90, 01310-100).
• Datas em ISO 8601 (2024-03-15).
• Endereço completo montado: "Avenida Paulista, 1000, Sala 100, Bela Vista, São Paulo - SP, 01310-100", pra copiar e colar direto no CRM.

Se você está rodando strtolower(), preg_replace() e ucwords() no cliente da API antes de gravar no banco, está pagando por menos do que deveria.

3. Busca avançada (não só consulta por CNPJ)

Lookup individual por CNPJ é o caso fácil. O que faz diferença em outbound é buscar listas filtradas: "todas as agências de publicidade em SP com celular informado e capital social acima de R$ 50k". Uma boa API expõe:

• Filtros firmográficos: UF, município, CNAE, porte, natureza jurídica, capital social (faixa), idade da empresa.
• Filtros de qualidade de contato: empresas com e-mail corporativo (exclui Gmail/Hotmail), com telefone, com celular/WhatsApp informado.
• Filtros de exclusão: ignora e-mails de escritórios contábeis (que são intermediários, não decisores).
• Paginação com teto (máx. 100 por página): controle de uso justo, mas permite varrer com loop legítimo.

4. Enriquecimento em lote (sync e async)

Quando você precisa enriquecer 500 CNPJs de uma campanha, fazer 500 requests sequenciais é frágil (timeout, rate limit, retry hell). API madura aceita lista em uma única chamada:

• Modo síncrono pra listas pequenas (≤100 CNPJs): resposta em uma chamada só.
• Modo assíncrono pra listas grandes (até 1.000 CNPJs): cria job, devolve job_id, você faz polling pra acompanhar status.
• Estorno automático de CNPJs não encontrados, você não paga por dado que não existe.

5. Idempotency-Key (padrão Stripe)

Retry sem idempotency em endpoint que debita crédito é convite pra cobrança duplicada. APIs maduras implementam o padrão Idempotency-Key: se você reenvia a mesma key em até 24h, a API devolve a resposta cacheada da primeira chamada, sem re-debitar. Padrão amplamente adotado por Stripe, Shopify, GitHub.

6. Modelo de cobrança previsível

Existem dois modelos no mercado:

1. Mensalidade fixa + por chamada: você paga R$ X de assinatura + R$ Y por consulta. Difícil prever no fim do mês.
2. Créditos do plano: você tem N créditos/mês inclusos no plano (compartilhados entre painel e API). Sem mensalidade adicional pra ligar a API. Sobrar créditos, sobra. Faltou, faz upgrade. Vale checar se o fornecedor cobra o mesmo pelo uso programático e pelo manual, na LeadCNPJ, por exemplo, a consulta via API custa meio crédito nos planos com API, então o mesmo saldo rende o dobro de chamadas.

O segundo modelo é mais previsível para time financeiro e mais alinhado com pequenas e médias empresas (que não querem assinar contrato anual só pra testar).

Quando vale pagar por uma API de CNPJ

Pague pela API quando você está em um dos cenários abaixo:

• RevOps / SDR Ops: roda enrichment noturno em leads do CRM. HubSpot, Pipedrive, RD Station, Salesforce. Cada lead novo entra com setor, porte, contatos, decisor e celular informado.
• Outbound em escala: precisa de lista filtrada por ICP toda semana. Busca avançada com +20 filtros economiza dias de planilha.
• KYC / Compliance: onboarding de fornecedor consulta CNPJ, confere situação cadastral e QSA, a etapa cadastral. Auditoria exige request_id persistente (18 meses).
• Análise de mercado / BI: cruza amostras setoriais com bases internas. QSA + capital social + idade da empresa abastecem modelos de scoring.
• Plataforma SaaS: produto B2B que precisa pré-popular dados quando o cliente cria conta (auto-fill de "qual é o seu CNPJ?").

Não pague quando você só precisa consultar 10 CNPJs por mês manualmente. A consulta avulsa no painel resolve sem integração.

Como escolher seu fornecedor

Checklist objetivo para avaliar API de CNPJ antes de assinar:

• Documentação interativa (não só PDF): testa endpoint no navegador.
• OpenAPI 3.0: gera SDK na sua linguagem com 1 comando.
• Trial sem cartão de crédito: desconfie de quem exige cartão pra liberar 1 consulta.
• Rate limit publicado e por plano (não escondido).
• LGPD-grade: política clara sobre o Art. 7º §4º (dados manifestamente públicos) e retenção de logs.
• Status page público ou changelog visível: sinaliza que o fornecedor leva uptime a sério.
• Suporte responsivo: faça uma pergunta técnica antes de assinar. Como respondem?

Sobre a API LeadCNPJ

A API LeadCNPJ implementa os 6 diferenciais listados acima:

• Base pública de 70M+ CNPJs, atualizada conforme o calendário oficial de publicação.
• Enriquecimento (presença web, contatos institucionais, decisores) no mesmo endpoint.
• Normalização automática (Title Case, ISO 8601, telefones e CEP mascarados).
• Busca avançada com +20 filtros firmográficos e de contato.
• Enriquecimento em lote sync (≤100) e async (até 1.000) com Idempotency-Key.
• Cobrança por créditos do plano, com a consulta via API custando meio crédito. Acesso a partir do Growth (R$ 349,90/mês, 30 req/min, 2.500 créditos = 5.000 consultas). Scale: 60 req/min e 10.000 créditos. Professional: 100 req/min e 20.000 créditos. Enterprise: sem limite de requisições.

Antes de integrar, vale fazer a conta: quanto custa uma API de consulta CNPJ compara o custo por consulta do modelo de créditos com a tabela pública da referência estatal.

Documentação completa em /api/docs/. Spec OpenAPI 3.0 em /api/openapi.json. Pra ver o que cada plano libera e ativar a API na sua conta, veja a página da API de empresas, a API não entra no teste grátis, que cobre as funções do plano Start.