Enrich API

Enrich profiles with emails, phone numbers, and more.

The Enrich API allows you to enrich LinkedIn profiles with additional data such as work emails, personal emails, and phone numbers. You can enrich single profiles or process bulk jobs.

For bulk enrichment best practices, see the Bulk Enrichment Guide.

POST/api/enrichment/enrichSession

Enrich a single LinkedIn profile

Parameters

linkedinUrlstringrequiredLinkedIn profile URL to enrich

Request

{
  "linkedinUrl": "https://linkedin.com/in/johndoe"
}

Response

{
  "success": true,
  "profile": {
    "linkedinUrl": "https://linkedin.com/in/johndoe",
    "firstName": "John",
    "lastName": "Doe",
    "title": "VP of Sales",
    "company": "Anthropic",
    "workEmail": "john.doe@anthropic.com",
    "personalEmail": "john.doe@gmail.com",
    "phone": "+1 (415) 555-0123"
  },
  "creditsUsed": 1
}
POST/api/enrichment/bulkSession

Create a bulk enrichment job

Parameters

listIdstringrequiredList ID containing leads to enrich
fieldsstring[]Fields to enrich: workEmail, personalEmail, phone

Request

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

Response

{
  "jobId": "bulk-job-456",
  "status": "pending",
  "totalLeads": 500,
  "estimatedCredits": 500
}
GET/api/enrichment/bulk/:jobIdSession

Get status of a bulk enrichment job

Parameters

jobIdstringrequiredBulk job ID

Response

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

Credit Usage

Enrichment uses credits based on the data found:

Data TypeCredits
Work Email1 credit per verified email
Personal Email1 credit per verified email
Phone Number2 credits per verified phone
No data found0 credits (no charge)

Data Sources

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

  • Apollo - Business emails and phone numbers
  • Hunter - Email verification and discovery
  • Clearbit - Company and person enrichment
  • And more...