Enriquecimento inteligente de **CNPJ, e-mail e telefone** com validação, dados cadastrais, informações públicas, insights e sinais de negócio. Ideal para: * KYC / Compliance * Enriquecimento de leads B2B * Validação de cadastros * Antifraude * CRM / Data Intelligence * Prospecção comercial
# 📦 O que esta API entrega Com apenas **CNPJ, e-mail ou telefone**, você obtém: ✅ Validação de e-mail (DNS, MX, servidor, ASN)
✅ Validação de telefone (formatação, tipo, país, WhatsApp)
✅ Dados completos da empresa (Receita Federal)
✅ CNAE principal e secundários com descrição
✅ Sócios (QSA)
✅ Endereço + geolocalização
✅ Links sociais e website
✅ Score de enriquecimento
✅ Insights demográficos e intenção de negócio
# 🔐 Autenticação Todas as requisições exigem header: ``` X-RapidAPI-Key: SUA_CHAVE X-RapidAPI-Host: datacnpj.p.rapidapi.com ```
# 🧩 Endpoints
## 🏢 infoEmpresaCnpj Retorna **dados completos da empresa + validação de contato** a partir de CNPJ, e-mail e/ou telefone. ### Parâmetros | Campo | Tipo | Obrigatório | Descrição | | ------- | ------- | ----------- | ----------------------- | | cnpj | string | ✅ | CNPJ com ou sem máscara | | email | string | ❌ | E-mail para validação | | phone | string | ❌ | Telefone com DDD |
### Exemplo de Request ```json { "cnpj": "02558157000162", "email": "contato@empresa.com", "phone": "551134304532" } ```
### Principais campos da resposta * company → dados Receita Federal * phone → validação + WhatsApp * email → validação + MX + ASN * insights → localização + social + setor * enrichment_score → 0–100 * possible_people → decisores/sócios
### Exemplo de Resposta (resumida) ```json { "company": { "razao_social": "EMPRESA S.A.", "situacao_cadastral": "Ativa", "cnae_principal_desc": "Serviços de telecomunicações" }, "phone": { "valid": true, "type": "FIXED_LINE" }, "email": { "valid": true, "domain": "empresa.com" }, "enrichment_score": 80 } ```
## 📧 infoEMail Valida e enriquece os **e-mails corporativos**. ### Parâmetros | Campo | Tipo | Obrigatório | | ----- | ------- | ----------- | | email | string | ✅ | ### O que retorna * Validação sintática * MX records * Servidor * ASN * Website do domínio * Indícios B2B/B2C * Score de enriquecimento ### Exemplo ```json { "email": "contato@mail.com" } ```
## 📱 infoTelefone Validação e enriquecimento de telefone. ### Parâmetros | Campo | Tipo | Obrigatório | | ----- | ------- | ----------- | | phone | string | ✅ |
### O que retorna * Formato E.164 * Tipo (mobile/fixo) * País * Dados geográficos * Verificação WhatsApp
### Exemplo ```json { "phone": "11999999999" } ```
# 🧠 Campo enrichment_score Pontuação geral de qualidade do enriquecimento: | Score | Interpretação | | ------ | ------------------- | | 0–30 | pouco dado | | 31–60 | médio | | 61–100 | alto enriquecimento |
# ⚠️ Possíveis warnings A API pode retornar mensagens como: * domínio inexistente * DNS error * telefone inválido * dados parciais Sempre verifique o campo: ``` warnings ```
# 💼 Casos de uso ✔ Validação de leads B2B
✔ Higienização de base
✔ Prevenção a fraudes
✔ Score de empresas
✔ Enriquecimento CRM
✔ Inteligência comercial