$5 free Limited time. Sign up to activate. Get your $5 →
Glossary · Enrichment methods

What is waterfall enrichment?

Waterfall enrichment is a data enrichment method that queries several providers in a set order until a field such as a mobile number or work email is found. Each provider only sees the records the providers before it missed.

Also called: enrichment waterfall · multi-provider enrichment · sequential enrichment

Waterfall enrichment in practice

A waterfall exists because no single provider holds every mobile number or email. By chaining providers, a team raises the share of records that end up with a filled field, while paying each provider only for what it adds.

The order matters. Teams usually put the provider with the best results on their own sample first, then the others. Pay-per-result providers can sit anywhere, because a miss costs nothing. Flat-fee or per-request providers are usually placed where their hit rate justifies the charge.

Waterfalls are built in tools like Clay, in GTM workflow builders, or in code. Forager is designed to be one slot in your waterfall: send the key, get a number or an email back, pay only when something is found.

How an enrichment waterfall runs

  1. Order the providersDecide the sequence per field. The sequence for mobiles can differ from the sequence for work emails.
  2. Send the key to provider 1A LinkedIn URL, email or name and company. If a value comes back, the record stops here.
  3. Pass misses downOnly records with no value go to provider 2, then 3. Each slot sees a smaller, harder set.
  4. Validate and stopSome teams add a validation step after a hit (does the number connect, does the email bounce) before the waterfall stops for that record.
  5. Count the costAdd up what each slot charged. With pay-per-result slots the misses are free; with per-request slots they are not.
waterfall enrichment: diagram Each slot only receives the records the slots above it missed. The waterfall stops for a record when a value is found. miss ↓miss ↓found · stop Provider 1 Provider 2 Forager Provider 4
Each slot only receives the records the slots above it missed. The waterfall stops for a record when a value is found.

Waterfall vs single provider

WaterfallSingle provider
Hit rateThe union of every provider on your sampleOne provider's hit rate
Cost per recordSum of what each slot charged; misses on pay-per-result slots cost nothingOne price, charged per that provider's rule
SetupA workflow tool or code that passes misses downOne API call
Quality controlNeeds a validation step, since each provider verifies differentlyOne provider's own checks

Limits and when not to use it

  • More slots mean more vendors to contract with and more rules to keep in step. Three slots that each add something beat eight that mostly repeat each other.
  • A hit in slot 1 stops the record, even when slot 2 would have returned a better value. Put the provider you trust most for that field first.
  • Per-request providers charge for the records they miss. Place them where their hit rate pays for the misses, or after the pay-per-result slots.
With Forager

How waterfall enrichment works with Forager

Forager is built as a waterfall slot: mobile numbers at 15 credits per number found, work emails at 5 credits per email found, personal emails at 5 credits per email found. A mobile or email lookup that returns nothing costs 0 credits. In Clay, Forager is a native enrichment provider you can add as a column in your waterfall.

  • $5 free credits
  • No credit card
  • Run your sample

Questions about waterfall enrichment

What is waterfall enrichment?

A chain of data providers queried in order. A record goes to the first provider; if that provider returns nothing, the record goes to the next. The chain stops for a record as soon as one provider returns the field.

Why use a waterfall instead of one provider?

No single provider holds every mobile or email. Chaining providers raises the share of records that end up filled, and with pay-per-result providers the extra slots cost nothing on misses.

Which provider should go first in a waterfall?

The one with the best results on your own sample for that field. Run the same records through each candidate, compare hit rate and whether the numbers connect, and order by that.

Does Forager charge when it is a slot that finds nothing?

No. A mobile or email lookup that returns nothing costs 0 credits. You pay 15 credits per mobile found and 5 credits per work email found.

Can I add Forager to a Clay waterfall?

Yes. Forager is a native enrichment provider in Clay, so it can be added as a column in a waterfall alongside your other providers.

Start building

Test it on your own records

Create an account, start with $5 in credits and measure hit rate and connect rate on a sample you choose.

  • $5 free credits
  • No credit card
  • Run your sample
Platforms and teams that build on Forager
  • Clay
  • Juicebox
  • Nooks
  • Andela
  • HubSpot
  • SeekOut