Google Maps Business Lead Finder & Scoring

Find local businesses by keyword and location, enrich public company contacts, remove duplicates, and rank every lead by outreach potential.

What this Actor does

1. Searches one business niche in a city, region, or country.
2. Calls the maintained compass/crawler-google-places Actor with a hard downstream spending cap.
3. Optionally enriches public emails and social profiles from company websites.
4. Removes duplicate, closed, incomplete, and wrong-country records.
5. Applies rating, review-count, and website filters locally.
6. Scores every result from 0 to 100 and assigns priority A, B, or C.
7. Exports a clean dataset ready for CSV, Excel, APIs, CRMs, or outreach research.

Example use cases

• local business prospect lists for agencies and freelancers;
• website-development prospects with no listed website;
• reputation-management prospects with lower Google ratings;
• CRM enrichment with public business phones, emails, and social profiles;
• market maps for dentists, salons, contractors, restaurants, clinics, and other local services.

Input example

{
  "searchTerm": "beauty salon",
  "location": "Singapore",
  "countryCode": "SG",
  "maxResults": 50,
  "includeContacts": true,
  "skipClosedPlaces": true,
  "minimumRating": 0,
  "maximumRating": 5,
  "minimumReviews": 0,
  "websiteFilter": "all",
  "sortBy": "lead-score",
  "maxDownstreamChargeUsd": 0.5
}

Main options

Field	Default	Description
searchTerm	beauty salon	Business type or query.
location	Singapore	City, region, or country.
countryCode	SG	Optional ISO country code for localization and validation.
maxResults	50	Maximum places requested from the underlying Actor.
includeContacts	true	Extract public company emails and social profiles from websites.
strictCountryCode	true	Remove results outside the requested country.
requireRelevantCategory	true	Remove unrelated businesses using names, categories, and common synonyms.
minimumRating / maximumRating	0 / 5	Local post-processing filters.
minimumReviews	0	Local minimum review count.
websiteFilter	all	All, with website, or without website.
sortBy	lead-score	Lead score, reviews, or rating.
maxDownstreamChargeUsd	0.5	Hard cap passed to the underlying paid Actor.

Output

Each dataset item contains:

• lead priority and numeric lead score;
• business name, category, address, city, and country code;
• public phone, website, emails, Instagram, Facebook, and LinkedIn links;
• Google rating, review count, Maps URL, result rank, and Place ID;
• a suggested outreach angle;
• source and downstream run identifiers for traceability.

The OUTPUT key-value store record includes counts, timing, downstream usage, and the proxy policy.

Lead scoring

The transparent score rewards records that are easy to contact and commercially useful:

• phone: +25;
• public email: +20;
• website: +15;
• at least one social profile: +10;
• 30 or more reviews: +10;
• 100 or more reviews: +5;
• rating of 4.3 or lower: +10;
• no website: +5 for website-service potential.

Priority A starts at 70, priority B at 50, and the remaining results are priority C.

Cost and dependency disclosure

This Actor calls the public, limited-permission compass/crawler-google-places Actor. That Actor's pay-per-event charges are billed to the user running this Actor. Contact enrichment and closed-place filtering are optional paid features. Use maxDownstreamChargeUsd to control the maximum downstream charge; actual cost can be lower.

This wrapper may also have its own Store pricing shown on the Pricing tab. Always review both prices before running large jobs.

Residential proxy policy

This Actor does not create or accept an Apify proxy configuration and never enables a residential proxy group. The downstream Actor currently exposes no proxy input; its internal network routing is controlled by its publisher. If that dependency later requires an explicit residential proxy configuration, this Actor should stop and be revised instead of silently enabling one.

Responsible use

The output contains public business information. Users are responsible for complying with applicable website terms, privacy rules, anti-spam requirements, and local laws. Do not use the results for harassment or indiscriminate messaging.

Local development

npm install
npm test
npm run build