Numbers
Primitives
Everything on this page is derived from these numbers. Updated March 2026.
| Attribute | Value | Detail |
|---|---|---|
| Supported providers | 30+ | See /integrations for the full list |
| Providers in default email chain | 6 | Dropleads, Hunter, LeadMagic, Deepline Native, Crustdata, PDL |
| Waterfall types | Email, phone, company, person | Each type has dedicated provider chains |
| Waterfall playbooks | 6 | Name+Company, LinkedIn+Name, LinkedIn-only, Email-to-Person, Cost-aware, Company+Role |
| Fallback behavior | Automatic | If provider A returns no result, tries provider B. Stops on first valid hit. |
| Custom ordering | Yes | Via deepline/context.md or CLI flags |
| Cost visibility | Pre-run estimate | Cost shown before each run |
| BYOK support | 30+ | Zero markup with your own API keys, pay providers directly |
| Cost per email found | $0.016-$0.048 | 0.2-0.6 credits at managed rates |
| Validation included | Yes | ZeroBounce validation on every waterfall result |
| Pay model | Pay only on hit | Providers that miss are not billed |
Meaning
What this means for you
If you're searching for "best waterfall enrichment tool"
Provider diversity is what makes a waterfall worth using. No single email provider has complete coverage. B2B contact data decays at roughly 20-25% per year, so any single source goes stale fast. Deepline chains 30+ providers with automatic fallback: if provider A returns nothing, provider B fires immediately. You do not configure retry logic or write conditional branching. The waterfall stops on the first valid hit and bills only the providers that ran.
If you're searching for "cheapest email enrichment"
The BYOK model means the platform fee is $0. You pay providers directly at their published rates. With managed credits, waterfall logic tries the cheapest provider first and stops at the first valid hit. Most lookups resolve on provider 1 or 2 at $0.016-$0.048. The cost-aware variant tries 3 deterministic email patterns via validation before calling any finder, saving 50-70% on lists where common patterns are prevalent.
If you're searching for "email enrichment for Claude Code"
One CLI command or a natural language prompt. No spreadsheet UI, no column wiring, no template configuration. The agent reads your CSV headers, selects the right waterfall variant, and enriches every row. The entire loop runs inside your IDE or terminal, composable with scraping, scoring, CRM sync, and outreach sequencing.
Honest: not ideal for
If you need data from one specific provider, use a direct tool call instead. Waterfalls are for outcome-based queries where the source does not matter, only the result. For provider-specific queries, Deepline exposes all 30+ providers as individual tools.
Execution
How waterfall enrichment works
Analyze input data
Deepline inspects your payload fields or CSV column headers to select the right waterfall variant. Name + company + domain routes to the default 6-provider chain. LinkedIn URL activates a LinkedIn-optimized chain. Name + domain without company triggers the cost-aware variant with pattern guessing.
Compile the provider chain
The selected play compiles into an ordered list of provider steps, each with a tool ID, payload template with variable interpolation, and an extraction function. The chain is ordered by cost: cheapest providers run first.
Execute the first provider
Deepline sends the request to the lowest-cost provider in the chain, usually Dropleads for the default email waterfall. Execution time per provider is typically 1-3 seconds.
Validate the result
If the provider returns data, Deepline extracts the target field and validates it. For email waterfalls, this includes checking that the address is not a catch-all, not a bounce, and not syntactically invalid. The cost-aware variant uses LeadMagic email validation to verify pattern-guessed addresses.
Fall through or stop
If validation fails or the provider returned no data, Deepline moves to the next provider. If validation passes, the waterfall stops immediately. Providers below the stopping point never fire and are not billed. Most lookups stop at provider 1 or 2.
Return structured output
The result includes the found value, the provider that resolved it, the number of providers attempted, and the total credits consumed. This output feeds directly into downstream enrichment steps, CSV columns, or CRM updates.
Try it
One command. Full waterfall.
# Single email lookup
deepline tools execute name_and_domain_to_email_waterfall \
--payload '{"first_name":"Sarah","last_name":"Chen","company_name":"Stripe","domain":"stripe.com"}'
# Bulk CSV enrichment
deepline enrich --input leads.csv --output enriched.csv \
--with '{"alias":"email","tool":"name_and_domain_to_email_waterfall"}'
# Or just ask in plain language (Claude Code / Codex)
# "Find work emails for everyone in leads.csv"
FAQ
Common questions
How much does waterfall enrichment cost per email?+
Most lookups resolve on the first or second provider at 0.2-0.6 credits ($0.016-$0.048). The cost-aware variant tries 3 deterministic email patterns first and can resolve for as little as 0.1 credits ($0.008). In BYOK mode, waterfall lookups are free through Deepline because you pay providers directly at their rates.
How does Deepline choose which waterfall variant to use?+
Deepline inspects your input fields, like payload keys or CSV column headers, and selects the variant that matches your available data. Name + company + domain uses the default 6-provider chain. LinkedIn URL activates a LinkedIn-optimized chain. Name + domain without company triggers the cost-aware variant. You can also specify the exact waterfall by tool ID to override automatic selection.
What happens when no provider finds an email?+
The waterfall tries every provider in the chain. If none returns a valid result, the output is null for that row. You are charged only for providers that executed. Deepline does not fabricate results. A null result means the contact could not be resolved from any of the 30+ production providers.
Can I customize the provider order or exclude providers?+
The built-in waterfall plays use a fixed cost-ordered chain optimized for price-performance. For custom chains, break the waterfall into individual tool calls and orchestrate them yourself using deepline tools execute or deepline enrich with multiple --with steps. You can also use the plays API to inspect and modify the compiled chain programmatically.
How does waterfall enrichment compare to single-provider lookups?+
No single provider has complete email coverage. B2B contact data decays at roughly 20-25% per year, so any single source goes stale fast. The 6-provider waterfall cross-references multiple sources in real time, and each additional provider fills gaps the previous ones missed. That incremental coverage translates directly to more contacts reached per campaign.
Run a multi-provider waterfall from one command
Deepline handles provider ordering, validation, and early-stop logic automatically.