The same leads,
from your own code.

Search for leads

Find local businesses matching a trade and an area. Returns leads locked, exactly as the dashboard shows them: who and where, the grade, and whether we verified a way to reach them.

niche

string, required. The trade, e.g. "dentists".

location

string, required. Town, city or postcode, e.g. "Austin, TX".

limit

number. Defaults to 50. Up to 250 in an area we search live, and up to 500 in one we hold a full index for, which the response says.

playbook

string. What you sell, which decides how leads are graded: web_design, payments_pos, marketing_seo, booking_software, general_smb.

minRating

number, 1 to 5. Skip businesses rated below this.

minReviews

number. Skip businesses with fewer reviews than this.

webPresence

string: any, has_site, social_only or none.

adTracking

boolean. Only businesses with an advertising pixel (Meta, Google Ads, TikTok and others) on their website. A pixel is evidence of ad tracking, not proof of a live campaign.

contact

string: any, phone, email or both. Which contact details a lead must carry.

booking

string: any, has or none. Online booking found on their website, or confirmed absent. A site we could not read is left out either way.

payments

string: any, has or none. A POS or online payments provider (Square, Toast, Stripe and others) found on their website, or none found.

platform

string: any, builder (Wix, Squarespace, GoDaddy, Weebly, Duda) or wordpress.

{ leads: LockedLead[], notes: string[] }

• A locked lead carries no phone, email or address. Those are what a credit buys.
• The phone and mailbox are checked live when a lead is opened, not when it was found, so a credit never buys a contact that has since gone dead.
• Discovery may be served from our own index, and site audits from a short cache. The response says which, and how old it was.

Open a lead

Spend one credit to reveal a lead in full: verified phone, verified email, address, the grade breakdown and what to pitch.

leadId

string, required. The id from a search result.

{ lead: Lead, creditsLeft: number }

• The charge happens inside one database function, so two calls at once cannot spend two credits on the same business.
• If the phone and mailbox both turn out to be dead, you are not charged at all.

Your leads and balance

Every lead your account has opened, newest first and in full, with your credit balance and plan status. A lead a teammate opened is yours too, and is listed.

limit

number, 1 to 200. Defaults to 50.

offset

number. Where to start, for the next page.

{ credits: number, subscribed: boolean, totalUnlocked: number, leads: Lead[] }

Reveal the owner

The person who runs the business, where we can find one: name, role, and a personal email or profile if it exists.

leadId

string, required. Must already be open.

{ owner: Owner | null, creditsLeft: number }

• The lead has to be open first: selling the owner of a business you cannot otherwise see would be selling a fragment.
• We find an owner on roughly four in ten businesses, and it varies by trade: a dental practice or a vet usually names the practitioner, a restaurant or a salon usually does not. When we are not confident, we return null rather than a guess.

Write the first email

A first cold email to an opened lead, written from what we found there: the specific problem, the change, the hiring post. Edit it and send it from your own mailbox.

leadId

string, required. Must already be open.

{ subject: string, body: string, ai: boolean, to: string | null }

• The draft uses only facts we checked about the business. It never invents details, results or client names.
• ai is false when the draft came from a template instead of the model, for example during an outage. It is still built from the same findings.
• The owner's name is used only if you have revealed the owner.

Export

Take leads out as a spreadsheet, a JSON payload, a printable call sheet, or under the column names HubSpot and Salesforce expect.

leadIds

string[], 1 to 1000 ids.

format

string: csv, xlsx, json, pdf, hubspot or salesforce. Defaults to csv.

A file, with the matching content type.

Enrich your own list

Send a CSV of businesses you already have and get it back with the gaps filled: verified phone and email, the owner where findable, and what we know about their website.

file

multipart/form-data, up to 500 rows.

A CSV with our columns appended, plus fl_status on every row.