← all playbooks

See the count and the cost before a search spends anything

A short quote for the run you described: how many people or companies match, which steps are free and which spend credits, the most the full run could cost, and the real charge from a one-record pilot. Nothing beyond that pilot has been bought.

use when
you are about to run a search or an enrichment, and you want to know how many records it will touch and what it will cost before you say yes
starts from
A job spec

The prompt

Paste it into Claude Code or the Claude desktop app with Hyreflow connected. The first line tells your agent to use Hyreflow, so it reads the play, asks before it spends anything, and hands the work back to you.

paste this into Claude
Use hyreflow and tell me how many people this search will find and what
the whole run will cost before you spend anything.

The role: <PASTE THE JOB SPEC, OR DESCRIBE THE SEARCH>. Location:
<LOCATION>. I want <HOW_MANY> people, each with <WHAT_I_WANT_FOUND>.

Do not pull anyone yet.
- Count the matches first, on the smallest page each database will sell
  you. Tell me which counts were free and which cost one small request.
- Add my filters one at a time and show me the count after each. If a
  count does not drop, say so: the filter was ignored.
- List every step of the full run and mark it free or paid, with what it
  bills on: per person found, per request, or on usage.
- Give me the most the full run could cost, not an average. My ceiling is
  <BUDGET_IN_CREDITS>. Tell me what fits under it.

Then run one record end to end first, and tell me what it really cost and
what the full run costs before you do the rest. Wait for my answer. I
will approve the full run, a smaller one, or nothing.

Replace every <PLACEHOLDER> with your own detail. Everything else can stay as written.

What you need first

  • The run in plain words: the job spec or search, how many people you want, and what you want found for each
  • A Hyreflow workspace. The counts cost nothing or one small request each, and the pilot is one record
  • A ceiling in mind, so the agent can tell you what fits under it
  • Optional: your own Apollo key for one more count. Apollo is bring-your-own-key and uses no Hyreflow credits

Tools it can reach for

The agent picks per step from what your workspace has. Nothing here is required by name.

What happens when you run it

Free steps are marked free. Anything that spends credits is marked, and the agent asks before the first paid run of any size.

  1. 1

    Write the run down as steps

    free

    The ask becomes a plan: the search, the work history pull, the contact lookup, the deliverability check, any scoring or drafting. Each step is marked free or paid, and a paid step says what it bills on: per person found, per request, or on usage.

  2. 2

    Count the matches without buying them

    credits

    People databases report a total alongside any page. One source previews a search free and gives its total. The others give the total with the smallest page they sell, so a count costs one small request and not the list.

  3. 3

    Check the count is believable

    credits

    Filters are added one at a time, and each has to lower the count. A total the size of the whole database means a filter was silently ignored, and a run built on it would buy strangers.

  4. 4

    Preview the run with no call made

    free

    A dry run shows which providers the search or the enrichment would call, in what order, with what each would be sent and what it would charge. No call is made and nothing is spent.

  5. 5

    Price the full run at its worst case

    free

    Each paid step is priced at its listed rate for the rows that reach it. Where an option raises the rate, such as adding a mobile, the higher rate is used. AI steps are metered on usage, so they are quoted as an estimate and labelled as one.

  6. 6

    Run one record end to end

    credits

    One real record goes through every step. What it was charged is set beside what the quote predicted for a single row, and a pilot that fails is fixed and run again before you are asked anything.

  7. 7

    Put the quote in front of you

    free

    Four parts: the assumptions made, the pilot record as it came back, the providers with the estimated credits, scope and spending cap, and one question. Approve or cancel. Silence is not approval, and nothing paid runs without it.

What a run costs

Credits are spent per candidate the play actually works, and a lookup that finds nothing usually costs nothing. The two figures are the run where the first provider answers and the run where every lookup walks its full chain.

candidatesif the first provider answersif every lookup walks the chain
25under $13.2 creditsunder $15.8 credits
100under $13.2 creditsunder $15.8 credits
500under $13.2 creditsunder $15.8 credits
1,000under $13.2 creditsunder $15.8 credits

Free before anything is charged

  • Write the run down as steps
  • Preview the run with no call made
  • Price the full run at its worst case
  • Put the quote in front of you

What moves the number

  • The channel. This play buys personal email, because these are candidates, and a work inbox is the wrong place to approach one. A personal address costs more to find than a work one.
  • Coverage on personal email. The chain stops at the first provider that answers, and only that provider bills.
  • How many candidates survive the free filters. Everything dropped before the paid steps costs nothing.
  • Providers you connect with your own key. Those calls bill your account, not your credits.

An estimate, not a quote, priced at the volume credit rate. Your agent sizes the run against your own workspace and tells you what it will cost before it spends anything.

Approve a number, not a surprise

Every data tool will tell you what one lookup costs. Few will tell you what your run costs, because that depends on things nobody has looked at yet: how many people match, how many steps each of them passes through, which steps bill on a hit and which bill for trying. The usual way to find out is to run it and read the bill.

Hyreflow can answer before it spends. Databases report how many records match a search without selling you the records. Every method carries a listed rate and says what it bills on. A run can be previewed with no call made. Put together, that is a quote: a count, a list of steps marked free or paid, and the most the whole thing could cost.

Sizing a talent pool before you pitch uses the same counts to win an argument with a client. This play uses them to decide what you are willing to buy.

What you get back

A short quote. The count after each filter, with the source of each number. The steps of the full run, each marked free or paid and what it bills on. The most the run could cost, with any usage-metered step labelled as an estimate. The pilot record exactly as it came back, and what it was charged. Then one question: approve it, shrink it, or stop.

Variations worth knowing

Work backwards from a ceiling. Give a budget and ask what fits: fewer people, or the same people with the dearest step left out.

Price a list you already hold. For a list you already have the row count is known, so the quote is the rows that can be matched at the worst case per row.

Companies, not people. Company searches report totals the same way. Size the account list before you look for anyone inside it.

Where this goes wrong

An implausibly large count. A total close to the size of the whole database means a filter was dropped without an error. Add filters singly and watch the number fall. If it does not, the search is wrong. The market is not that large.

Reading the maximum as the bill. Most lookups charge on a hit, so the real cost usually lands under the quote. Budget to the maximum anyway.

Empty results that still cost. A per-request search charges for an empty page, and a search no database can answer ends in paid web searches.

Counts are a floor. A database counts the people it holds, under the titles they chose. The number sizes the run. It is not a census.

Counting in one place and pulling from another. Each database matches titles its own way, so size the run on the source that will do the pull.

Questions

Are the counts really free?

Some are, and the rest cost one small request. One people database previews a search without charge and reports the total. The others bill by the page or by the row and report the total on any page, so the agent asks for the smallest page there is and reads the number. A count in your own connected ATS is a read of your own system and is free. A full funnel is a handful of those requests.

Why is the quote a maximum and not an expected cost?

Because the honest unknown is how many rows will be found. Most contact lookups bill on a hit, so a list where many people cannot be found lands well under the maximum. Nobody knows your hit rate before the run, and a quote built on a guessed one is the kind that gets exceeded. The pilot and the first rows of the real run show how far under the maximum you are landing.

Can a search that finds nobody still cost something?

Yes. Some databases bill per request, so an empty page is still a request. And a company-scoped search that every database misses falls through to public web searches at the end of the chain, which charge for running whether or not they find anyone. A sweep across many small or obscure companies is budgeted with that in mind, and the quote says so.

What if I only have a fixed budget?

Say the ceiling and the agent works backwards: how many people fit under it with every step included, or how many more fit if you drop the dearest step, which is usually the mobile. You can also set a spending limit on the session. When the run reaches it, the remaining rows are marked as not attempted, which is different from not found, and rows already paid for are kept.

Does this work for an enrichment on a list I already hold?

Yes, and it is simpler, because the row count is known. The agent reads the file, sets aside rows that cannot be matched or already hold the detail, and prices the rest at the worst case per row. If your balance cannot cover that figure, you hear it before the run starts, not when rows start coming back empty.