Lesson 3 of 7

Lesson 2.1.3

The enrichment waterfall, and what charged on success really means

6 min readIntermediate

What this costs

Free to read. The habits it teaches lower every later bill.

Before you start

Lesson 1.1.4.

Charged on success sounds like a guarantee that you never waste a credit. It is not. It is a guarantee about misses, and understanding exactly what it does and does not cover is how you stop being surprised by a bill on a list that mostly came back empty.

What the phrase covers

  • A row where the tool found nothing costs you nothing. That is the whole promise.
  • A row where the tool found something costs the unit price, once per result if the tool returns several.
  • It says nothing about quality. A found value that is wrong is still a success as far as charging is concerned.
  • It does not apply to tools that reason or verify. Those are charged on run, because the work happened either way.

Running a waterfall

A waterfall is several attempts at the same field in cheapness order, where each attempt only runs on rows the previous one missed. Cheapest and most reliable first, expensive and broad last.

  1. 1

    Attempt one: what you already have

    The source often supplies the field for a portion of rows. That portion is free. Filter it out of every subsequent attempt.

  2. 2

    Attempt two: the cheap deterministic tool

    Runs on the remainder only, via a condition on the first column being empty.

  3. 3

    Attempt three: the expensive or agentic tool

    Runs only on what is still empty. By now that is a small fraction of the original table.

  4. 4

    Stop when the marginal cost stops making sense

    The last 8 percent of a field usually costs more than the first 70. Decide in advance whether you actually need it, or whether those rows are simply out.

Worked example · A three step waterfall for company website on 1,000 rows

AttemptRuns onFillsStill emptySpend
From the source1,0004805200
Website Finder5203951251,040
Manual review or cut125your call00

Eighty seven percent coverage having paid for 520 rows rather than 1,000, and the decision about the last 125 rows is yours to make with full information rather than as a surprise at the end.

Check yourself

0 of 2 answered

1.What does charged on success actually protect you from?

2.In a waterfall, what runs first?

Answer all 2, then open Build your own research step in plain English to tick this lesson off.

Try it yourself

Pick one field you enrich on every list. Write out a three step waterfall for it: what the source gives free, what the cheap tool adds, and where you stop.

You have done it when
You can state the coverage and the cost at each of the three steps.
Credit budget
Free to plan.