Developers/Docs/Enrichment API

Enrichment API

Enrich contacts and signals with additional data points using our multi-source enrichment engine. The system automatically selects the most cost-effective sources and falls through to alternatives on miss.

How the Waterfall Works

When you submit an enrichment request, SIE Data routes it through a multi-source pipeline optimized for cost and coverage. The engine tries the fastest, cheapest source first and cascades to deeper sources only when needed.

Quick Path< $0.05, < 500ms — cached + primary sources

Deep Path< $0.20, < 2s — secondary + tertiary sources

Premium PathMarket rate, < 5s — on-demand premium sources

Enrich a Contact

POST/api/v1/enrichment/contact

json

{
  "contact_id": "ct_abc123",
  "fields": ["email", "phone", "company_size", "revenue_range", "tech_stack"],
  "depth": "deep"
}

json

{
  "contact_id": "ct_abc123",
  "enriched_fields": {
    "email": "[email protected]",
    "phone": "+15551234567",
    "company_size": "50-200",
    "revenue_range": "$5M-$20M",
    "tech_stack": ["Salesforce", "HubSpot", "Slack"]
  },
  "cost": 0.04,
  "sources_tried": 2,
  "latency_ms": 380
}

Enrichment Types

Field	Type	Depth
email	Business email	Quick
phone	Direct phone	Quick
company_size	Employee count range	Quick
revenue_range	Annual revenue band	Deep
tech_stack	Technology install base	Deep
social_profiles	LinkedIn, Twitter handles	Deep
firmographics	Industry, SIC/NAICS codes	Quick

Bring Your Own Key (BYOK)

If you have existing subscriptions with enrichment providers, you can supply your own API keys. BYOK requests bypass SIE billing for that source and use your key directly.

json

{
  "contact_id": "ct_abc123",
  "fields": ["email", "phone"],
  "byok": {
    "source_key": "your_provider_api_key_here"
  }
}

BYOK is available on Pro plans and above. Contact support to configure your provider keys.