Endpoints de enriquecimento

Os endpoints de enriquecimento oferecem aprimoramento completo dos dados: • **Contact Enrichment** — encontra e verifica o e-mail de uma pessoa (€0,094/requisição) • **Company Enrichment** — obtém todos os contatos de um domínio corporativo (€0,29/requisição) O enriquecimento combina múltiplas fontes de dados e etapas de verificação para entregar contatos verificados de alta qualidade aos seus fluxos de vendas e marketing.

Enriqueça um único contato com e-mail verificado e dados adicionais. **Endpoint:** `POST /v1/enrich/contact` **Requisição:** ```json { "firstName": "John", "lastName": "Smith", "domain": "company.com", "title": "CEO" } ``` **Resposta:** ```json { "success": true, "data": { "firstName": "John", "lastName": "Smith", "email": "john.smith@company.com", "verified": true, "title": "CEO", "qualityScore": 92, "sources": ["pattern_match", "verification"], "enrichedAt": "2026-02-27T12:00:00Z" }, "usage": { "cost": 0.08, "balanceRemaining": 19.92 } } ``` **Custo:** €0,094 por contato O pipeline de enriquecimento: 1. Adivinhação de e-mail por padrão (grátis) 2. Busca de e-mail paga se os padrões não corresponderem 3. Verificação do e-mail encontrado

Obtenha todos os contatos de um domínio corporativo. **Endpoint:** `POST /v1/enrich/company` **Requisição:** ```json { "domain": "company.com", "limit": 10 } ``` **Resposta:** ```json { "success": true, "data": { "companyName": "Company Inc", "domain": "company.com", "contacts": [ { "email": "john.smith@company.com", "firstName": "John", "lastName": "Smith", "title": "CEO", "verified": true, "qualityScore": 92 }, { "email": "jane.doe@company.com", "firstName": "Jane", "lastName": "Doe", "title": "CTO", "verified": true, "qualityScore": 88 } ], "totalContacts": 12, "verifiedContacts": 10 }, "usage": { "cost": 0.25, "balanceRemaining": 19.75 } } ``` **Custo:** €0,29 por empresa

Nosso processo de enriquecimento segue um pipeline otimizado em custo: 1. **Adivinhação por padrão** (grátis) — gera padrões prováveis de e-mail a partir do nome e do domínio 2. **Verificação de padrão** (€0,023) — verifica o padrão mais provável 3. **Busca paga** (€0,058, se necessário) — se os padrões não verificarem, usa fontes pagas 4. **Verificação final** (€0,023) — verifica o e-mail encontrado Essa abordagem minimiza o custo e maximiza a precisão. A maioria dos contatos é resolvida por correspondência de padrão; a busca paga só é usada quando necessário. **Quality Score:** Cada contato recebe uma pontuação (0-100) com base em: • Status de verificação do e-mail • Autoridade do domínio • Completude dos dados • Confiabilidade da fonte