# 🟒🟒 Google Maps Scraper 🟒🟒 (`olympus/google-maps-leads-scraper`) Actor πŸ”₯🟒 Gather detailed business data from thousands of Google Maps listings, including reviews, reviewer insights, images, contact information, operating hours, pricing, ratings, locations, and more. - **URL**: https://apify.com/olympus/google-maps-leads-scraper.md - **Developed by:** [Olympus](https://apify.com/olympus) (community) - **Categories:** Automation, Videos, Developer tools - **Stats:** 454 total users, 0 monthly users, 100.0% runs succeeded, 9 bookmarks - **User rating**: 4.74 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 Scraper Scrape Google Maps for business listings at scale. Extract names, addresses, phone numbers, websites, ratings, reviews, coordinates, and more from any location worldwide. --- ### What Does Google Maps Scraper Do? Google Maps Scraper is an Apify actor that extracts data from Google Maps search results. Give it a list of search keywords and a location, and it will return detailed information about every matching business or place. --- ### Why Scrape Google Maps? - **Lead generation** β€” Build targeted lists of businesses by category and location - **Market research** β€” Analyze competitor density, ratings, and reviews in any area - **Local SEO** β€” Monitor business listings and track rating changes over time - **Data enrichment** β€” Enrich your CRM with phone numbers, websites, and addresses - **Real estate analysis** β€” Map business density for location scouting --- ### Input | Field | Type | Required | Description | |---|---|---|---| | `keyword` | array | βœ… | Search terms to look for. Each keyword is searched independently. | | `location` | string | βœ… | Geographic area to search. Can be city, state, country, or any place name. | | `resultPerKeyword` | integer | ❌ | Maximum unique places to collect per keyword. Default: `100` | --- ### Input Example ```json { "keyword": ["restaurants", "cafes", "bars"], "location": "Palm Beach, FL, USA", "resultPerKeyword": 500 } ```` *** ### πŸ“ How to Enter Location The `location` field accepts any recognisable place name β€” city + country. The more specific you are, the more targeted your results will be. #### βœ… Accepted Formats - `New York, NY` - `London, United Kingdom` - `Paris, France` - `California, USA` - `Chicago` #### πŸ’‘ Good to Know - More specific locations return more relevant results - Country-level searches work but return broader results spread across the entire country - Leaving location blank searches Google Maps based on the default location *** ### πŸ”‘ Keywords Each keyword in the array is searched independently against your location. The scraper collects up to `resultPerKeyword` unique results per keyword. #### βœ… Good Keywords - `"restaurants"` β€” broad category - `"italian restaurants"` β€” narrower category - `"plumbers"` β€” service type - `"co-working spaces"` β€” specific niche - `"Tesla dealerships"` β€” brand-specific #### πŸ’‘ Tips - Use plural forms β€” `"restaurants"` returns more results than `"restaurant"` - Combine broad and narrow terms to cover more ground β€” `["gyms", "fitness centers", "crossfit"]` - Industry-specific terms work well β€” `"orthodontists"`, `"commercial lawyers"`, `"wedding photographers"` *** ### Output Each result is a JSON object with the following fields: ```json { "title": "Spark by Hilton Atlanta Airport South College Park", "mapsUrl": "https://www.google.com/maps/place/?q=place_id:ChIJRdJDdJ7j9IgRqhhPgOABGGQ", "href": "https://www.google.com/maps/place/?q=place_id:ChIJRdJDdJ7j9IgRqhhPgOABGGQ", "categoryName": "Hotel", "categories": [ "Hotel" ], "totalScore": 3.5, "reviewsCount": 83, "price": "$75", "address": "Spark by Hilton Atlanta Airport South College Park, 1888 Sullivan Rd, College Park, GA 30337", "phone": "(770) 996-2220", "imageUrl": "https://lh4.googleusercontent.com/--HGxe12Hts8/AAAAAAAAAAI/AAAAAAAAAAA/LPZPy-_StGM/s44-p-k-no-ns-nd/photo.jpg", "isOpenNow": null, "emails": [], "scrapedAt": "2026-05-12T12:35:51.233Z", "kgmid": "0x88f4e39e7443d245:0x641801e0804f18aa", "hotelStars": 1, "location": { "lat": 33.626297199999996, "lng": -84.4508611 }, "reviewsDistribution": { "fiveStar": 17, "fourStar": 7, "threeStar": 10, "twoStar": 14, "oneStar": 35 }, "reviewsTags": [], "pricePerNight": "$75", "bookingOptions": [ { "provider": "Expedia.com", "originalPrice": "$92", "discountedPrice": "$75" }, { "provider": "Spark by Hilton Atlanta Airport South College Park", "originalPrice": "$88", "discountedPrice": "$71" }, { "provider": "Booking.com", "originalPrice": "$93", "discountedPrice": "$75" }, { "provider": "Hotels.com", "originalPrice": "$92", "discountedPrice": "$75" } ], "street": "1888 Sullivan Rd", "city": "College Park", "state": "Georgia", "postalCode": "30337", "country": "US", "timezone": "America/New_York", "plusCode": "JGGX+GM College Park, Georgia", "website": "https://www.hilton.com/en/hotels/atlsrpe-spark-atlanta-airport-south-college-park/?SEO_id=GMB-AMER-PE-ATLSRPE&y_source=1_MTA5Nzg2ODYzMS03MTUtbG9jYXRpb24ud2Vic2l0ZQ%3D%3D", "permanentlyClosed": false, "temporarilyClosed": false, "claimThisBusiness": false, "imagesCount": 75, "images": [ { "imageUrl": "https://streetviewpixels-pa.googleapis.com/v1/thumbnail?panoid=WC4Jff7z8cxC7psieHKENA&cb_client=search.gws-prod.gps&w=211&h=120&yaw=113.25159&pitch=0&thumbfov=100" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAHZejCvrlKkDdbuEmdEXYa0w-AScPKRjnSwDetifgi_lrBjXAtU9lCj2aHbqwrxos6nn4QqTTe8RCKazoUCiVJgnDiRGx8U73Hl3T-LiSt2gDgUSCc9Svt1wSrtcSdR1uHAGyn5NgnpE1s=w800-h600-k-no" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAE2dVmHEN6D-d6OVHeg6ZJJk7dhlTLQZLrzR0LdKqnOV2x44sQMq1V-KPPzEEEcmIFveZIsXVpruKcK91ITAju2yvb4T5MZ8YYhsFfK8TeHOIlnydzBEDHLcHwZRLnkEpN4KrWlunfiUzs=w800-h600-k-no" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAEDu6vbVBeve6rbSgk66DkeDTK39X4z79yeGlID9lYGiQZweerGLWEffmysrQzCFnXsOybn_VeYc458kdMP494hKJVEQX_QfJZLthj50ctFfQ5YrTDBTX18PrPghh_bjTgzUq8jitAQmug=w800-h600-k-no" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAEYlsJNTgrFu5fUfLgQ61WPMsOF8pQSDWh6qOce3QRdcxEi8HylEzlsEyPlg8ddHkjmQjFgYZAnjA8yerXYldSimn6tLwR4cxBCIH2eZwNx79z1KBrNkYQkAKNBIK8PtkxvpLRD0_qZzHc=w800-h600-k-no" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAH0bvx9T7Z1QfpCQN5VHQgMNEhgi6vmRESFiSWRfa14UGPpZ0ZFJuq_v8q5mMS96ORannAAqCAuqwb9rQTbzQDcozMLEwHUv_uMjLywIX8-ViOCdrODLJWEW8Czhp1Fyf3zspxeSc6NWbGn=w800-h600-k-no" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAHQqDsbGXIdpv9UhSkDxD1Ut2eT94BhZjKaScWkTQfCwuH5H2Nc2w_N-Fblwih4HjRbu-c2OWVEnAV8SsmEhybGjSSgvVe51Mn0QICHgGaNHV4zJRhg_5plmvCWwa4honz8i4-qr_3aQwYB=w800-h600-k-no" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAG7L2eimrvZ9WIP024cDWl23QKrlJ6hCZB5YSobWiCHDCABCwPkeTp6nD-SA5ESjZ5GzlTTXzZxCCcEXTKx9xNvLoPsy2ICjSc3TTp3fzKqL339JnTAsXw1eOZA32B6yb7Qvd9CMqVTqrM-=w800-h600-k-no" }, { "imageUrl": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAER41nKCTDvdMCm82yePOUsWremLzpy_0f2snA1vyNGo_39Q2QdmFf37dtOG5cJsquDdvHzsRAqT7MGJabJfuBySm9Fl6pp_YgXQbw4CoIVMBg-Kq7peg1gqjsi4yVRratGzYunQ1vmevck=w800-h600-k-no" } ], "additionalInfo": null, "features": [ "Exterior", "Photo", "Pool", "Guest room bath", "tv4tE0KyVAM", "Free Wi-Fi", "Free breakfast", "Free parking", "Accessible", "Outdoor pool", "Air-conditioned", "Business center", "Pet-friendly", "Kid-friendly", "Restaurant", "Airport shuttle", "Fitness center", "Smoke-free", ] } ``` *** ### Resumption The scraper automatically saves progress. If the run is interrupted or times out, restarting it with the same input will skip already scraped listings and pick up where it left off. *** ### Free Plan Limits Free plan users are limited to **20 results total** across all keywords and runs within a 30-day window. Upgrade your plan to remove this limit. *** ### Support If you run into any issues, contact support at **olympusdev001@gmail.com** # Actor input Schema ## `keyword` (type: `array`): List of search keyword to scrape. Do NOT include locations here. ## `location` (type: `string`): Your target Location. Use only City + Country e.g New YorK, USA ## `resultPerKeyword` (type: `integer`): Maximum number of business listings to collect from each keyword. ## Actor input object example ```json { "keyword": [ "hotels" ], "location": "New York, USA", "resultPerKeyword": 100 } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "keyword": [ "hotels" ] }; // Run the Actor and wait for it to finish const run = await client.actor("olympus/google-maps-leads-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 = { "keyword": ["hotels"] } # Run the Actor and wait for it to finish run = client.actor("olympus/google-maps-leads-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 '{ "keyword": [ "hotels" ] }' | apify call olympus/google-maps-leads-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=olympus/google-maps-leads-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🟒🟒 Google Maps Scraper 🟒🟒", "description": "πŸ”₯🟒 Gather detailed business data from thousands of Google Maps listings, including reviews, reviewer insights, images, contact information, operating hours, pricing, ratings, locations, and more.", "version": "0.1", "x-build-id": "iDYjjp3D0aLqgcf95" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/olympus~google-maps-leads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-olympus-google-maps-leads-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/olympus~google-maps-leads-scraper/runs": { "post": { "operationId": "runs-sync-olympus-google-maps-leads-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/olympus~google-maps-leads-scraper/run-sync": { "post": { "operationId": "run-sync-olympus-google-maps-leads-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": [ "keyword", "location" ], "properties": { "keyword": { "title": "Search Keyword", "maxItems": 100, "uniqueItems": true, "type": "array", "description": "List of search keyword to scrape. Do NOT include locations here.", "items": { "type": "string" } }, "location": { "title": "Location (City + Country) - only one per run", "type": "string", "description": "Your target Location. Use only City + Country e.g New YorK, USA", "default": "New York, USA" }, "resultPerKeyword": { "title": "Maximum results per keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of business listings to collect from each keyword.", "default": 100 } } }, "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 } } } } } } } } } } ```