Search whole areas
search_areasThe search to use for coverage. Sweeps each area with a grid of map points live against Google Maps, as a background job, the same search the Lyre Leads Search page runs. In Houston this found 1,061 roofing contractors where paging from one centre found 255. Costs 1 lead per NEW business; listings the account already holds cost nothing (a small per-page minimum applies). Every new business is enriched, relevance-checked, its address verified, and enrolled in the monthly re-check automatically. Returns job_id: poll get_job_status with kind "search" until finished is true, then read the leads with get_search_results. If an area name fits more than one place, the call returns the candidates with ids and starts nothing: ask the user which one they mean and resend with that id. At most two searches run at once per account.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | grid (default here) covers the whole area; city pages from the centre | |
| areas | Yes | Area names like "Houston, Texas", or ids from find_areas | |
| query | Yes | Business keyword, e.g. "roofing contractor" or "cosmetic dentist" | |
| country | Yes | Country name, as listed by find_areas |