Enrich Engine

Bulk enrichment allows you to add emails, phone numbers, and other data to hundreds or thousands of leads at once. This guide covers best practices for maximizing data quality and minimizing costs.

Workflow Overview

Prepare your list: Ensure leads have LinkedIn URLs (the primary identifier for enrichment)
Choose enrichment fields: Select which data you need (work email, personal email, phone)
Start the job: Create a bulk enrichment job via API or dashboard
Monitor progress: Track completion and success rates
Review results: Check enriched data and handle failures

Starting a Bulk Job

Via Dashboard

Navigate to your list in the Lists section
Click "Enrich" button
Select the fields you want to enrich
Review the credit estimate
Click "Start Enrichment"

Via API

POST /api/enrichment/bulk
Content-Type: application/json

{
  "listId": "list-123",
  "fields": ["workEmail", "phone"]
}

Credit Usage

Credits are only charged when data is found:

Data Type	Credits	Notes
Work Email	1	Per verified email
Personal Email	1	Per verified email
Phone Number	2	Direct dials cost more
No data found	0	No charge for misses

Tip: You only pay for successful enrichments. If no email is found for a lead, you're not charged for that attempt.

Data Sources

Enrich Engine aggregates data from multiple providers. You can configure which providers to use in Settings > Enrichment Providers.

Apollo

Business emails and phone numbers. Good coverage for B2B contacts.

Hunter

Email discovery and verification. Strong for company email patterns.

Clearbit

Company and person enrichment. Good for firmographic data.

The system automatically queries multiple providers and returns the best match.

Best Practices

Start with LinkedIn URLs

Enrichment is most accurate when leads have valid LinkedIn profile URLs. Use the scrape feature first to find profiles, then enrich.

Enrich Recent Data

Contact information changes frequently. Enrich leads shortly before you plan to reach out for best results.

Batch Similar Leads

Group leads by similar characteristics (industry, company size) for more consistent enrichment rates.

Review Before Large Jobs

For lists over 1000 leads, test with a small batch first to check data quality and match rates.

Monitoring Jobs

Track bulk job progress via API:

GET /api/enrichment/bulk/job-123

{
  "jobId": "job-123",
  "status": "processing",
  "totalLeads": 500,
  "processedLeads": 250,
  "successCount": 230,
  "failedCount": 20,
  "creditsUsed": 245
}

Job statuses:

pending - Job queued, not started
processing - Actively enriching
completed - All leads processed
failed - Job failed with error

Handling Failures

Some leads may not enrich successfully. Common reasons:

Invalid or non-existent LinkedIn URL
Person no longer at the company (stale data)
Private profile or restricted visibility
Small company with limited data coverage
Person not in any data provider's database

Failed enrichments don't consume credits. You can try enriching failed leads again later as data providers update their databases.

Bulk Enrichment Guide