Prospect leads
prospect_leadsSearches Google Business listings for a niche and saves new businesses to the project's lead list (deduped by place and domain). Two modes: city (locationCode — a Google Maps search for the niche in that city) or coordinate (latitude/longitude/radiusKm). Stores each listing's coordinates and profile depth (photos, categories, 24h hours) so research_lead can check pack positions around the business. Use list_leads to read the list back.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | Yes | City label stored on saved leads (e.g. 'Worcester'). | |
| limit | No | Maximum businesses to fetch (1-100). Defaults to 20. | |
| niche | Yes | Niche label stored on saved leads (e.g. 'dentist'). | |
| query | No | Business name or title text to match. | |
| latitude | No | Coordinate mode: search-center latitude. | |
| radiusKm | No | Coordinate mode: search radius in kilometers. | |
| longitude | No | Coordinate mode: search-center longitude. | |
| projectId | Yes | Required. The HarborRank project ID to scope this call to. Get one from list_projects. | |
| categories | No | Business category slugs to filter by (e.g. 'dentist', 'roofing_contractor'). | |
| locationCode | No | City mode: a DataForSEO SERP location code — searches Google Maps for the niche in that city. Alternative to latitude/longitude. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| added | Yes | ||
| found | Yes | ||
| skippedExisting | Yes |