# Google Maps Lead Scraper - Extract Business Leads (`sionex/gmaps-crawlee`) Actor Pull thousands of business leads from Google Maps in minutes. Pick a query and a region, get every business with name, phone, website, address, rating, reviews, and place ID. No browser, no captcha, no API quota. Any country, state, city, or custom area. Optional owner-reply check. - **URL**: https://apify.com/sionex/gmaps-crawlee.md - **Developed by:** [Muhammad Yaser](https://apify.com/sionex) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.0001 / actor start This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Google Maps Lead Scraper — Bulk Business Leads to CSV **Scrape unlimited Google Maps business leads from any region.** Tile a bounding box (country, state, city, custom area) into a lat/lng grid, hit Google's internal `search?tbm=map` endpoint over plain HTTP, and dedupe by `placeId`. Pull business **name, phone number, website, address, rating, review count, lat/lng, and place ID** for every business Google Maps knows about — no browser, no captcha hell, no Google Maps API quota. **Why this scraper is different:** normal Google Maps scraping is capped at ~100 results. The official Google Maps API charges per request and has tight quotas. This Actor bypasses both by tiling the region into a grid of small lat/lng cells and pulling 20 results per cell — thousands of unique leads per run, deduplicated by `placeId`. **Use cases:** B2B sales lead generation · local business research · marketing lists · real estate comps · franchise research · competitor analysis · outreach prospecting. **Try it free** — default input is `query="plumbers"`, region `"washington"`, no card required during the Apify free trial. --- ### What this Actor extracts For each business, you get: - `name` — business name - `category` — Google Maps category (e.g. `Plumber`, `Restaurant`) - `phone` — phone number - `website` — business website URL - `address` — full street address - `rating` — Google star rating (e.g. `4.8`) - `reviews` — total review count - `lat`, `lng` — latitude and longitude - `placeId` — Google's stable place ID (use this to fetch more later) - `mapsUrl` — shareable Google Maps URL - `ownerReplied` — (optional) `1` if the owner has replied to any review, `0` if not, `null` if not checked ### How it works 1. Splits the bounding box into a grid of lat/lng tiles. 2. Fires one HTTP request per tile, paginating 20 results at a time per tile while pages come back full. 3. Deduplicates by `placeId` so overlapping tiles never produce duplicates. 4. Pushes each unique lead to the **default Dataset** and (optionally) writes a CSV to the **default Key-Value Store**. 5. If `checkOwnerReplies=true`, fires one extra HTTP request per lead to fetch that place's review data and mark whether the owner has replied to any review. This breaks the ~100-result cap of normal Google Maps scraping by hitting Google's internal search endpoint, not the public site. ### Why use this Actor instead of the Google Maps API or other scrapers? | | **This Actor** | Google Maps Places API | Browser-based scrapers | | --- | --- | --- | --- | | Cost | Free during trial, then $5/mo+ | $0.007–$0.032 per request | Tooling + proxy costs | | Quota | None | $200/mo free credit, then pay-per-call | Depends on proxy | | Result cap | None (tiles the region) | 60 results per query | ~100 per session | | Output | Dataset + CSV | JSON | CSV / DB | | Phone, website, rating, reviews | ✅ all included | ⚠️ some fields require separate calls | ✅ | | Owner-reply check | ✅ optional | ❌ | ❌ | | Set-up | Zero code | API key + billing | Local browser + config | If you need more than ~100 leads per search, or you don't want to manage a Google Cloud billing account, this Actor is a better fit. ### Example queries (just paste in the input) | Vertical | Try | | --- | --- | | Home services | `plumbers`, `electricians`, `hvac repair`, `roofing contractors`, `locksmith`, `pest control`, `landscaping`, `painters` | | Health & medical | `dentists`, `chiropractors`, `dermatologists`, `urgent care`, `physical therapy`, `optometrists` | | Real estate | `real estate agents`, `property management`, `real estate attorneys`, `title company` | | Auto | `auto repair`, `tire shops`, `car dealerships`, `car wash`, `body shops` | | Food & hospitality | `restaurants`, `cafes`, `bars`, `caterers`, `food trucks`, `wedding venues` | | Professional services | `accountants`, `lawyers`, `financial advisors`, `tax preparation`, `notary` | | Retail | `florists`, `boutique stores`, `furniture stores`, `jewelry stores`, `pet stores` | | B2B / industrial | `manufacturers`, `warehouses`, `machine shops`, `commercial cleaning` | Any service-business query works — Google Maps indexes tens of millions of them. Use a custom region to target a single city, state, country, or your own lat/lng bounding box. ### Input | Field | Type | Default | Notes | | --- | --- | --- | --- | | `query` | string | `plumbers` | Search term, e.g. `plumbers`, `hvac repair`, `restaurants` | | `region` | string | `washington` | Preset name (`washington`, `gujrat-pk`) **or** a custom spec: `custom:latMin,latMax,lngMin,lngMax,latStep,lngStep` | | `maxPagesPerTile` | int | `5` | 20 results per page. 5 = up to 100/tile. Higher = more uniques in dense cities but more requests. | | `saveCsv` | bool | `true` | Also write `-.csv` to the default Key-Value Store | | `checkOwnerReplies` | bool | `false` | For each lead, fetch place details and set `ownerReplied=1` if the owner has replied to at least one review, `0` if not, `null` if undetermined. Requires `pb-place-template.json` (see below). Adds ~1 extra HTTP request per lead. | For a custom region, get the bbox from [OpenStreetMap's export view](https://www.openstreetmap.org/export) and pick `latStep` / `lngStep` based on density (~0.3°/0.45° is ~33 km — good for whole states; ~0.08°/0.09° is ~9 km — good for dense cities). ### Output **Default Dataset** — one item per lead, columns: ```` name, category, phone, website, address, rating, reviews, lat, lng, placeId, mapsUrl, ownerReplied ```` `ownerReplied` is `1` (owner has replied to at least one review), `0` (no reply detected), or `null` (not checked / undetermined). **Default Key-Value Store** (when `saveCsv` is true) — key `-.csv` with the same columns. ### Local run Requires Node 20+ and the Apify CLI: ```bash npm install npx apify run # uses .actor/input_schema.json defaults ```` To override input, create `.actor/input.json` (or `storage/key_value_stores/default/INPUT.json`) or set `APIFY_INPUT_JSON` to a JSON string. ```bash APIFY_INPUT_JSON='{"query":"hvac repair","region":"washington","maxPagesPerTile":3}' npx apify run ``` ### Deploy to Apify ```bash npx apify login npx apify push ``` The CLI reads `.actor/actor.json`, builds the Dockerfile, and pushes the Actor to your Apify account. ### Refresh the internal-search template The Actor ships with `pb-template.json` — a captured internal request parameter Google uses to authenticate `search?tbm=map` calls. It **expires periodically** (days to weeks). When responses stop starting with `)]}'`, refresh: 1. Locally, in the source project (`gmaps-crawlee`): ```bash node src/bootstrap-pb.js ``` 2. Copy the new `pb-template.json` into this Actor at the project root. 3. Re-deploy with `npx apify push`. ### Enable the owner-reply check (`checkOwnerReplies`) The owner-reply check is **off by default** and requires a second captured template, `pb-place-template.json`, that the Actor ships as an empty placeholder. To enable it: 1. Locally, in this Actor (`gmaps-crawlee-apify`): ```bash node src/bootstrap-pb-place.js ``` The script opens Chrome, searches Google Maps, clicks the first result, and captures the XHR that loads that place's details (including its reviews and owner replies). It saves the parameterized `pb` to `pb-place-template.json`. 2. Re-deploy with `npx apify push`. 3. Set `checkOwnerReplies` to `true` in the Actor's input. The Actor will then make one extra HTTP request per scraped lead to check for owner replies. Each lead in the Dataset gets an `ownerReplied` field: - `1` — owner has replied to at least one review - `0` — no reply detected - `null` — could not determine (template expired, captcha, or parsing miss) ### Why an Actor (and not just the CLI)? - **Scheduling** — run on a cron, e.g. weekly "fresh leads in my area". - **Webhooks** — pipe new datasets to Slack / Sheets / a CRM. - **Billing** — charge per run / per 1k results once published. - **Concurrency** — Apify's runtime handles memory + headless cleanly. ### Notes & limits - No proxies are bundled. If you hit captchas at scale, add `proxyConfiguration` to the `HttpCrawler` options and price accordingly. - Tile size matters: smaller `latStep`/`lngStep` = more uniques in dense cities, more requests. Tune `region` for the geography. - Dedupe is by `placeId`. Re-runs and overlapping tiles never duplicate. - The bundled `pb-template.json` was captured against Google Maps' internal `search?tbm=map` endpoint. It is bound to the same public Terms of Service considerations as any Google Maps scraper. ### Project layout ``` gmaps-crawlee-apify/ ├── .actor/ │ ├── actor.json # Apify Actor manifest │ └── input_schema.json # Input UI schema ├── Dockerfile # apify/actor-node:20 ├── package.json ├── pb-template.json # captured internal search template ├── pb-place-template.json # captured place-details template (for owner-reply check) ├── README.md └── src/ ├── main.js # scraper, wrapped in Actor.main() └── bootstrap-pb-place.js # one-time capture of pb-place-template.json ``` # Actor input Schema ## `query` (type: `string`): What to search for on Google Maps (e.g. 'plumbers', 'restaurants', 'hvac repair'). ## `region` (type: `string`): Type any of: a preset (washington, new-york, los-angeles, chicago, san-francisco, boston, seattle, london, toronto, sydney, gujrat-pk), an alias (nyc, sf, la, 'bay area', uk, 'new york'), or a custom spec 'custom:latMin,latMax,lngMin,lngMax,latStep,lngStep' (e.g. 'custom:32.40,32.78,73.88,74.38,0.08,0.09' for any area on Earth). Get custom bbox corners from https://www.openstreetmap.org/export. ## `maxPagesPerTile` (type: `integer`): 20 results per page. 5 = up to 100/tile. Higher = more uniques in dense cities but more requests. ## `saveCsv` (type: `boolean`): Push each lead to the Dataset AND write a CSV file named '-.csv' to the default Key-Value Store. ## `checkOwnerReplies` (type: `boolean`): After scraping, fetch each lead's place details and set ownerReplied=1 if the owner has replied to at least one review, 0 if not, null if undetermined. Requires pb-place-template.json (run `node src/bootstrap-pb-place.js` locally once to capture it, then redeploy). Adds ~1 extra HTTP request per lead. ## Actor input object example ```json { "query": "plumbers", "region": "washington", "maxPagesPerTile": 5, "saveCsv": true, "checkOwnerReplies": false } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "region": "washington" }; // Run the Actor and wait for it to finish const run = await client.actor("sionex/gmaps-crawlee").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "region": "washington" } # Run the Actor and wait for it to finish run = client.actor("sionex/gmaps-crawlee").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "region": "washington" }' | apify call sionex/gmaps-crawlee --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=sionex/gmaps-crawlee", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Lead Scraper - Extract Business Leads", "description": "Pull thousands of business leads from Google Maps in minutes. Pick a query and a region, get every business with name, phone, website, address, rating, reviews, and place ID. No browser, no captcha, no API quota. Any country, state, city, or custom area. Optional owner-reply check.", "version": "0.2", "x-build-id": "1oFJYZaGNWZLZs8dL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sionex~gmaps-crawlee/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sionex-gmaps-crawlee", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/sionex~gmaps-crawlee/runs": { "post": { "operationId": "runs-sync-sionex-gmaps-crawlee", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/sionex~gmaps-crawlee/run-sync": { "post": { "operationId": "run-sync-sionex-gmaps-crawlee", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "query" ], "properties": { "query": { "title": "Search query", "minLength": 1, "type": "string", "description": "What to search for on Google Maps (e.g. 'plumbers', 'restaurants', 'hvac repair').", "default": "plumbers" }, "region": { "title": "Region", "type": "string", "description": "Type any of: a preset (washington, new-york, los-angeles, chicago, san-francisco, boston, seattle, london, toronto, sydney, gujrat-pk), an alias (nyc, sf, la, 'bay area', uk, 'new york'), or a custom spec 'custom:latMin,latMax,lngMin,lngMax,latStep,lngStep' (e.g. 'custom:32.40,32.78,73.88,74.38,0.08,0.09' for any area on Earth). Get custom bbox corners from https://www.openstreetmap.org/export.", "default": "washington" }, "maxPagesPerTile": { "title": "Max pages per tile", "minimum": 1, "maximum": 10, "type": "integer", "description": "20 results per page. 5 = up to 100/tile. Higher = more uniques in dense cities but more requests.", "default": 5 }, "saveCsv": { "title": "Also save CSV to default Key-Value Store", "type": "boolean", "description": "Push each lead to the Dataset AND write a CSV file named '-.csv' to the default Key-Value Store.", "default": true }, "checkOwnerReplies": { "title": "Check if owner has replied to any review", "type": "boolean", "description": "After scraping, fetch each lead's place details and set ownerReplied=1 if the owner has replied to at least one review, 0 if not, null if undetermined. Requires pb-place-template.json (run `node src/bootstrap-pb-place.js` locally once to capture it, then redeploy). Adds ~1 extra HTTP request per lead.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```