API

Search for businesses

Run a live local-business search — every delivered lead fully verified.

POST/api/v1/search

Runs a live discovery search and returns the first batch of listings immediately, spending 1 lead per result. In the background we expand the search to find more matching leads and verify every one — up to 3 emails and 3 phones checked, plus the owner name where we find one. There's no separate enrichment charge: 1 lead = 1 fully-verified listing. Poll the search (below) until enrichment is "complete" for the full results and settled balance.

query	Required. The niche/keyword, e.g. "electrician".
location	City string, e.g. "Austin, TX". (Or pass location_code.)
location_code	Optional. Exact code from /locations (skips lookup).

json

{
  "search_id": "b3e1...c4a",
  "query": "electrician",
  "location": "Austin, TX, Texas, United States",
  "delivered": 20,
  "found": 20,
  "credits_remaining": 80,
  "enrichment": "pending",
  "more_results": "pending",
  "poll": "/api/v1/searches/b3e1...c4a",
  "results": [
    { "rank": 1, "name": "Bluebonnet Electric Co", "category": "Electrician",
      "phone": "+1 512 555 0112", "rating": 5.0, "website": "https://…" }
  ]
}

Each additional lead the worker finds spends 1 lead and is verified — no separate enrichment charge. The poll endpoint reports the settled balance once it's done.