Skip to main content

Lead Finder

Lead Finder is an API workflow for finding potential clients and turning them into richer prospect records. It has two entry points: search for new leads first, or enrich prospects that already exist in your Woodpecker database.

Use lead search and enrichment when you want to build a new audience: for example, founders in a selected industry, managers in a specific country, or personas matching another set of Lead Finder criteria. These leads are not coming from the main Woodpecker prospects tab yet. You discover them through Lead Finder search, then queue selected lead records for enrichment.

Use prospect enrichment when the prospects are already in your Woodpecker prospect database and can be found through the Prospects endpoints. In this flow, you submit existing prospects by email, with any helpful context such as name, LinkedIn URL, company name, or company website. The enrichment job works on matching existing prospect records; it is not a discovery search.

How the flow works​

Lead Finder enrichment is asynchronous. Queue endpoints return a batch uuid and a queue status, not the finished enrichment result. Store that uuid, then poll the relevant list or get endpoint until the records finish processing.

Credit usage

Some Lead Finder calls use account credits. Searching for leads and viewing returned lead data costs 1 credit per lead. For enrichment requests, credits are applied only when enrichment finds data: 1.5 credits for enriching a lead and finding an email, or 1.5 credits for successfully enriching an existing prospect. GET endpoints used to read criteria or check enrichment status do not use credits.

For new leads, the usual flow is:

  1. get the available search criteria
  2. fetch allowed values for controlled criteria
  3. search for matching leads
  4. queue selected leads for enrichment
  5. check the enrichment batch until it is processed and available in your campaigns or the prospect database

For existing prospects, start from the prospects already stored in Woodpecker, queue them for enrichment, then check the returned batch or status records until processing finishes.

Next steps​

Read Lead search and enrichment if you want to discover and enrich new people. Read Prospect enrichment if you want to enrich records already present in your Woodpecker prospect database.