Union Data Enrichment API
Unify your GTM stack with one enrichment API across 32+ providers
API Access Requirements
The Union API is currently available only to select teams and requires approval. Contact our team at support@fullpilot.com to request access.
How Union Works
Union solves the problem of data fragmentation across multiple enrichment providers. Instead of integrating with Clearbit, Hunter.io, Apollo, ZoomInfo, and dozens of other providers separately, Union provides a single API that intelligently queries multiple providers and returns unified, complete records.
Our optimization engine automatically selects the best providers for each field based on your priorities: cost, accuracy, or speed. You can set granular budgets per field, block specific providers, and Union handles the complexity of provider selection, data merging, and cost optimization.
Key Benefits
Single Integration
One API instead of 32+ separate integrations
Cost Optimization
60% cost reduction through intelligent provider selection
Granular Control
Per-field budgets and provider preferences
Unified Data
Complete records merged from multiple sources
Create API Keys
Login to create an API key
How to use your API keys
Authentication
Include your API key in the Authorization header:
Authorization: Bearer union_live_your_api_key_hereBase URL
http://localhost:3000/api/v1/Rate Limits
Optimization Strategies
Union's optimization engine uses sophisticated algorithms to select the best providers for each field based on your priorities:
Cost Priority
Minimizes cost while maintaining data quality. Perfect for high-volume enrichment where budget is the primary concern.
Accuracy Priority
Maximizes data quality and completeness. Ideal for sales teams where high-quality contact data is critical.
Speed Priority
Optimizes for fastest response times. Best for real-time applications like form enrichment.
Pricing & Billing
Union uses transparent, per-field pricing. You only pay for the data you successfully retrieve, with costs varying by provider and field type. Our optimization engine can reduce your overall enrichment costs by up to 60% compared to using providers directly.
Set granular budgets per field to control costs. View detailed cost breakdowns in your dashboard.
Input & Output Schema
Union accepts any structured JSON object as input. There are no required field names or templates. You can send any fields you have, and Union will attempt to match them to available provider fields.
If a field is not available from our 32+ integrated data sources, Union uses AI research agents and large language models to find the requested information. This applies to both standard and custom fields.
Union does not require you to transform or reformat your data. The input structure is preserved, and only the fields you specify are enriched.
You can control the output format in two ways: by providing an array of field names, or by defining a JSON schema for the response. The JSON schema option allows you to specify structure, types, and validation for the output.
API Endpoint
/api/v1/enrichEnrich contact data
Enrich partial contact information with complete data from 32+ providers.
Request body
Any structured JSON object with the data you want to enrich. Union accepts any field names - not just predefined ones.
Common fields: email, name, company, phone, linkedin, website, title, industry, location, company_size, etc.
AI-powered: For custom fields not available in our 32+ providers, Union's AI research agents will attempt to find the information using LLM models.
Two formats supported:
1. Field Array: Simple array of field names to enrich:["name", "title", "company"]
2. JSON Schema: Complete schema defining output structure, data types, and validation rules for precise control over the response format.
Available fields: name, title, company, phone, email, linkedin, industry, company_size, location, website, or any custom fields your input contains. See the Enrichment Fields Reference for the complete list.
See OptimizationConfig reference below for all options.
Returns
Returns enriched data with complete metadata including costs, confidence scores, providers used, and processing time.
Example request
Example response
Common Use Cases
Sales Team Configuration
Prioritize accuracy for lead qualification with higher budgets for decision-maker identification.
Marketing Team Configuration
Cost-optimized for high-volume email campaigns with focus on firmographic data.
Real-time Form Enrichment
Speed-optimized for instant form completion with 500ms response time limit.
Error Handling
Union uses standard HTTP status codes and returns detailed error information to help you handle issues gracefully.
400 - Bad Request
402 - Payment Required
429 - Rate Limited
OptimizationConfig Reference
- priority: Optimization goal. One of 'cost', 'accuracy', or 'speed'. (required)
- max_cost_per_field: Object mapping field names to max cost per field. (optional)
- allowed_providers: Array of provider names to allow. (optional)
- blocked_providers: Array of provider names to block. (optional)
- provider_preferences: Advanced weighting for provider selection. (optional)
- max_total_cost: Maximum total cost for the request. (optional)
- max_time: Maximum time in milliseconds to spend on enrichment. (optional)
Support & Resources
Need help getting started or have questions about the API? We're here to help.
Contact Support
Email us at support@fullpilot.com
Request API Access
Book a call to discuss your enrichment needs and get API access.