# Google Maps Scraper with Reviews (`thodor/google-maps-scraper-with-reviews`) Actor Scrape every business in any city from Google Maps: full details, ratings, hours, and 60+ attributes included. Reviews available as add-on. - **URL**: https://apify.com/thodor/google-maps-scraper-with-reviews.md - **Developed by:** [Thodor](https://apify.com/thodor) (community) - **Categories:** Lead generation, Other, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 place scrapeds This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 with Reviews Scrape every business in any city from Google Maps — with full details, opening hours, and 60+ attributes included in every result. No per-detail add-on fees. Reviews available as add-on. Run via API, schedule runs, or integrate with webhooks. **Google Maps only shows 120 results per search.** This scraper automatically breaks that limit by searching across your entire target area and deduplicating the results. Type a city name, get every matching business. ### Input | Parameter | Description | Example | |-----------|-------------|---------| | Search query | What to search for, just like the Google Maps search bar | `restaurant`, `plumber`, `hotel` | | Location | Any city, region, or country — geocoded automatically | `New York, USA`, `Berlin, Germany`, `Tokyo` | | Max results | Cap the number of places returned | `100`, `500`, `2000` | | Scrape reviews | Fetch the full review history for every place (on by default) | `true`, `false` | | Max reviews per place | Limit how many reviews to collect per place | `100`, `500`, `5000` | | Language | Language for results (70+ locales supported) | `en`, `nl`, `de`, `ja`, `fr` | | Country | Country code for Google locale | `us`, `be`, `de`, `jp` | Just provide a search term and a location. The scraper handles the rest — geocoding the area, searching across the full region, and deduplicating results. ### What you get for every place - Business name, categories, type - Full address, street, city, country, neighborhood - Phone number (local + international) - Website URL + domain - Rating + review count - Price level - GPS coordinates (lat/lng) - Full weekly opening hours - Current open/closed status - Service options (dine-in, takeaway, delivery) - Accessibility (wheelchair entrance, parking, toilet) - Atmosphere (casual, romantic, trendy, upmarket) - Highlights (great coffee, live music, fireplace) - Offerings (vegetarian, halal, organic, alcohol) - Payments accepted (cards, NFC, cash) - Parking info - Photo URL - Place ID, CID, Google Maps path - Timezone Other scrapers charge $4/1,000 for the base listing and another $2-3/1,000 for hours, service options, and business attributes. Here, everything above is included in every result. ### Reviews Enable review scraping to get the full review history for every place — text, star ratings, detailed ratings, dates, author details, owner responses, and review images. ```json { "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2pkRmVVVlRhazVoUjJwT2VqbEtkRWgzVUdOc2IyYxAB", "name": "Isatta Bassie", "reviewer_photo_url": "https://lh3.googleusercontent.com/a-/ALV-UjVPL1SQUdvuxpHveWTjFNQhM2p-HIjkqB7TLLPFXR0QboWq4BQ=s120-c-rp-mo-br100", "reviewer_id": "109283811363605044639", "reviewer_number_of_reviews": 5, "is_local_guide": false, "reviewer_url": "https://www.google.com/maps/contrib/109283811363605044639/reviews?hl=en", "published_at_date": "2026-01-11T02:01:27Z", "publish_at": "2 months ago", "stars": 5, "text": "10/10! Super friendly staff and everything was delicious. I went in anticipating oxtails but they were out, so I opted for jerk chicken, Mac and cheese and rice and peas...", "text_translated": null, "review_url": "https://www.google.com/maps/reviews/data=!4m8!14m7!1m6!2m5!1sCi9DQUlRQUNvZENodHljRjlvT2pkRmVVVlRhazVoUjJwT2VqbEtkRWgzVUdOc2IyYxAB!2m1!1s0x0:0x148b4752f2b99ae2...", "review_detailed_rating": [ {"category": "Food", "rating": 5}, {"category": "Service", "rating": 5}, {"category": "Atmosphere", "rating": 5} ], "likes_count": 1, "review_origin": "Google", "response_from_owner_text": null, "response_from_owner_date": null, "review_image_urls": [ "https://lh3.googleusercontent.com/geougc-cs/ABOP9puDf15-ns4L2OZGnMjr2tuFgPevIH10FxjRdejn5Yfe3I..." ], "review_context": "en" } ```` Reviews are charged separately at $0.40 per 1,000 reviews. ### Example output ```json { "name": "La Donna Re's", "place_id": "0x89c25d8a10261a7d:0x148b4752f2b99ae2", "cid": "ChIJfRomEIpdwokR4pq58lJHixQ", "gmap_path": "/g/11t6hj5f6q", "address_parts": ["325 Lewis Ave", "Brooklyn, NY 11221"], "full_address": "La Donna Re's, 325 Lewis Ave, Brooklyn, NY 11221", "street": "325 Lewis Ave, Brooklyn, NY 11221", "city": "Bedford-Stuyvesant", "country": "US", "neighborhood": "Bedford-Stuyvesant", "timezone": "America/New_York", "rating": 4.7, "review_count": 117, "price_level": "$$", "categories": ["Soul food restaurant", "Restaurant"], "lat": 40.684546, "lng": -73.9351578, "phone": "(347) 601-8264", "phone_intl": "+1 347-601-8264", "hours_status": "Open · Closes 9 PM", "opening_hours": [ {"day": "Friday", "hours": "3–9 PM"}, {"day": "Saturday", "hours": "1:30–9 PM"}, {"day": "Sunday", "hours": "1:30–7 PM"}, {"day": "Monday", "hours": "Closed"}, {"day": "Tuesday", "hours": "Closed"}, {"day": "Wednesday", "hours": "3–9 PM"}, {"day": "Thursday", "hours": "3–9 PM"} ], "photo_url": "https://lh6.googleusercontent.com/...", "type": "SearchResult.TYPE_AMERICAN_RESTAURANT", "additional_info": [ {"category": "From the business", "name": "Identifies as Black-owned", "value": true}, {"category": "From the business", "name": "Identifies as women-owned", "value": true}, {"category": "Service options", "name": "Delivery", "value": true}, {"category": "Service options", "name": "Takeout", "value": true}, {"category": "Service options", "name": "Dine-in", "value": true}, {"category": "Highlights", "name": "Great dessert", "value": true}, {"category": "Popular for", "name": "Lunch", "value": true}, {"category": "Accessibility", "name": "Wheelchair accessible parking lot", "value": true}, {"category": "Offerings", "name": "Comfort food", "value": true}, {"category": "Atmosphere", "name": "Casual", "value": true}, {"category": "Atmosphere", "name": "Cozy", "value": true}, {"category": "Payments", "name": "Credit cards", "value": true}, {"category": "Payments", "name": "NFC mobile payments", "value": true}, {"category": "Children", "name": "Good for kids", "value": true}, {"category": "Parking", "name": "Free street parking", "value": true} ], "reviews": ["... see Reviews section below"] } ``` ### Business attributes | Field | Type | Description | |-------|------|-------------| | `name` | `string` | Business name | | `place_id` | `string` | Google Maps hex place ID | | `cid` | `string` | Google Maps CID | | `gmap_path` | `string` | Short Google Maps path (`/g/...`) | | `address_parts` | `string[]` | Street and postal code as separate parts | | `full_address` | `string` | Full formatted address | | `street` | `string` | Street address with postal code | | `city` | `string` | City name | | `country` | `string` | Country code (e.g. `BE`, `US`) | | `neighborhood` | `string` | Neighborhood or district | | `timezone` | `string` | IANA timezone (e.g. `Europe/Brussels`) | | `rating` | `float` | Average rating (0-5) | | `review_count` | `int` | Number of reviews | | `price_level` | `string` | Price indicator (e.g. `$`, `$$`, `€€`) | | `categories` | `string[]` | Business categories | | `website` | `string` | Business website URL | | `website_domain` | `string` | Domain name only | | `lat` | `float` | Latitude | | `lng` | `float` | Longitude | | `phone` | `string` | Local phone number | | `phone_intl` | `string` | International phone number | | `hours_status` | `string` | Current open/closed status | | `opening_hours` | `{day, hours}[]` | Full weekly schedule | | `photo_url` | `string` | Primary photo URL | | `type` | `string` | Google Maps place type | | `additional_info` | `{category, name, value}[]` | Business attributes (see below) | The `additional_info` field contains detailed business attributes. These vary by business type but commonly include: - **Service options** — Dine-in, Takeaway, Delivery, Outdoor seating - **Highlights** — Great cocktails, Great coffee, Live music, Fireplace - **Popular for** — Lunch, Dinner, Solo dining - **Accessibility** — Wheelchair-accessible entrance, parking, seating, toilet - **Offerings** — Alcohol, Vegetarian options, Halal food, Organic dishes - **Dining options** — Breakfast, Brunch, Lunch, Dinner, Catering - **Amenities** — Bar on site, Toilet, Gender-neutral toilets - **Atmosphere** — Casual, Cosy, Romantic, Trendy, Upmarket - **Crowd** — Family friendly, Groups, LGBTQ+ friendly - **Planning** — Accepts reservations, Reservations required - **Payments** — Credit cards, Debit cards, NFC mobile payments - **Children** — Good for kids, Kids' menu, High chairs - **Parking** — Free parking, Paid street parking All attributes use a flat `{"category": "...", "name": "...", "value": true/false}` format — easy to filter in spreadsheets, sort in databases, and import into any tool without nested parsing. ### Use cases - **Review & sentiment analysis** — Collect every review for businesses in a market to track reputation, detect trends, and benchmark customer satisfaction - **Lead generation** — Build prospect lists with phone numbers, websites, and business details for any industry in any city - **Competitive analysis** — Map every competitor in a market, compare ratings, review counts, price levels, and service offerings - **Market research** — Analyze business density, popular categories, and service availability across regions - **Local SEO** — Audit Google Maps presence for your clients vs. competitors - **Site selection** — Find areas with high or low density of specific business types using GPS coordinates ### FAQ **How is this different from the Google Places API?** The official Google Places API caps at 60 results per query and costs $17 per 1,000 requests. This scraper returns unlimited results per search area at a fraction of the cost, with richer data (business attributes, full hours, service options) included. **How does it get more than 120 results?** Google Maps displays a maximum of 120 businesses per search view. The scraper automatically divides your target area into smaller sections, searches each one, and merges the results — giving you complete coverage of the entire area. **What locations are supported?** Any location Google Maps supports. Type a city name (`Paris`), a region (`Bavaria, Germany`), a full address, or even a country. The location is geocoded automatically. **What languages are supported?** All 70+ languages supported by Google Maps. Set the language parameter to any Google locale code: `en`, `de`, `fr`, `ja`, `nl`, `es`, `pt`, `zh`, `ko`, `ar`, etc. **What output formats are available?** Results are available as JSON, CSV, and Excel. You can also export directly to Google Sheets via the Apify platform. **Are there rate limits?** No artificial limits. You can run multiple searches concurrently. The scraper automatically scales across the search area. # Actor input Schema ## `query` (type: `string`): What to search for on Google Maps (e.g. 'restaurant', 'plumber', 'hotel') ## `location` (type: `string`): City, region, or address to search in (geocoded automatically) ## `hl` (type: `string`): Language code for results (e.g. 'nl', 'en', 'fr', 'de') ## `gl` (type: `string`): Country code (e.g. 'be', 'nl', 'de', 'fr', 'us') ## `max_results` (type: `integer`): Maximum number of places to return. Grid search subdivides the area automatically to find more. ## `scrape_reviews` (type: `boolean`): Fetch all reviews for each place (slower, more data) ## `max_reviews_per_place` (type: `integer`): Maximum reviews to fetch per place (only if scrape\_reviews is true) ## Actor input object example ```json { "query": "restaurant", "location": "New York, USA", "hl": "en", "gl": "us", "max_results": 100, "scrape_reviews": true, "max_reviews_per_place": 500 } ``` # 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 = { "query": "restaurant", "location": "New York, USA", "hl": "en", "gl": "us", "max_results": 100, "max_reviews_per_place": 500 }; // Run the Actor and wait for it to finish const run = await client.actor("thodor/google-maps-scraper-with-reviews").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 = { "query": "restaurant", "location": "New York, USA", "hl": "en", "gl": "us", "max_results": 100, "max_reviews_per_place": 500, } # Run the Actor and wait for it to finish run = client.actor("thodor/google-maps-scraper-with-reviews").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 '{ "query": "restaurant", "location": "New York, USA", "hl": "en", "gl": "us", "max_results": 100, "max_reviews_per_place": 500 }' | apify call thodor/google-maps-scraper-with-reviews --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=thodor/google-maps-scraper-with-reviews", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Scraper with Reviews", "description": "Scrape every business in any city from Google Maps: full details, ratings, hours, and 60+ attributes included. Reviews available as add-on.", "version": "0.4", "x-build-id": "LrxTYVQvHUQq3XFCp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thodor~google-maps-scraper-with-reviews/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thodor-google-maps-scraper-with-reviews", "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/thodor~google-maps-scraper-with-reviews/runs": { "post": { "operationId": "runs-sync-thodor-google-maps-scraper-with-reviews", "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/thodor~google-maps-scraper-with-reviews/run-sync": { "post": { "operationId": "run-sync-thodor-google-maps-scraper-with-reviews", "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": [ "query", "location" ], "properties": { "query": { "title": "Search Query", "type": "string", "description": "What to search for on Google Maps (e.g. 'restaurant', 'plumber', 'hotel')" }, "location": { "title": "Location", "type": "string", "description": "City, region, or address to search in (geocoded automatically)" }, "hl": { "title": "Language", "type": "string", "description": "Language code for results (e.g. 'nl', 'en', 'fr', 'de')" }, "gl": { "title": "Country", "type": "string", "description": "Country code (e.g. 'be', 'nl', 'de', 'fr', 'us')" }, "max_results": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of places to return. Grid search subdivides the area automatically to find more." }, "scrape_reviews": { "title": "Scrape Reviews", "type": "boolean", "description": "Fetch all reviews for each place (slower, more data)", "default": true }, "max_reviews_per_place": { "title": "Max Reviews Per Place", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum reviews to fetch per place (only if scrape_reviews is true)" } } }, "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 } } } } } } } } } } ```