# Google Maps Lead Extractor (`crawlio/google-maps-lead-extractor`) Actor Extract complete business data from any Google Maps search page — including business details, leads, reviews, ratings, contacts, websites, and more in seconds. - **URL**: https://apify.com/crawlio/google-maps-lead-extractor.md - **Developed by:** [Crawlio](https://apify.com/crawlio) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.25 / 1,000 leads 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 Lead Extractor ### What does Google Maps Lead Extractor do? Google Maps Lead Extractor enables you to get detailed business data, local search results, and customer reviews from [Google Maps](https://www.google.com/maps) directly using search terms or listing URLs. Google Maps Lead Extractor can scrape: - Local search results (lighter, faster payload) - Full business details (contact info, address, opening hours, coordinates) - Paginated customer reviews - Scored local business leads (combining search and details) - Deeply enriched leads (includes website emails and Google web results) ### Why scrape Google Maps? Google Maps has millions of businesses listed and is a great source of data for lead generation, competitive research, reputation management, and local market intelligence. Here are just some of the ways you could use that data: - Build detailed contact lists for B2B outreach and sales - Analyze customer reviews and sentiment for specific competitors - Track business ratings and popularity in specific areas - Discover new businesses and map local market trends If you would like more inspiration on how scraping Google Maps could help your business or organization, check out our [industry pages](https://apify.com/industries). ### How to scrape Google Maps It's easy to scrape Google Maps with Google Maps Lead Extractor. Just follow these few steps and you'll get your data in a few minutes. 1. Click on **Try for free**. 2. Select operation: - **Fast Search** → Get basic search results fast - **Business Details** → Get all information about a specific place - **Lead Generation** → Get scored lead records with business details - **Reviews** → Fetch paginated reviews for one place - **Deep Enrichment** → Slower enrichment for websites and web results 3. Enter your search terms and locations, or target listing URLs. 4. Click on **Run**. 5. When Google Maps Lead Extractor has finished, preview or download your data from the **Dataset** tab. ### Supported operations The Actor supports five operations: - `fast_search` — fetch fast Google Maps search results - `details` — fetch full business details from a Google Maps URL or ID - `lead_generation` — fetch scored lead records with Google Maps details - `reviews` — fetch paginated reviews for a specific place - `deep_enrichment` — slower enrichment for websites/web results, or details plus reviews --- #### Fast Search **Example input:** ```json { "mode": "fast_search", "searchTerms": [ "dentist" ], "locations": [ "Jackson Heights NY" ], "numberOfPlaces": 20 } ```` **Example output:** ```json { "title": "Sams Family Dental Care", "totalScore": 4.2, "reviewsCount": 277, "street": "3766 82nd St", "city": "Jackson Heights", "state": "NY", "countryCode": "NY 11372", "website": "", "phone": "", "categories": [ "Dentist" ], "url": "https://www.google.com/maps/search/?api=1&query=Sams%20Family%20Dental%20Care...", "categoryName": "Dentist", "searchTerm": "dentist", "query": "dentist in Jackson Heights NY", "location": "Jackson Heights NY", "resultType": "search_result" } ``` #### Business Details **Example input:** ```json { "mode": "details", "placeInput": "https://www.google.com/maps/place/ChIJN1t_tDeuEmsRUsoyG83frY4" } ``` **Example output:** ```json { "place_id": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52", "place_id_chij": "ChIJN1t_tDeuEmsRUsoyG83frY4", "name": "Google Sydney - Pirrama Road", "address": "Ground Floor/48 Pirrama Rd, Pyrmont NSW 2009, Australia", "phone": "+61 2 9374 4000", "website": "http://google.com/", "category": "Corporate office", "rating": 4.0, "review_count": 1176, "latitude": -33.866489, "longitude": 151.1958561, "opening_status": "Closed · Opens 8:30 AM Mon", "resultType": "details" } ``` #### Lead Generation **Example input:** ```json { "mode": "lead_generation", "searchTerms": [ "dentist" ], "locations": [ "Jackson Heights NY" ], "numberOfPlaces": 20, "enrichDetails": true } ``` **Example output:** ```json { "name": "Ramos Dental P.C.", "place_id": "0x89c25fa8a4b143f9:0x2f0a9fa338d85770", "place_id_chij": "ChIJ-UOxpKhfwokRcFfYOKOfCi8", "google_maps_url": "https://www.google.com/maps/search/?api=1&query=Ramos%20Dental%20P.C.&query_place_id=ChIJ-UOxpKhfwokRcFfYOKOfCi8", "source_query": "dentist in Jackson Heights NY", "address": "35-53 82nd St ## 1e, Jackson Heights, NY 11372", "category": "Dentist", "phone": "(718) 426-4176", "website": "", "emails": [], "about": { "accessibility": { "title": "Accessibility", "attributes": [ ... ] }, "offerings": { "title": "Offerings", "attributes": [ ... ] } }, "neighborhood": "Jackson Heights", "country_code": "US", "opening_status": "Open · Closes 6 PM", "owner_name": "Ramos Dental P.C. (Owner)", "review_histogram": { "star_1": 18, "star_2": 0, "star_3": 1, "star_4": 7, "star_5": 162, "total": 188 }, "rating": 4.6, "review_count": 188, "latitude": 40.750296999999996, "longitude": -73.884108, "lead_score": 85, "lead_grade": "A", "lead_signals": [ "missing_website", "has_phone", "has_about_attributes", "multi_category_listing", "owner_managed_listing", "high_review_volume", "strong_reputation" ], "missing_fields": [ "website" ], "resultType": "lead" } ``` #### Reviews **Example input:** ```json { "mode": "reviews", "placeInput": "https://www.google.com/maps/place/ChIJN1t_tDeuEmsRUsoyG83frY4", "maxReviews": 20, "sortBy": "newest" } ``` **Example output:** ```json { "reviewer_name": "Mark I-P", "reviewer_url": "https://www.google.com/maps/contrib/102042907633685184592?hl=en", "rating": 2, "text": "Google pixel 10, I have owned Pixel phones since Google launched their phones...", "time_description": "Edited 3 months ago", "timestamp": 1768005103358557, "is_local_guide": true, "photos": [], "owner_reply": "", "resultType": "review", "place_id": "0x6b12ae37b47f5b37:0x8eaddfcd1b32ca52" } ``` #### Deep Enrichment **Example input:** ```json { "mode": "deep_enrichment", "searchTerms": [ "dentist" ], "locations": [ "Jackson Heights NY" ], "numberOfPlaces": 20, "enrichWebsites": true, "enrichGoogleWebResults": true, "maxReviews": 20 } ``` **Example output:** ```json { "name": "Sams Family Dental Care", "place_id_chij": "ChIJzcbB1N9fwokRY5yrW2misgA", "google_maps_url": "https://www.google.com/maps/search/?api=1...", "address": "3766 82nd St, Jackson Heights, NY 11372", "category": "Dentist", "phone": "(718) 672-6001", "website": "http://www.samsfamilydental.com/", "emails": [ "hello@info.com", "samsfamilydental@live.com" ], "contact_pages": [ "http://www.samsfamilydental.com/about/", "http://www.samsfamilydental.com/contact-jackson-heights-dentist/" ], "rating": 4.2, "review_count": 280, "resultType": "details" } ``` *** ### Is it legal to scrape Google Maps? Note that personal data is protected by GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers. We also recommend that you read our blog post: [is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) # Actor input Schema ## `mode` (type: `string`): Choose the extraction profile. Fast search is cheapest. ## `fast_search` (type: `object`): Configure settings for fast search. ## `details` (type: `object`): Configure settings for single business details. ## `lead_generation` (type: `object`): Configure settings for local business leads. ## `reviews` (type: `object`): Configure settings for scraping reviews. ## `language` (type: `string`): Google language. ## `gl` (type: `string`): Google country code. ## `minScore` (type: `integer`): Filter leads below this score (0-100). Applies to lead generation. ## `maxWorkers` (type: `integer`): Parallel query workers for lead generation. ## `proxyConfiguration` (type: `object`): Select proxies to use for Google requests. Residential proxies are recommended for larger runs. ## Actor input object example ```json { "mode": "lead_generation", "language": "English", "gl": "us", "minScore": 0, "maxWorkers": 4, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): One dataset item per returned result. ## `runSummary` (type: `string`): Summary stored in the OUTPUT record of the default key-value store. # 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 = { "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("crawlio/google-maps-lead-extractor").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 = { "proxyConfiguration": { "useApifyProxy": False } } # Run the Actor and wait for it to finish run = client.actor("crawlio/google-maps-lead-extractor").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 '{ "proxyConfiguration": { "useApifyProxy": false } }' | apify call crawlio/google-maps-lead-extractor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlio/google-maps-lead-extractor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Lead Extractor", "description": "Extract complete business data from any Google Maps search page — including business details, leads, reviews, ratings, contacts, websites, and more in seconds.", "version": "0.1", "x-build-id": "WlMVZyomX6JPwXqQY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlio~google-maps-lead-extractor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlio-google-maps-lead-extractor", "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/crawlio~google-maps-lead-extractor/runs": { "post": { "operationId": "runs-sync-crawlio-google-maps-lead-extractor", "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/crawlio~google-maps-lead-extractor/run-sync": { "post": { "operationId": "run-sync-crawlio-google-maps-lead-extractor", "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", "properties": { "mode": { "title": "Mode", "enum": [ "fast_search", "details", "lead_generation", "reviews" ], "type": "string", "description": "Choose the extraction profile. Fast search is cheapest.", "default": "lead_generation" }, "fast_search": { "title": "Fast search input", "type": "object", "description": "Configure settings for fast search.", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Business categories or keywords (e.g. dentist, plumber).", "default": [ "dentist" ], "editor": "stringList", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Locations to combine with search terms (e.g. Jackson Heights NY).", "default": [ "Jackson Heights NY" ], "editor": "stringList", "items": { "type": "string" } }, "numberOfPlaces": { "title": "Number of places", "type": "integer", "description": "Maximum places to extract per query.", "default": 20, "minimum": 1, "maximum": 200, "editor": "number" } }, "additionalProperties": false }, "details": { "title": "Business details input", "type": "object", "description": "Configure settings for single business details.", "properties": { "placeInput": { "title": "Google Maps URL or place ID", "type": "string", "description": "Google Maps URL, hex place ID, or ChIJ place ID.", "default": "https://www.google.com/maps/place/ChIJN1t_tDeuEmsRUsoyG83frY4", "editor": "textfield" } }, "additionalProperties": false }, "lead_generation": { "title": "Lead generation input", "type": "object", "description": "Configure settings for local business leads.", "properties": { "placeInput": { "title": "Google Maps URL or place ID (Optional)", "type": "string", "description": "Skip searching and directly target a Google Maps URL, hex place ID, or ChIJ place ID.", "default": "", "editor": "textfield" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Business categories or keywords.", "default": [ "dentist" ], "editor": "stringList", "items": { "type": "string" } }, "locations": { "title": "Locations", "type": "array", "description": "Locations to combine with search terms.", "default": [ "Jackson Heights NY" ], "editor": "stringList", "items": { "type": "string" } }, "numberOfPlaces": { "title": "Number of places", "type": "integer", "description": "Maximum places per query.", "default": 20, "minimum": 1, "maximum": 200, "editor": "number" }, "enrichDetails": { "title": "Enrich details", "type": "boolean", "description": "Fetch full Google Maps detail data for lead generation.", "default": true, "editor": "checkbox" }, "enrichWebsites": { "title": "Enrich websites", "type": "boolean", "description": "Fetch business websites for emails and contact pages. Slower.", "default": false, "editor": "checkbox" }, "enrichGoogleWebResults": { "title": "Enrich Google web results", "type": "boolean", "description": "Collect Google web result cards shown under the Maps listing. Slower.", "default": false, "editor": "checkbox" }, "maxReviews": { "title": "Maximum reviews", "type": "integer", "description": "Maximum reviews to fetch per place.", "default": 20, "minimum": 0, "maximum": 1000, "editor": "number" } }, "additionalProperties": false }, "reviews": { "title": "Reviews input", "type": "object", "description": "Configure settings for scraping reviews.", "properties": { "placeInput": { "title": "Google Maps URL or place ID", "type": "string", "description": "Google Maps URL, hex place ID, or ChIJ place ID.", "default": "https://www.google.com/maps/place/ChIJN1t_tDeuEmsRUsoyG83frY4", "editor": "textfield" }, "maxReviews": { "title": "Maximum reviews", "type": "integer", "description": "Maximum reviews to fetch.", "default": 20, "minimum": 1, "maximum": 1000, "editor": "number" }, "sortBy": { "title": "Review sort", "type": "string", "description": "Review sorting mode.", "default": "newest", "enum": [ "newest", "relevant", "highest_rating", "lowest_rating" ], "editor": "select" } }, "additionalProperties": false }, "language": { "title": "Language", "type": "string", "description": "Google language.", "default": "English" }, "gl": { "title": "Country code", "type": "string", "description": "Google country code.", "default": "us" }, "minScore": { "title": "Minimum lead score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Filter leads below this score (0-100). Applies to lead generation.", "default": 0 }, "maxWorkers": { "title": "Max workers", "minimum": 1, "maximum": 16, "type": "integer", "description": "Parallel query workers for lead generation.", "default": 4 }, "proxyConfiguration": { "title": "Proxy settings", "type": "object", "description": "Select proxies to use for Google requests. Residential proxies are recommended for larger runs.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```