# Google Maps List Scraper: 30+ Fields Per Place (`getascraper/google-maps-list-scraper`) Actor Extract all places from any public Google Maps shared list. Get 30+ fields per place: name, address, GPS, phone, website, hours, rating, and photos. Works with Google Sheets, Make, n8n, Zapier. No API key needed. $1.99/1k. - **URL**: https://apify.com/getascraper/google-maps-list-scraper.md - **Developed by:** [GetAScraper](https://apify.com/getascraper) (community) - **Categories:** Automation, Travel, Lead generation - **Stats:** 10 total users, 1 monthly users, 96.8% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.59 / 1,000 place records 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 ### What does Google Maps List Scraper do? Get complete contact lists, physical coordinates, and business details from any public Google Maps shared list: place name, list notes, full physical address, phone numbers, website links, categories, opening hours, customer ratings, review counts, photo galleries, and Place IDs, ready for your CRM in under 10 seconds. This scraper connects directly to shared list directories unblocked, meaning no login or API keys are required. Built for real estate researchers, geographic sales prospectors, travel curation platforms, local businesses, and database managers. ### Why use Google Maps List Scraper? - **I am a real estate researcher** extracting agent-shared neighborhood collections and property lists to populate local market maps. - **I am a CRM lead generator** gathering curated local business directories (like "best coffee shops" or "top dentists") to build highly targeted outbound prospect lists. - **I am a travel platform manager** converting public travel itineraries and blogger recommendations into structured database records for app content. - **I am a sales team leader** compiling localized lead sheets of businesses with phone numbers, websites, and opening hours for direct pitches. - **I am a local business owner** exporting neighborhood competitor coordinates and ratings to analyze market density in my region. ### How to use Google Maps List Scraper 1. Create a free Apify account (no credit card needed). 2. Open the Google Maps List Scraper in the Apify Console. 3. Paste one or more public Google Maps shared list links (such as short `maps.app.goo.gl` or full list URLs). 4. Set optional limits on the maximum number of places to retrieve. 5. Click **Start** and download your structured location database as CSV, Excel, or JSON. ### Input | Field | Type | Required | Description | | --- | --- | --- | --- | | `listUrls` | array of URLs | Yes | Direct public Google Maps shared list links (for example, `https://maps.app.goo.gl/abc123`). | | `maxItems` | integer | No | Maximum number of places to retrieve. 0 means unlimited. | | `enrichPlaces` | boolean | No | Fetch each place's individual page for ratings, phones, websites, opening hours, and photos. Defaults to true. | | `proxyConfiguration` | object | No | Proxy settings. Standard automatic configuration is highly optimized. | ### Output A structured dataset of business leads with direct phone numbers, websites, category labels, GPS coordinates, operating hours, and customer ratings. Free users get up to 50 results per run, paid plans scale to 1,000,000. ```json { "listName": "Best coffee in Lisbon", "listUrl": "https://maps.app.goo.gl/abc123", "listId": "abc123", "sourceIndex": 0, "name": "Cafe Nicola", "note": "Classic cafe, must try!", "address": "Praca Dom Pedro IV 24, 1100-201 Lisboa, Portugal", "city": "Lisboa", "country": "Portugal", "lat": 38.7139, "lng": -9.1394, "categories": ["Coffee shop", "Cafe"], "rating": 4.3, "reviewCount": 2841, "phone": "+351 21 346 0579", "website": "https://cafenicola.pt", "domain": "cafenicola.pt", "hours": ["Monday: 8:00 AM - 10:00 PM", "Tuesday: 8:00 AM - 10:00 PM"], "photos": ["https://lh3.googleusercontent.com/p/AF1QipN..."], "imageUrl": "https://lh3.googleusercontent.com/p/AF1QipN...", "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4", "scrapedAt": "2026-06-21T10:00:00.000Z" } ```` ### Data table | Field | Type | Description | | --- | --- | --- | | `listName` | string | Name of the public Google Maps list. | | `listUrl` | string | Shared URL of the source list. | | `listId` | string | Google's unique internal list identifier. | | `sourceIndex` | integer | Position of this place inside the list (0-indexed). | | `name` | string | Business or place name. | | `note` | string | Personal note added by the list creator for this place. | | `imageUrl` | string | Primary photo URL of the location. | | `address` | string | Full formatted physical address. | | `street` | string | Street name details. | | `city` | string | Operating city name. | | `state` | string | Operating state or region abbreviation. | | `postalCode` | string | Address postal code or zip code. | | `country` | string | Operating country name. | | `lat` | number | Geographic latitude coordinate for mapping. | | `lng` | number | Geographic longitude coordinate for mapping. | | `plusCode` | string | Google Open Location Plus Code. | | `categories` | array of strings | Categorization tags assigned to the place. | | `rating` | number | Average customer rating out of 5 stars. | | `reviewCount` | number | Total number of published customer reviews. | | `phone` | string | Standardized phone number. | | `website` | string | Official business website URL. | | `domain` | string | Simplified website domain name. | | `hours` | array of strings | List of today's operating hours. | | `photos` | array of strings | Public photo gallery links for the place. | | `placeId` | string | Google's unique global Place ID. | | `cid` | string | Google Customer ID identifier. | | `isClaimed` | boolean | Whether the business has claimed its Google listing. | | `isPermanentlyClosed` | boolean | True if the place is permanently closed. | | `priceLevel` | string | Relative price range (for example, Inexpensive, Moderate). | | `editorialSummary` | string | Google's brief editorial summary description of the place. | | `scrapedAt` | string | ISO 8601 timestamp of when this record was collected. | ### Pricing The Actor costs **$1.99 per 1,000 results**. A typical run extracting 500 places from a curated list costs about $1.00. Because the scraper connects directly to Google's server-rendered JSON endpoints instead of launching heavy browsers, proxy and compute bandwidth consumption is extremely low, keeping your total costs at the absolute minimum. ### Tips or advanced options - **No browser overhead.** Because this scraper connects directly to unblocked server endpoints, it does not launch Chrome or execute heavy scripts. This makes it 100x faster than browser-based scrapers, running in a fraction of the time. - **Set caps to save budget.** Verify outputs by setting max items to 5 on your first run before processing massive travel lists. - **Enable place details for enriched leads.** Keep details enabled to parse rich 30-field specifications like phone numbers, website URLs, claimed status, and open hours. Turn it off only if you want a super-fast list-only walk. - **Combine multiple lists.** You can paste several public shared URLs into the input array to merge different regional directories into a single spreadsheet concurrently. ### FAQ, disclaimers, and support ##### Is the Google Maps List scraper legal? Yes. The Google Maps List scraper accesses public list directory pages that are publicly visible to any logged-out human in a browser. It does not require login, bypass paywalls, or private user accounts. You are responsible for compliance with Google terms of service and local laws. ##### Does this scraper require proxies? No. Google Maps list endpoints use standard unblocked infrastructure that is open to public search engines. No residential proxy is needed for normal runs. If a very high-volume run starts drawing rate limits, you can easily switch to residential in the proxy configuration. ##### Why are some website or phone fields empty? These fields are fetched directly from individual place detail pages. Ensure place enrichment is enabled. Some places genuinely have no registered phone or website listed on Google Maps. ##### What is the Place ID? The Place ID is Google's unique identifier for a physical location, in the format `ChIJ...`. It is highly stable and can be used directly with other maps integrations. **Disclaimer:** This Actor accesses public web listing data only. It does not bypass authentication, paywalls, or anti-bot systems on the live site. Google Maps is the registered trademark of Google LLC. This Actor is affiliation-free, and not endorsed or sponsored by Google LLC. # Actor input Schema ## `listUrls` (type: `array`): One or more Google Maps shared list URLs. Accepts short links (maps.app.goo.gl/...) and full URLs (google.com/maps/...). ## `minRating` (type: `number`): Only include places with this star rating or higher. Set to 0 to include all places. Requires full place details to be on. ## `minReviewCount` (type: `integer`): Only include places with at least this many reviews. Set to 0 to include all. Requires full place details to be on. ## `filterByCountry` (type: `string`): Only include places located in this country. Use the full country name as it appears on Google Maps, e.g. France, Japan, United States. Leave blank to include all countries. ## `filterByCategories` (type: `array`): Only include places that match at least one of these categories, e.g. Restaurant, Coffee shop, Hotel. Leave empty to include all categories. ## `onlyWithWebsite` (type: `boolean`): Skip places that have no website listed on Google Maps. Requires full place details to be on. ## `onlyWithPhone` (type: `boolean`): Skip places that have no phone number on Google Maps. Useful for lead gen runs. Requires full place details to be on. ## `excludePermanentlyClosed` (type: `boolean`): Skip places marked as permanently closed on Google Maps. Recommended for lead gen and travel planning. ## `proxyConfiguration` (type: `object`): Proxy settings. Shared datacenter proxies (the default) work reliably for all normal runs. Switch to Residential only if a very large run starts hitting rate limits. ## `enrichPlaces` (type: `boolean`): Fetch each place's detail page for rating, phone, website, hours, and photos. Adds one request per place. Required for most place filters to work. Default: on. ## `maxItems` (type: `integer`): Maximum total number of places to extract across all lists. 0 means no limit. ## Actor input object example ```json { "listUrls": [ { "url": "https://maps.app.goo.gl/example" } ], "minRating": 0, "minReviewCount": 0, "filterByCountry": "", "filterByCategories": [], "onlyWithWebsite": false, "onlyWithPhone": false, "excludePermanentlyClosed": true, "proxyConfiguration": { "useApifyProxy": true }, "enrichPlaces": true, "maxItems": 0 } ``` # 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 = { "listUrls": [ { "url": "https://maps.app.goo.gl/example" } ], "minRating": 0, "minReviewCount": 0, "filterByCountry": "", "filterByCategories": [], "onlyWithWebsite": false, "onlyWithPhone": false, "excludePermanentlyClosed": true, "proxyConfiguration": { "useApifyProxy": true }, "enrichPlaces": true, "maxItems": 0 }; // Run the Actor and wait for it to finish const run = await client.actor("getascraper/google-maps-list-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 = { "listUrls": [{ "url": "https://maps.app.goo.gl/example" }], "minRating": 0, "minReviewCount": 0, "filterByCountry": "", "filterByCategories": [], "onlyWithWebsite": False, "onlyWithPhone": False, "excludePermanentlyClosed": True, "proxyConfiguration": { "useApifyProxy": True }, "enrichPlaces": True, "maxItems": 0, } # Run the Actor and wait for it to finish run = client.actor("getascraper/google-maps-list-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 '{ "listUrls": [ { "url": "https://maps.app.goo.gl/example" } ], "minRating": 0, "minReviewCount": 0, "filterByCountry": "", "filterByCategories": [], "onlyWithWebsite": false, "onlyWithPhone": false, "excludePermanentlyClosed": true, "proxyConfiguration": { "useApifyProxy": true }, "enrichPlaces": true, "maxItems": 0 }' | apify call getascraper/google-maps-list-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=getascraper/google-maps-list-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps List Scraper: 30+ Fields Per Place", "description": "Extract all places from any public Google Maps shared list. Get 30+ fields per place: name, address, GPS, phone, website, hours, rating, and photos. Works with Google Sheets, Make, n8n, Zapier. No API key needed. $1.99/1k.", "version": "0.1", "x-build-id": "fWd0CP1Cm2xnJJhbj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~google-maps-list-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-google-maps-list-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/getascraper~google-maps-list-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-google-maps-list-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/getascraper~google-maps-list-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-google-maps-list-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": [ "listUrls" ], "properties": { "listUrls": { "title": "List URLs", "type": "array", "description": "One or more Google Maps shared list URLs. Accepts short links (maps.app.goo.gl/...) and full URLs (google.com/maps/...).", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only include places with this star rating or higher. Set to 0 to include all places. Requires full place details to be on.", "default": 0 }, "minReviewCount": { "title": "Minimum review count", "minimum": 0, "type": "integer", "description": "Only include places with at least this many reviews. Set to 0 to include all. Requires full place details to be on.", "default": 0 }, "filterByCountry": { "title": "Country filter", "type": "string", "description": "Only include places located in this country. Use the full country name as it appears on Google Maps, e.g. France, Japan, United States. Leave blank to include all countries.", "default": "" }, "filterByCategories": { "title": "Category filter", "type": "array", "description": "Only include places that match at least one of these categories, e.g. Restaurant, Coffee shop, Hotel. Leave empty to include all categories.", "default": [] }, "onlyWithWebsite": { "title": "Only places with a website", "type": "boolean", "description": "Skip places that have no website listed on Google Maps. Requires full place details to be on.", "default": false }, "onlyWithPhone": { "title": "Only places with a phone number", "type": "boolean", "description": "Skip places that have no phone number on Google Maps. Useful for lead gen runs. Requires full place details to be on.", "default": false }, "excludePermanentlyClosed": { "title": "Exclude permanently closed places", "type": "boolean", "description": "Skip places marked as permanently closed on Google Maps. Recommended for lead gen and travel planning.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Shared datacenter proxies (the default) work reliably for all normal runs. Switch to Residential only if a very large run starts hitting rate limits.", "default": { "useApifyProxy": true } }, "enrichPlaces": { "title": "Fetch full place details", "type": "boolean", "description": "Fetch each place's detail page for rating, phone, website, hours, and photos. Adds one request per place. Required for most place filters to work. Default: on.", "default": true }, "maxItems": { "title": "Max places", "minimum": 0, "type": "integer", "description": "Maximum total number of places to extract across all lists. 0 means no limit.", "default": 0 } } }, "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 } } } } } } } } } } ```