Google Maps Scraper

What does Google Maps Scraper do?

Google Maps Scraper extracts business leads from Google Maps for a single search keyword. Give it a query like dentists in Austin TX, and it returns structured place data you can export to JSON, CSV, Excel, or feed into automations.

This Actor wraps the GMaps Lead Finder Agent API. You bring your own API key (BYOK). Scraping credits are charged on your GMaps Lead Finder account; Apify only charges for the platform compute used while the Actor runs.

What data can you extract?

Typical fields include (exact columns follow your GMaps Lead Finder export preferences):

Field	Description
Name	Business name
Phone / Phones	Contact numbers
Website / Domain	Website URL and domain
Emails	Public emails when found
Fulladdress / Street / Municipality	Address parts
Categories / About	Category and description
Average Rating / Review Count	Ratings
Google Maps URL / Place Id	Maps identity
Social links	Facebook, Instagram, LinkedIn, etc. when found
Search Keyword	The keyword you ran

Empty email or social fields mean nothing public was found — the Actor does not invent contacts.

Why use it on Apify?

• Run from Console, API, or schedule
• Export datasets and connect to Zapier, Make, n8n, Google Sheets, and more
• Monitor runs, retries, and logs in one place
• Same Actor API for scripts and agents

---

How to use

1. Create a GMaps Lead Finder account on a Growth+ plan (Agent API access).
2. Copy your API key from Account → API key. Keys look like gmf_ + hex.
3. Open this Actor on Apify → Input.
4. Set Search keyword (one query) and paste API key.
5. Optionally set Max results to cap how many places are written to the dataset.
6. Click Start. When the run finishes, open the Dataset tab (or use the Apify API) to download results.

Input example

{
    "keyword": "dentists in Austin TX",
    "apiKey": "gmf_your_key_here",
    "maxResults": 100
}

Field	Required	Description
keyword	Yes	Exactly one Google Maps search query (1–500 characters).
apiKey	Yes	Your GMaps Lead Finder key (gmf_…). Marked secret in the UI.
maxResults	No	Cap rows pushed to the Apify dataset. Billing on GMaps Lead Finder still follows places returned by the job.

Output example

Each dataset item is one place (field names match export column headers):

{
    "Name": "Austin Dental Care",
    "Phone": "+1 512-555-0100",
    "Website": "https://example.com",
    "Emails": "info@example.com",
    "Fulladdress": "123 Main St, Austin, TX 78701",
    "Categories": "Dentist",
    "Average Rating": "4.8",
    "Review Count": "212",
    "Google Maps URL": "https://www.google.com/maps/place/...",
    "Place Id": "ChIJ...",
    "Search Keyword": "dentists in Austin TX"
}

---

How much does it cost?

Apify platform

This Actor uses pay per usage: you pay Apify for compute units consumed while the run is active (waiting for the hosted scrape job and writing the dataset). Light keyword runs are usually inexpensive because the heavy lifting happens on GMaps Lead Finder’s servers.

GMaps Lead Finder credits

Your API key’s account is charged 1 credit per place returned. You need a Growth or higher plan for Agent API access. See pricing.

Example: a keyword that returns 80 places uses about 80 credits on GMaps Lead Finder, plus a small Apify compute charge for the Actor run.

---

Tips for better results

• Put business type + location in the keyword (plumbers in Brooklyn NY, not just plumbers).
• Run one keyword per Actor run. The API accepts exactly one keyword per job.
• Only one job can run at a time per GMaps Lead Finder account. If you see a 409 error, wait for the other job to finish.
• Prefer specific neighborhoods or cities when national queries return too many (or too few) useful leads.

---

FAQ

Is this an official Google product?

No. This Actor is not affiliated with, endorsed by, or sponsored by Google LLC. “Google Maps” is used only to describe the data source.

Why are Emails empty?

Empty Emails (or social fields) means no public contact was found for that place. That is normal and not an Actor failure.

What do common errors mean?

Code	Meaning	What to do
401	Bad or missing API key	Regenerate the key at the account page
402	No credits left	Top up or upgrade on pricing
403	Plan cannot use Agent API	Upgrade to Growth+
409	Another job is in flight	Wait, then retry
Timeout	Job took too long	Retry or narrow the keyword

Can I scrape reviews or photos?

This Actor covers keyword → business leads only. Reviews and photos are available via the same GMaps Lead Finder API / SDKs; separate Actors may be published later.

How do I call it from code?

Use the Apify API or client libraries to start a run with the input JSON above, then fetch dataset items when the run succeeds. Full Agent API docs: gmapsleadfinder.com/docs/api.

---

Local development

npm install
cp INPUT.example.json storage/key_value_stores/default/INPUT.json
# edit INPUT.json with your real gmf_ key
apify run
npm test

Deploy:

apify login
apify push

---

Support

• API docs: https://gmapsleadfinder.com/docs/api
• Get an API key: https://gmapsleadfinder.com/account#api-key
• Pricing: https://gmapsleadfinder.com/pricing

Legal

Use scraped data in compliance with applicable laws, Google’s terms, and your own privacy obligations. You are responsible for how you process and store personal data obtained from public listings.