Skip to main content
Authentication
BetterContact uses API key authentication:
- Sign up at bettercontact.rocks
- Navigate to your API settings
- Copy your API key
- Paste the API key in Cargo when connecting
Find email
Find a person’s email address using multiple data sources (waterfall enrichment).
Input fields (provide as many as available):
- First name: Person’s first name
- Last name: Person’s last name
- Company: Company name
- Company domain: Company domain
- LinkedIn URL: Person’s LinkedIn profile URL
Use case: Waterfall enrichment checks multiple providers to maximize match rates.
Find phone
Find a person’s phone number using multiple data sources.
Input fields (provide as many as available):
- First name: Person’s first name
- Last name: Person’s last name
- Company: Company name
- Company domain: Company domain
- LinkedIn URL: Person’s LinkedIn profile URL
Use case: Maximize phone number discovery through waterfall approach.
How waterfall enrichment works
BetterContact automatically queries multiple data providers in sequence until a match is found. This approach:
- Maximizes coverage: If one provider fails, others are tried
- Improves accuracy: Results are cross-validated
- Simplifies workflows: One integration instead of many
Retry behavior
BetterContact actions include extensive retry logic:
- Maximum 20 retry attempts
- 60-second intervals between retries
- Handles provider rate limits automatically
This ensures reliable results even when individual providers are slow.
Rate limits
BetterContact API has a rate limit of 60 requests per minute. Cargo handles rate limiting automatically.
Best practices
- Provide as many input fields as possible for best results
- LinkedIn URL often provides the best matching
- Include company domain for higher accuracy
- Use waterfall as a fallback for other enrichment sources
- Cache results to avoid redundant lookups