Prospects: find and rank local businesses to pitch
find_prospectsFind local businesses an agency could win as clients, check each one's website quickly (tracking tags, Google Ads tag, inquiry forms including embedded ones, booking tools, tap-to-call, the site platform, the published business email) and rank them by how much the agency could fix for them, with the 1-3 strongest findings each in plain English. Works in any country, in one or several areas at once. Every filter is optional (v2, 10/20/26): Google listing filters (rating, review count, status, types, price level, website / no website, phone, radius around a place, service-area businesses, open weekends / 24 h), a business-age ESTIMATE (min_estimated_age_years: Google publishes no founding date, so age is estimated from the website domain's registration date and the oldest Google review we can see; always call it an estimate, never 'founded' or 'years in business'), and filters on our own website check (Google Ads tag seen or not, Analytics, a form, a booking tool, the site platform, a published email, a minimum opportunity score). Company size, revenue and owners' private details are not available: say so and offer review count instead. Skips the agency's clients, businesses it audited recently and businesses it already got in an earlier search (include_seen to see them again, free). Credits: one per business delivered (found, checked and returned); with strict filters at least one per 8 businesses scanned (Google bills each search page as 20); never more than count. Each area is at least one Google search, so several areas need a larger count (the preview says how much). Included each month: Free 10, Standard 50, Premium 100, plus 100 welcome credits once; packs on the dashboard. preview: true (or describe) shows the search and the credit estimate without running. When the run would use purchased credits it asks first: call again with confirm: true after the person agrees. Flow: find_prospects → show the ranked list → prospect_drafts for the ones they pick → they send from their own email, phone or CRM. Nothing is ever sent from here.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| form | No | An inquiry form seen (or confirmed absent; a JavaScript-built site is 'couldn't check', never 'no form') | |
| near | No | With radius_km: a place to measure from, e.g. 'Parramatta NSW' | |
| count | No | How many businesses to deliver (one credit each) | |
| social | No | Only businesses that link a social profile on their own site: ["any"], or any of these networks. These are the profiles the business publishes on its site, not a search of the networks; no channel is analysed. | |
| booking | No | An online booking or scheduling tool seen (or not) | |
| confirm | No | true = the person agreed to use purchased credits for this run | |
| exclude | No | Business names or website domains to leave out | |
| keyword | No | The trade or kind of business, e.g. 'solar installer', 'plumber', 'dentist'. Several trades: separate with commas, e.g. 'fence builder, shed builder, deck builder' (each trade in each area is its own search, so a larger count may be needed). Required unless describe is given. | |
| preview | No | true = show the search, the filters and the credit estimate without running | |
| website | No | required (default; the website check needs one), none = only businesses WITHOUT a website (a website sale), any | |
| describe | No | A plain-English description of who to find, e.g. 'solar installers in NSW that have been around a while'. Turned into the search above and returned as a preview; nothing runs from it. | |
| location | No | One city, region or postcode, any country, e.g. 'Sydney NSW', 'Leeds UK', '84604' | |
| open_24h | No | Open 24 hours, from the listing's hours | |
| platform | No | The site is built on one of these | |
| analytics | No | Google Analytics / Tag Manager seen (or not) | |
| form_kind | No | How they take inquiries: funnel (a funnel or landing builder such as HighLevel, ClickFunnels, Leadpages, Unbounce, Instapage, Kartra, Kajabi, Systeme.io), form_tool (an embedded form service such as Typeform or Jotform), basic_form (a plain HTML form), none_seen (we read the pages and saw none). A site built with JavaScript is never counted as none_seen. | |
| has_phone | No | Only listings with a phone number | |
| locations | No | Several areas in one run, e.g. ['Sydney NSW', 'Newcastle NSW', 'Perth WA']; results are deduplicated across them | |
| radius_km | No | Only businesses within this many km of near (from the listing's map pin) | |
| max_rating | No | Google rating at most this (lower ratings are more reputation work to sell) | |
| min_rating | No | Google rating at least this | |
| email_found | No | A business email is (or isn't) published on their own site | |
| max_reviews | No | At most this many Google reviews | |
| min_reviews | No | At least this many Google reviews (a proxy for size and age; Google publishes no company size) | |
| include_seen | No | Also return businesses this account got in an earlier search (free, never charged) | |
| price_levels | No | Google's price level (mostly restaurants and shops; most trades have none) | |
| primary_type | No | The listing's main Google Places type must be this | |
| service_area | No | Service-area businesses with no storefront (most trades): include (default), exclude, or only | |
| exclude_types | No | Google Places types to leave out | |
| include_types | No | Google Places types, any of them, e.g. 'solar_energy_system_service', 'plumber', 'electrician' | |
| min_locations | No | At least this many physical locations: an ESTIMATE from several Google listings sharing the website, addresses in the site's business details, or a locations page in its navigation ("several" counts as 2). Say it is an estimate. | |
| open_weekends | No | Open on Saturday or Sunday, from the listing's hours | |
| google_ads_tag | No | A Google Ads tag seen (or not) on their site: an advertising signal, not proof of current spend | |
| business_status | No | Default: OPERATIONAL only | |
| marketing_active | No | true = already marketing (a funnel, a Google Ads tag, a Meta pixel, or 3+ tracking tags); false = none of those seen. Separate from opportunity_score, which is how much an agency could fix. | |
| must_have_website | No | Older name: false = website any | |
| min_opportunity_score | No | Only businesses with at least this opportunity score (how much the agency could fix) | |
| min_estimated_age_years | No | Business age ESTIMATE at least this many years: the older of the website domain's registration date and the oldest Google review we can see. Google publishes no founding date, so this is a lower-bound estimate; businesses whose age can't be estimated are left out. |