# Google Maps Business Lead Scraper (`ai_scraper_bot_engineer/google-maps-lead-scraper`) Actor Extract targeted business leads from Google Maps using keyword and location. Get names, phone numbers, addresses, ratings, and full place data using Google Places API. Ideal for lead generation, outreach, and market research. - **URL**: https://apify.com/ai\_scraper\_bot\_engineer/google-maps-lead-scraper.md - **Developed by:** [Muhammad Asad](https://apify.com/ai_scraper_bot_engineer) (community) - **Categories:** Lead generation, Developer tools, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 Scraper Extract detailed business information from Google Maps using the **Google Places API**. Get names, ratings, contact details, addresses, coordinates, and more for any business type in any location. ### What does Google Maps Scraper do? This actor searches for businesses on Google Maps and extracts comprehensive information including: - **Business Details**: Name, address, phone number, website - **Ratings & Reviews**: Star rating and number of reviews - **Location Data**: Latitude, longitude, and Google Maps URL - **Full API Response**: Complete raw data from Google Places API for custom processing Perfect for market research, competitor analysis, lead generation, or building business directories. The actor handles rate limiting, retries, and errors automatically. **[Try it now on Apify Store](https://apify.com/actors)** ### Why use Google Maps Scraper? - **Automated Data Collection** - Extract hundreds of businesses without manual work - **Structured Output** - Get clean, validated JSON data ready for analysis - **Reliable** - Automatic retries and error handling ensure consistent results - **Cost-Effective** - Run on Apify's cloud or your own infrastructure - **Flexible Exports** - Download as JSON, CSV, Excel, or access via API - **Scheduling** - Set up recurring scrapes on a schedule - **Integrations** - Connect to Zapier, Make, Google Sheets, and more ### How to use Google Maps Scraper #### Option 1: Interactive Web UI (Recommended) When you run this actor on Apify platform, an **interactive web interface** automatically opens. This is the easiest way to use the actor: 1. **Visit the Actor's Live View** - On the Apify Console, find the "Container URL" in the run details - Or click the "Live View" button if available 2. **Fill in the Web Form** - Paste your Google Places API key - Enter search terms (one per line, e.g., "pizza restaurants") - Enter cities (one per line, e.g., "New York") - Adjust optional settings if needed 3. **Start Scraping** - Click the "🚀 Start Scraping" button - Watch the progress in real-time 4. **Preview Results** - View results in the web UI in two formats: - **Overview Tab**: Business name, address, phone, ratings - **Details Tab**: Full information including coordinates - See statistics (average rating, review count, etc.) 5. **Download Data** - Download as **JSON**, **CSV**, or **Excel** - Or access via Apify API #### Option 2: Standard Input Form Alternatively, you can provide input through the standard Apify input form: 1. **Get a Google Places API Key** - Go to [Google Cloud Console](https://console.cloud.google.com) - Create a new project - Enable the **Places API** - Create an API key credential - Keep this key safe! 2. **Set Up the Actor** - Visit the actor page on Apify Store - Click "Try for free" - Paste your API key in the input form 3. **Configure Your Search** - Enter search terms (e.g., "pizza restaurants", "fitness centers") - Enter cities to search in (e.g., "New York", "London", "Tokyo") - Set maximum results per query (1-500) - Click Start 4. **Download Results** - Wait for the actor to complete - Download data as JSON, CSV, Excel, or HTML - View results in the Output tab or access via API ### Input The actor accepts the following input configuration: ```json { "api_key": "YOUR_GOOGLE_PLACES_API_KEY", "search_terms": ["pizza restaurants", "coffee shops"], "cities": ["New York", "London"], "max_results": 100, "max_retries": 3, "delay_between_requests": 200 } ```` #### Input Fields | Field | Type | Required | Default | Description | | ------------------------ | ------- | -------- | ------- | ------------------------------------ | | `api_key` | string | ✅ Yes | - | Google Places API key (kept secret) | | `search_terms` | array | ✅ Yes | - | Business types or keywords to search | | `cities` | array | ✅ Yes | - | Cities to search in | | `max_results` | integer | ❌ No | 50 | Max results per query (1-500) | | `max_retries` | integer | ❌ No | 3 | Retries for failed requests (0-10) | | `delay_between_requests` | integer | ❌ No | 200 | Delay in ms between requests | ### Output The actor pushes structured data to the **Output dataset**. Each item represents one business: ```json { "place_id": "ChIJrRq5sKVQwokRx75nURMBFQE", "name": "Pizza Palace", "address": "123 Main St, New York, NY 10001, USA", "phone": "+1 (212) 555-0123", "rating": 4.5, "reviews": 287, "lat": 40.7128, "lng": -74.0060, "maps_url": "https://maps.google.com/?cid=...", "raw": { "displayName": {...}, "formattedAddress": "...", "location": {...}, ... } } ``` #### Data Table | Field | Type | Description | | ---------- | ------- | ------------------------- | | `place_id` | string | Unique Google Places ID | | `name` | string | Business name | | `address` | string | Full formatted address | | `phone` | string | Phone number | | `rating` | number | Google rating (0-5 stars) | | `reviews` | integer | Number of reviews | | `lat` | number | Latitude coordinate | | `lng` | number | Longitude coordinate | | `maps_url` | string | Link to Google Maps | | `raw` | object | Complete API response | **Download formats**: JSON, CSV, Excel, HTML, or access via [Apify API](https://docs.apify.com/api/v2) ### Web UI Features The interactive web interface provides a user-friendly experience for running searches: #### 🎨 Interface Highlights - **Beautiful Gradient UI** - Modern, responsive design that works on desktop and mobile - **Real-Time Search** - Watch results populate as the actor scrapes - **Live Statistics** - View average ratings, review counts, and data quality - **Two Data Views**: - **Overview Tab**: Clean summary of key business information - **Details Tab**: Complete data including coordinates for mapping - **Multiple Export Formats**: - 📥 **JSON** - Raw data for APIs and databases - 📊 **CSV** - Open in Excel or Google Sheets - 📈 **Excel** - Professional spreadsheet format - **Form Validation** - Helpful error messages guide you through setup - **Input History** - Form remembers your recent values - **Responsive Design** - Works perfectly on phones, tablets, and desktops #### ✨ What You Can Do 1. **Paste API Key Securely** - Marked as password field, never exposed in logs 2. **Add Multiple Search Terms** - One per line, e.g.: ``` pizza restaurants coffee shops fitness centers ``` 3. **Search Multiple Cities** - One per line, e.g.: ``` New York London Tokyo ``` 4. **Fine-Tune Settings**: - Max results (1-500) - Retry attempts for failed requests - Delay between requests to avoid rate limits 5. **Preview Before Download** - See all data in the web UI before exporting 6. **Download in Multiple Formats** - JSON, CSV, or Excel with one click ### Pricing / Cost Estimation The actor uses the **Google Places API**, which has its own pricing. Apify compute costs depend on runtime: - **Free Tier** (Apify): Limited runs at no cost - **Paid Plan** (Apify): $0.25 per compute unit (~1 hour of runtime) Each search query takes ~2-5 seconds, so a 100-result search costs roughly **$0.01-0.05 in Apify fees** (plus Google API costs). **Cost Optimization**: - Increase `delay_between_requests` to avoid rate limits and reduce costs - Use specific search terms (more targeted = fewer results to fetch) - Limit `max_results` to what you actually need - Schedule scrapes during off-peak hours ### Tips & Advanced Options #### Optimize Search Performance - **Use specific terms**: "Italian pizza restaurants" finds fewer results than "pizza" - **Search by location**: Searching in specific cities is cheaper than broad searches - **Adjust delays**: If you get rate-limit errors, increase `delay_between_requests` - **Batch searches**: Run multiple small searches instead of one large search #### Handling Errors - **API Key Invalid**: Check your Google Cloud Console credentials - **Rate Limited**: Increase delays or split searches into smaller batches - **Missing Data**: Some fields may be null if not available on Google Maps #### Full Response Access The `raw` field contains the complete Google Places API response. Extract additional data: ```python ## Access extended info from raw response website = item['raw'].get('websiteUri') opening_hours = item['raw'].get('currentOpeningHours') photos = item['raw'].get('photos') ``` ### FAQ & Support **Q: Can I use this to scrape without Google Places API?** A: No, this actor requires a valid Google Places API key. Google Maps data is copyrighted and requires proper API access. **Q: Is scraping Google Maps legal?** A: Using the official Google Places API is fully legal and compliant with Google's Terms of Service. This actor does not violate any terms. **Q: Why aren't I getting results?** A: Check that: - Your API key is valid and the Places API is enabled - Your search terms match businesses on Google Maps - The cities are spelled correctly - Your API key has quota remaining **Q: Can I schedule recurring scrapes?** A: Yes! On Apify platform, use the **Scheduler** tab to run this actor on a schedule (hourly, daily, weekly, etc.). **Q: How can I export the data?** A: Download as JSON, CSV, or Excel from the Output tab, or access via [Apify API](https://docs.apify.com/api/v2). **Have issues or need custom modifications?** Open an issue on the [GitHub repository](https://github.com) or contact Apify support. ### Disclaimer - This actor is for **legitimate business purposes** (market research, lead generation, etc.) - Respect [Google's Terms of Service](https://cloud.google.com/maps-platform/terms) - Do not use for spam, fraud, or automated commercial purposes that violate Google's terms - API key is kept secret and never logged or transmitted outside your run *** **More Actors**: Check out other data scrapers and automation tools on [Apify Store](https://apify.com/actors) ```` ```bash apify login ``` ```` 2\. Deploy your Actor. This command will deploy and build the Actor on the Apify Platform. You can find your newly created Actor under [Actors -> My Actors](https://console.apify.com/actors?tab=my). ```` ```bash apify push ``` ```` ### Documentation reference To learn more about Apify and Actors, take a look at the following resources: - [Apify SDK for JavaScript documentation](https://docs.apify.com/sdk/js) - [Apify SDK for Python documentation](https://docs.apify.com/sdk/python) - [Apify Platform documentation](https://docs.apify.com/platform) - [Join our developer community on Discord](https://discord.com/invite/jyEM2PRvMU) # Actor input Schema ## `api_key` (type: `string`): Your Google Places API key (required). Get it from Google Cloud Console. ## `search_terms` (type: `array`): Business types or keywords to search for (e.g., 'pizza restaurants', 'coffee shops', 'plumbers') ## `cities` (type: `array`): Cities to search in (e.g., 'New York', 'London', 'Tokyo') ## `max_results` (type: `integer`): Maximum number of results to fetch per search query ## `max_retries` (type: `integer`): Number of retries for failed API requests ## `delay_between_requests` (type: `integer`): Delay in milliseconds between API requests to avoid rate limiting ## Actor input object example ```json { "search_terms": [ "restaurants" ], "cities": [ "New York" ], "max_results": 50, "max_retries": 3, "delay_between_requests": 200 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("ai_scraper_bot_engineer/google-maps-lead-scraper").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 = {} # Run the Actor and wait for it to finish run = client.actor("ai_scraper_bot_engineer/google-maps-lead-scraper").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 '{}' | apify call ai_scraper_bot_engineer/google-maps-lead-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ai_scraper_bot_engineer/google-maps-lead-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Business Lead Scraper", "description": "Extract targeted business leads from Google Maps using keyword and location. Get names, phone numbers, addresses, ratings, and full place data using Google Places API. Ideal for lead generation, outreach, and market research.", "version": "1.0", "x-build-id": "3iyrdGOW9A3B87YDY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ai_scraper_bot_engineer~google-maps-lead-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ai_scraper_bot_engineer-google-maps-lead-scraper", "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/ai_scraper_bot_engineer~google-maps-lead-scraper/runs": { "post": { "operationId": "runs-sync-ai_scraper_bot_engineer-google-maps-lead-scraper", "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/ai_scraper_bot_engineer~google-maps-lead-scraper/run-sync": { "post": { "operationId": "run-sync-ai_scraper_bot_engineer-google-maps-lead-scraper", "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": [ "api_key", "search_terms", "cities" ], "properties": { "api_key": { "title": "Google Places API Key", "type": "string", "description": "Your Google Places API key (required). Get it from Google Cloud Console." }, "search_terms": { "title": "Search Terms", "minItems": 1, "type": "array", "description": "Business types or keywords to search for (e.g., 'pizza restaurants', 'coffee shops', 'plumbers')", "default": [ "restaurants" ] }, "cities": { "title": "Cities", "minItems": 1, "type": "array", "description": "Cities to search in (e.g., 'New York', 'London', 'Tokyo')", "default": [ "New York" ] }, "max_results": { "title": "Max Results Per Query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of results to fetch per search query", "default": 50 }, "max_retries": { "title": "Max Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Number of retries for failed API requests", "default": 3 }, "delay_between_requests": { "title": "Delay Between Requests (ms)", "minimum": 0, "maximum": 5000, "type": "integer", "description": "Delay in milliseconds between API requests to avoid rate limiting", "default": 200 } } }, "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 } } } } } } } } } } ```