API de CNPJ: por que integrar dados empresariais no seu app

Seu produto precisa validar fornecedores no onboarding, enriquecer cadastros de clientes PJ no CRM ou bloquear contratos com empresas inaptas — mas cada verificação manual em portal diferente não escala. É aí que entra a API: um contrato estável entre sistemas que troca dados de forma automática, sem copiar e colar CNPJ em abas do navegador.

Este artigo explica o que é uma API, por que integrar aplicativos importa e por que o Confere CNPJ é o lugar certo para consultar empresas brasileiras via código — com dados oficiais, análise de risco e protestos em cartórios, tudo em JSON.

O que é uma API (e por que isso importa)?

API significa Application Programming Interface — interface de programação entre aplicações. Em termos práticos: um serviço expõe endpoints HTTP; seu sistema envia uma requisição (por exemplo, um CNPJ) e recebe uma resposta estruturada (JSON) pronta para processar.

Sem API, cada time reinventa a roda:

• Abre portal da Receita, copia razão social, cola na planilha
• Consulta certidão em outro site, salva PDF manualmente
• Verifica protesto em portal estadual que cobre só uma UF
• Repete o fluxo para cada fornecedor, cliente ou parceiro

Com API, um único POST substitui dezenas de cliques. O ganho não é só velocidade: é consistência (mesmo formato em todo lugar), auditoria (log de requisições) e produto (validação embutida no fluxo do usuário, não em processo paralelo).

Para dados de empresas no Brasil, a API certa precisa ir além do cadastro básico. Due diligence real exige situação cadastral, certidões, sinais de risco e, quando aplicável, protestos em cartórios — consolidados numa resposta que seu backend consome sem parsing frágil de HTML.

Integração entre apps: onde a API entra no seu produto

Integração não é "conectar dois sistemas por hobby". É eliminar ilhas de informação para que decisões aconteçam no momento certo — no cadastro, na aprovação de crédito, na assinatura do contrato.

Cenários comuns em produtos B2B:

• Onboarding / KYC — Validar CNPJ antes de abrir conta ou liberar limite
• ERP e CRM — Manter razão social, CNAE, situação e alertas sincronizados
• Marketplace — Checar vendedores PJ antes de publicar anúncio ou liberar repasse
• Crédito B2B — Complementar score interno com CND, CNDT e protestos públicos
• Compliance — Registrar evidência automatizada de due diligence por CNPJ

O padrão técnico é sempre parecido: evento no seu app (novo cadastro, pedido acima de X reais, renovação anual) dispara chamada à API; a resposta alimenta regra de negócio, fila de revisão humana ou bloqueio automático.

REST + JSON virou o padrão de fato porque qualquer linguagem (Node, Python, PHP, Java, Go) consome com bibliotecas maduras. Autenticação por Bearer token (API Key) e respostas previsíveis reduzem tempo de integração de semanas para dias.

O que a API do Confere CNPJ entrega?

A API do Confere CNPJ expõe programaticamente o que a plataforma já faz na interface web: consulta de empresas com interpretação de risco, não só dump de dado bruto.

Endpoints principais:

• POST /api/v1/consulta — Etapa 1: dados cadastrais Serpro — debita 1 crédito, retorna consultation_id
• POST /api/v1/consulta/ia — Etapa 2: CND, CNDT, reputação e análise — usa consultation_id, não debita crédito
• POST /api/v1/protestos — Protestos em cartórios com cobertura nacional (26 estados + DF)

O que você recebe na consulta completa (etapas 1 + 2):

• Dados cadastrais oficiais (razão social, CNAE, porte, endereço, situação)
• Score de confiança e alertas de risco interpretados
• Certidão Negativa de Débitos (CND federal)
• Certidão Negativa de Débitos Trabalhistas (CNDT)
• Quadro societário
• Opcionalmente: protestos em cartórios ("consta" ou "nada consta" consolidado)

Tudo em JSON, pronto para gravar no banco, exibir no painel ou acionar webhook interno.

Por que o Confere CNPJ é o lugar certo para essa integração?

Nem toda API de CNPJ resolve o problema de negócio. Muitas entregam só cadastro da Receita — e você continua caçando certidão, protesto e leitura de risco em outros lugares.

O Confere CNPJ concentra o que due diligence B2B precisa:

1. Fonte oficial — dados cadastrais via Serpro, alinhados ao que a Receita publica
2. Análise interpretada — score e alertas, não apenas campos crus
3. Certidões na mesma consulta — CND e CNDT sem integração separada
4. Protestos nacionais — um endpoint cobre todo o Brasil; sem malabarismo de portal por UF
5. Modelo simples de créditos — 1 crédito por consulta completa (etapa 1 + etapa 2); /consulta/ia não gasta saldo extra
6. Pronto para produção — cadastro gratuito, API Key em Minha conta → API, pagamento via PIX

Se você está construindo fintech, ERP, CRM, plataforma de crédito ou ferramenta de compliance, não precisa manter cinco integrações frágeis. Precisa de um parceiro de dados empresariais com resposta confiável e documentação clara.

Consulte o CNPJ de qualquer empresa

Análise completa com score de confiança, alertas automáticos e dados oficiais da Receita Federal.

Consultar CNPJ

Como integrar em 4 passos

1. Crie sua conta

Cadastro gratuito com e-mail em conferecnpj.com.br. Sem cartão para começar.

2. Compre créditos de API

Em Minha conta → API, escolha pacote de consulta (10, 50 ou 100 créditos) ou protestos. Pagamento via PIX; créditos não expiram.

3. Gere sua API Key

Na mesma seção, crie uma chave de produção. Copie na hora — por segurança, ela só é exibida uma vez.

4. Faça a primeira requisição

Autentique com Authorization: Bearer SUA_API_KEY e envie o CNPJ:

curl -X POST https://conferecnpj.com.br/api/v1/consulta \
  -H "Authorization: Bearer SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cnpj": "00000000000191"}'

A resposta traz consultation_id. Em seguida, chame POST /api/v1/consulta/ia com esse ID para obter CND, CNDT, reputação e análise de risco — sem debitar outro crédito.

Documentação completa, casos de uso e FAQ técnico: API para Desenvolvedores.

Quanto custa usar a API?

• Consulta completa (cadastro + análise): 1 crédito por CNPJ
• Pacotes: 10, 50 ou 100 consultas — ideal começar com 10 para homologar a integração
• Protestos: produto separado, cobrado por consulta de protestos quando você precisa desse dado específico
• Sem assinatura mensal — pay-per-use via PIX

Para volume alto ou fluxos customizados, vale falar com o time pelo formulário na página de API.

Boas práticas na integração

• Cache com critério: situação cadastral muda; defina TTL (ex.: 24–72 h) conforme risco do seu caso de uso
• Trate erros explicitamente: CNPJ inválido (400), não encontrado (404), saldo insuficiente (402)
• Separe etapas 1 e 2: use consultation_id para retentar a análise sem novo débito se a etapa 2 falhar por timeout
• Log de auditoria: guarde consultation_id e timestamp para compliance
• LGPD: a API processa dados públicos de pessoa jurídica; alinhe política interna para uso B2B

Perguntas frequentes

Preciso saber programar para usar a API?

Sim — a API é voltada a desenvolvedores e times técnicos. Se você não tem dev interno, use a consulta pela interface web ou envie o formulário na página de API para conversar sobre integração assistida.

A API substitui consulta manual no site?

Entrega o mesmo núcleo de dados (cadastro, certidões, risco, protestos), mas embutido no seu fluxo. A interface web continua útil para análises pontuais; a API escala quando você valida dezenas ou centenas de CNPJs por mês.

Posso consultar CNPJs em lote?

Cada CNPJ é uma requisição independente. Não há upload de planilha na API — você itera no seu backend ou script. Pacotes de 50 ou 100 créditos costumam ser o próximo passo depois de homologar com 10.

POST /api/v1/consulta/ia gasta crédito?

Não. Apenas POST /api/v1/consulta debita 1 crédito. O endpoint /consulta/ia usa o consultation_id da etapa 1 e não debita saldo — inclusive em retentativas após erro. Uma consulta completa custa 1 crédito no total.

A API cobre protestos em todos os estados?

Sim. O endpoint de protestos consulta cartórios nos 26 estados e no Distrito Federal, consolidando o resultado em uma única resposta — diferente de portais estaduais que cobrem só uma UF.

A API é compatível com CNPJ alfanumérico?

O Confere CNPJ já trata o novo formato alfanumérico da Receita Federal (a partir de julho de 2026). Ao integrar, normalize o CNPJ no seu lado e envie com ou sem máscara — a API valida o formato.

Como começo agora?

Crie sua conta, acesse Minha conta → API, compre créditos, gere a API Key e siga o guia em API para Desenvolvedores.