# Google Maps MCP Scraper — Places, Reviews, Hours & Photos (`muhammadafzal/google-maps-scraper`) Actor Scrape Google Maps for places, reviews, business hours, photos, ratings, and competitor data. Structured JSON with full location metadata. Built for AI agents — every field is machine-readable. Search by keyword + location, filter by rating. - **URL**: https://apify.com/muhammadafzal/google-maps-scraper.md - **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community) - **Categories:** Lead generation, MCP servers, Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $10.00 / 1,000 results 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 MCP Scraper — Places, Reviews, Hours & Photos for AI Agents Scrape Google Maps for places, business hours, reviews, photos, ratings, and competitor data. Returns structured JSON with full location metadata — every field is machine-readable so AI agents and LLMs can search, compare, and analyze locations programmatically. **Zero MCP Google Maps actors exist on the market.** 25K+ users run non-MCP Maps scrapers — but AI agents need structured tool access. This is the first Maps scraper designed from the ground up as an MCP tool. ### Killer Features for AI Agents - **Business hours** — Day-by-day operating hours exposed as structured JSON objects, ready for scheduling logic - **Reviews & ratings** — Full review text snippets and star ratings for sentiment analysis and quality filtering - **Photo URLs** — Direct image links for multimodal agents that process visual data - **Competitor density analysis** — Search any keyword in any location to map competitive landscapes - **Geo-coordinates** — Precise lat/lng for distance calculations, clustering, and map visualizations ### Features - **Lightning fast** — 100 places scraped in ~5 seconds via pure API extraction - **Rich place metadata** — names, addresses, phones, websites, categories, price ranges, and descriptions - **Review extraction** — star ratings, total review counts, and review text snippets for each place - **Business hours** — day-by-day operating hours (e.g., "Monday": "9AM-9PM") and current open/closed status - **Photo URLs** — thumbnail and gallery photo links for visual data and multimodal processing - **Rating filtering** — only return places above a minimum star rating threshold - **Multi-query support** — search multiple keywords or locations in a single run - **Location biasing** — optional GPS coordinates to prioritize results near a specific point - **12-country localization** — country and language filtering for global searches - **Automatic pagination** — fetches up to 200 results per query with intelligent page handling - **Structured JSON output** — clean, well-formatted data ready for AI pipelines, databases, or analysis ### Use Cases - **AI agent enrichment** — give LLMs real-time access to business data, reviews, and location info for trip planning, local searches, and recommendations - **Competitor analysis** — map every competitor in a market with ratings, reviews, and location data - **Location intelligence** — analyze business density, category distribution, and rating patterns by geography - **Lead generation** — find businesses by type and location with phone numbers and websites for outreach - **Market research** — assess price ranges, review sentiment, and competitive positioning in any market - **Review monitoring** — track review counts and sentiment across locations over time - **Real estate analysis** — evaluate neighborhood amenities — restaurants, shops, services — for property assessments ### Input | Field | Type | Default | Description | |-------|------|---------|-------------| | `searchQueries` | string[] | `["restaurants in Austin TX"]` | Keywords with location to search (e.g., "plumbers in Chicago") | | `locationCoords` | string | `""` | Optional GPS coordinates to bias results — format: `"lat,lng"` | | `maxResults` | integer | `20` | Max places per query (1–200) | | `countryCode` | string | `"us"` | Two-letter country code for localization | | `languageCode` | string | `"en"` | Language code for results | | `includeReviews` | boolean | `true` | Include review text snippets in output | | `includePhotos` | boolean | `true` | Include photo and thumbnail URLs | | `minRating` | number | `0` | Only return places rated ≥ this value (0 = no filter) | | `maxRequestRetries` | integer | `3` | Max API retry attempts on failure | ### Output Each place record includes 21 fields of structured metadata: | Field | Type | Description | |-------|------|-------------| | `placeId` | string | Google Maps unique place identifier | | `title` | string | Business or place name | | `address` | string | Full street address | | `phoneNumber` | string\|null | Business phone number | | `website` | string\|null | Business website URL | | `rating` | number\|null | Google Maps star rating (1.0–5.0) | | `reviewsCount` | integer\|null | Total number of reviews | | `reviews` | string[] | Review text snippets | | `latitude` | number\|null | Geographic latitude | | `longitude` | number\|null | Geographic longitude | | `category` | string\|null | Primary business category | | `type` | string\|null | Google Maps place type | | `priceRange` | string\|null | Price level ($ to $$$$) | | `openingHours` | object\|null | Day-by-day hours (e.g., `{"Monday":"9AM-9PM"}`) | | `openingState` | string\|null | Current open/closed status | | `description` | string\|null | Place description snippet | | `thumbnailUrl` | string\|null | Primary photo thumbnail URL | | `photos` | string[] | Additional photo URLs | | `cid` | string\|null | Google Maps CID number | | `googleUrl` | string\|null | Direct Google Maps link | | `scrapedAt` | string | ISO 8601 timestamp | | `searchQuery` | string | Original search query | ### Example Usage #### Restaurant Discovery ```json { "searchQueries": ["italian restaurants in Brooklyn NY", "pizza places in Manhattan"], "maxResults": 50, "minRating": 4.0, "includeReviews": true } ```` #### Competitor Research ```json { "searchQueries": ["coffee shops in Seattle WA"], "maxResults": 200, "locationCoords": "47.6062,-122.3321", "includeReviews": false, "includePhotos": true } ``` #### Lead Generation ```json { "searchQueries": ["dentists in Phoenix AZ", "plumbers in Denver CO", "electricians in Portland OR"], "maxResults": 30, "minRating": 3.5, "includeReviews": false, "includePhotos": false } ``` #### Quick Lookup ```json { "searchQueries": ["hardware stores near me"], "maxResults": 10, "locationCoords": "40.7128,-74.0060" } ``` ### Pricing This actor uses a **pay-per-result pricing model at $0.008 per place scraped**. | Places | Cost | |--------|------| | 10 places | $0.10 | | 20 places | $0.20 | | 100 places | $1 | | 200 places | $2 | Fast, reliable location data extraction. No API keys, no setup, no infrastructure required. ### Example Output ```json { "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4", "title": "Joe's Coffee", "address": "242 W 2nd St, Austin, TX 78701", "phoneNumber": "(512) 555-0199", "website": "https://www.joescoffee.com", "rating": 4.7, "reviewsCount": 326, "reviews": [ "Best latte in Austin! The house-roasted beans are incredible.", "Cozy atmosphere, fast WiFi, and friendly baristas. Perfect workspace." ], "latitude": 30.2665, "longitude": -97.7451, "category": "Coffee Shop", "type": "cafe", "priceRange": "$$", "openingHours": { "Monday": "7AM-8PM", "Tuesday": "7AM-8PM", "Wednesday": "7AM-8PM", "Thursday": "7AM-9PM", "Friday": "7AM-9PM", "Saturday": "8AM-9PM", "Sunday": "8AM-6PM" }, "openingState": "Open", "description": "House-roasted coffee and fresh pastries in a cozy downtown space with free WiFi.", "thumbnailUrl": "https://lh5.googleusercontent.com/p/thumbnail-url", "photos": [], "cid": "12345678901234567890", "googleUrl": "https://www.google.com/maps/place/?q=place_id:ChIJN1t_tDeuEmsRUsoyG83frY4", "scrapedAt": "2026-05-04T12:00:00.000Z", "searchQuery": "coffee shops in Austin TX" } ``` ### Why This Google Maps Scraper? - **No browser or proxy needed** — pure API-based extraction is faster, cheaper, and more reliable than headless browsers - **Zero setup** — works out of the box with no API keys, no configuration, no infrastructure - **Built for AI agents** — every field is typed and machine-readable for direct LLM consumption - **MCP-native** — designed as an MCP tool from day one, not retrofitted - **Consistent structured data** — every record follows the same 21-field schema for reliable processing - **Global coverage** — 12 countries, 9 languages, location biasing for proximity searches # Actor input Schema ## `searchQueries` (type: `array`): Enter one or more search queries to find places on Google Maps (e.g., 'restaurants in Austin TX', 'plumbers in Chicago', 'hotels near Central Park'). Each query returns up to maxResults places. Combine with locationCoords to bias results toward a specific area. ## `locationCoords` (type: `string`): Optional GPS coordinates to bias search results. Format as 'latitude,longitude' (e.g., '40.7128,-74.0060' for NYC). Leave empty for general search. ## `maxResults` (type: `integer`): Maximum number of places to return per search query. Default is 20. Set lower for quick lookups, higher for comprehensive searches (up to 200 per query). ## `countryCode` (type: `string`): Two-letter country code for search localization (e.g., 'us' for United States, 'gb' for United Kingdom). ## `languageCode` (type: `string`): Language code for search results (e.g., 'en' for English, 'es' for Spanish). ## `includePhotos` (type: `boolean`): Include thumbnail image URLs in output. Disable for smaller output size. ## `minRating` (type: `number`): Only return places with rating >= this value (0 = no filter). Set to 4.0 for highly-rated businesses. ## `maxRequestRetries` (type: `integer`): Maximum number of retry attempts if a search request fails. Increase for reliability on unstable connections. ## Actor input object example ```json { "searchQueries": [ "coffee shops near Central Park" ], "locationCoords": "", "maxResults": 20, "countryCode": "us", "languageCode": "en", "includePhotos": true, "minRating": 0, "maxRequestRetries": 3 } ``` # 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 = { "searchQueries": [ "coffee shops near Central Park" ] }; // Run the Actor and wait for it to finish const run = await client.actor("muhammadafzal/google-maps-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 = { "searchQueries": ["coffee shops near Central Park"] } # Run the Actor and wait for it to finish run = client.actor("muhammadafzal/google-maps-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 '{ "searchQueries": [ "coffee shops near Central Park" ] }' | apify call muhammadafzal/google-maps-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=muhammadafzal/google-maps-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps MCP Scraper — Places, Reviews, Hours & Photos", "description": "Scrape Google Maps for places, reviews, business hours, photos, ratings, and competitor data. Structured JSON with full location metadata. Built for AI agents — every field is machine-readable. Search by keyword + location, filter by rating.", "version": "1.0", "x-build-id": "Pfz4cjUjo3s7krnMo" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-google-maps-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/muhammadafzal~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-muhammadafzal-google-maps-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/muhammadafzal~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-google-maps-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", "properties": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "Enter one or more search queries to find places on Google Maps (e.g., 'restaurants in Austin TX', 'plumbers in Chicago', 'hotels near Central Park'). Each query returns up to maxResults places. Combine with locationCoords to bias results toward a specific area.", "default": [ "restaurants in Austin TX" ], "items": { "type": "string" } }, "locationCoords": { "title": "Location Coordinates", "type": "string", "description": "Optional GPS coordinates to bias search results. Format as 'latitude,longitude' (e.g., '40.7128,-74.0060' for NYC). Leave empty for general search.", "default": "" }, "maxResults": { "title": "Max Results Per Query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of places to return per search query. Default is 20. Set lower for quick lookups, higher for comprehensive searches (up to 200 per query).", "default": 20 }, "countryCode": { "title": "Country Code", "enum": [ "us", "gb", "ca", "au", "de", "fr", "es", "it", "jp", "br", "in", "mx" ], "type": "string", "description": "Two-letter country code for search localization (e.g., 'us' for United States, 'gb' for United Kingdom).", "default": "us" }, "languageCode": { "title": "Language", "enum": [ "en", "es", "fr", "de", "it", "pt", "ja", "ko", "zh-CN" ], "type": "string", "description": "Language code for search results (e.g., 'en' for English, 'es' for Spanish).", "default": "en" }, "includePhotos": { "title": "Include Photo URLs", "type": "boolean", "description": "Include thumbnail image URLs in output. Disable for smaller output size.", "default": true }, "minRating": { "title": "Minimum Rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only return places with rating >= this value (0 = no filter). Set to 4.0 for highly-rated businesses.", "default": 0 }, "maxRequestRetries": { "title": "Max Request Retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of retry attempts if a search request fails. Increase for reliability on unstable connections.", "default": 3 } } }, "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 } } } } } } } } } } ```