# Google Maps Scraper: Leads, Reviews & Business Data (`shadowextractor/google-maps-business-intelligence`) Actor Scrape Google Maps places by keyword, location, URL, or Place ID. Extract business contacts, emails, phones, websites, ratings, review text, photos, opening hours, coordinates, and lead-quality signals. - **URL**: https://apify.com/shadowextractor/google-maps-business-intelligence.md - **Developed by:** [Shadow Extractor](https://apify.com/shadowextractor) (community) - **Categories:** Lead generation, Automation, Jobs - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.49 / 1,000 google maps results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Business Leads Scraper Turn Google Maps searches into structured business datasets with place details, public contacts, reviews, photos, ratings, opening hours, and lead-quality scores. Search by **keyword and location**, scrape known businesses from **Google Maps URLs or IDs**, or enrich a dataset from an earlier Apify run. Results are ready for CSV, Excel, JSON, CRM imports, market research, and review analysis. > Start simple: enter a search term, add a location, and run. The default setup returns detailed place records and checks business websites for public contact information. --- ### โœจ What You Can Collect | Data group | Available fields | |---|---| | ๐Ÿข Business identity | Name, subtitle, primary category, all categories, description, owner information | | ๐Ÿ“ Location | Full address, street, city, state, ZIP/postal code, country, coordinates, plus code, time zone | | ๐Ÿ“ž Contact data | Google Maps phone, website, domain, public emails, additional phones, contact-page URLs | | ๐ŸŒ Social profiles | Facebook, Instagram, LinkedIn, X/Twitter, YouTube, TikTok, Pinterest, Discord | | โญ Reputation | Rating, review count, review text, reviewer, date, likes, photos, owner response when available | | ๐Ÿ•’ Business details | Opening hours, current open state, price level, attributes, highlights, reservation links | | ๐Ÿ–ผ๏ธ Media | Main image, photo URL list, and flat `photo1Url` to `photo5Url` columns | | ๐ŸŽฏ Lead quality | `leadScore`, `contactCompletenessScore`, and field-availability signals | | ๐Ÿ”— Google identifiers | Maps URL, Place ID, feature/data ID, CID, KG MID | Google Maps and business websites do not expose every field for every place. Missing optional data is omitted instead of being filled with fake values. --- ### ๐Ÿš€ Quick Start #### In Apify Console 1. Choose **Full places + enrichment**. 2. Enter one or more search terms, for example `dentist` or `coffee shop`. 3. Enter one or more locations, for example `Austin, TX`. 4. Choose how many places to collect per search. 5. Keep contact enrichment enabled if you need emails and social profiles. 6. Click **Start** and open **Output โ†’ Results**. An empty API input is also safe: it runs a small example search for restaurants in New York. #### Minimal JSON Input ```json { "searchStringsArray": ["dentist"], "locationQueries": ["Austin, TX"], "maxCrawledPlacesPerSearch": 20 } ```` #### Rich Lead-Generation Input ```json { "mode": "FULL", "searchStringsArray": ["dentist", "orthodontist"], "locationQueries": ["Austin, TX", "Round Rock, TX"], "maxCrawledPlacesPerSearch": 50, "scrapePlaceDetailPage": true, "scrapeContacts": true, "maxContactPages": 3, "placeMinimumStars": 4, "website": "withWebsite", "maxImages": 5, "language": "en", "countryCode": "US" } ``` Each search term is combined with each location. The example above creates four searches: ```text dentist ร— Austin, TX dentist ร— Round Rock, TX orthodontist ร— Austin, TX orthodontist ร— Round Rock, TX ``` *** ### ๐Ÿงญ Choose the Right Mode | Mode | Use it when | Accepted source | Output | |---|---|---|---| | `FULL` | You want search results with optional details, contacts, reviews, and photos | Search terms and locations; direct place inputs can also be included | Enriched place rows or review rows | | `SEARCH` | You want keyword-and-location discovery | Search terms and locations | Place rows; enrichment is controlled by the detail/contact/review switches | | `DETAIL` | You already know the businesses | Maps URLs, Place IDs, feature IDs, or an input dataset | Detailed place rows | | `REVIEWS` | You want review-level data for known places | Direct place inputs | One dataset row per review | | `CONTACTS` | You want public website contacts for known places | Direct place inputs | Place rows enriched with emails, phones, and social profiles | #### Workflow Map ```text Keyword + location โ”€โ”€โ–บ SEARCH / FULL โ”€โ”€โ–บ Google Maps places โ”‚ Maps URL / ID โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ DETAIL โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”œโ”€โ”€โ–บ Place details + photos Previous dataset โ”€โ”€โ”€โ”€โ–บ DETAIL / CONTACTS โ”€โ”€โ”€โ”€โ”€โ”€โ”ค โ”œโ”€โ”€โ–บ Website contacts Known place โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–บ REVIEWS โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ–บ Review rows ``` *** ### ๐Ÿ”Ž Search Inputs | Field | What it controls | |---|---| | `searchStringsArray` | Keywords or business types such as `restaurant`, `plumber`, `hotel`, or `car dealer` | | `locationQueries` | Countries, cities, neighborhoods, addresses, ZIP codes, or postal codes | | `maxCrawledPlacesPerSearch` | Maximum saved places for each keyword and location combination | | `language` | Language context for Google Maps results | | `countryCode` | Country context such as `US`, `GB`, `DE`, or `FR` | #### Search Several Markets at Once ```json { "mode": "SEARCH", "searchStringsArray": ["coworking space", "business center"], "locationQueries": ["Berlin, Germany", "Munich, Germany"], "maxCrawledPlacesPerSearch": 25, "scrapePlaceDetailPage": false, "scrapeContacts": false, "scrapeReviews": false, "language": "de", "countryCode": "DE" } ``` *** ### ๐Ÿ”— Direct Place Inputs Direct modes accept several source types, and duplicate places are removed automatically. | Field | Accepted value | |---|---| | `startUrls` | Google Maps place or search URLs | | `placeIds` | Place IDs such as `ChIJ...` | | `featureIds` | Google Maps data/feature IDs such as `0x...:0x...` | | `datasetId` | An Apify dataset containing place URLs or identifiers | The input dataset may contain any of these fields: `googleMapsUrl`, `url`, `sourceUrl`, `placeUrl`, `placeId`, `dataId`, `featureId`, `fid`, or `cid`. #### Scrape Known Places ```json { "mode": "DETAIL", "placeIds": [ "ChIJvSQIgqFZwokRFYQbJdzceSs" ], "scrapePlaceDetailPage": true, "scrapeContacts": true, "maxContactPages": 2, "maxImages": 10 } ``` #### Enrich a Previous Dataset ```json { "mode": "CONTACTS", "datasetId": "YOUR_DATASET_ID", "scrapeContacts": true, "maxContactPages": 3 } ``` *** ### ๐Ÿ“‡ Public Contact Enrichment Enable `scrapeContacts` to inspect the business website and collect publicly displayed contact details. The Actor can return: - primary Google Maps phone; - public email addresses; - additional website phone numbers; - contact, about, team, and legal page URLs; - Facebook, Instagram, LinkedIn, X/Twitter, YouTube, TikTok, Pinterest, and Discord links; - website response status and a readable website error when enrichment is unavailable. Use `maxContactPages` to control how many website pages are checked for each business. A value of `1` is the fastest option; `3` to `5` provides broader coverage. ```json { "mode": "FULL", "searchStringsArray": ["roofing contractor"], "locationQueries": ["Denver, CO"], "maxCrawledPlacesPerSearch": 100, "website": "withWebsite", "scrapeContacts": true, "maxContactPages": 3 } ``` > Emails are usually not published directly on Google Maps. They are collected from the public business website when available. *** ### โญ Reviews There are two useful review layouts. #### Reviews Attached to Each Place Use this when one row per business is more important than spreadsheet-friendly review rows. ```json { "mode": "FULL", "searchStringsArray": ["boutique hotel"], "locationQueries": ["Paris, France"], "maxCrawledPlacesPerSearch": 10, "scrapeReviews": true, "maxReviews": 10, "reviewsSort": "newest", "outputMode": "PLACE_ITEMS" } ``` #### One Row per Review Use this layout for sentiment analysis, customer-support workflows, and review exports. `REVIEWS` mode requires direct place input and automatically uses review rows. If `maxReviews` is left at `0` in this mode, the Actor requests up to 100 reviews per place. ```json { "mode": "REVIEWS", "placeIds": [ "ChIJvSQIgqFZwokRFYQbJdzceSs" ], "maxReviews": 50, "reviewsSort": "newest" } ``` Available sort orders: - `relevant` โ€” most relevant; - `newest` โ€” newest first; - `highest` โ€” highest rating first; - `lowest` โ€” lowest rating first. Every review row keeps its place identity through `placeTitle`, `placeId`, `dataId`, `cid`, and `placeUrl`. *** ### ๐ŸŽ›๏ธ Filters Filters are optional and are applied before a place is saved. | Field | Example | Behavior | |---|---|---| | `categoryFilterWords` | `["dentist", "orthodontist"]` | Keeps places whose category contains at least one word | | `placeMinimumStars` | `4.2` | Drops lower-rated places when a rating is available | | `website` | `withWebsite` | Keeps all places, only places with a website, or only places without one | | `skipClosedPlaces` | `true` | Skips permanently closed places when Google exposes that status | #### Find Strong Local Leads ```json { "mode": "FULL", "searchStringsArray": ["physiotherapy clinic"], "locationQueries": ["London, UK"], "maxCrawledPlacesPerSearch": 100, "categoryFilterWords": ["physiotherapist", "physical therapy"], "placeMinimumStars": 4.3, "website": "withWebsite", "skipClosedPlaces": true, "scrapeContacts": true } ``` #### Find Businesses Without Websites ```json { "mode": "SEARCH", "searchStringsArray": ["plumber"], "locationQueries": ["Phoenix, AZ"], "maxCrawledPlacesPerSearch": 100, "website": "withoutWebsite", "scrapePlaceDetailPage": false, "scrapeContacts": false } ``` *** ### ๐Ÿ“ค Output Place and review records are written to the default dataset. The Apify Output tab opens the **Results** table, and the dataset menu provides focused views. | View | Best for | |---|---| | **Overview** | Business name, category, address, phone, website, rating, review count, score, photo, and Maps URL | | **Lead generation** | Flat CRM-ready phones, emails, social links, scores, and location columns | | **Contacts** | Full contact arrays, website status, social profiles, and pages checked | | **Reviews** | One review per row when review-row output is used | | **Photos** | Main photo and five image columns that render directly in Apify | | **Diagnostics** | Input warnings and recoverable source issues with suggested actions | | **All fields** | Complete raw dataset shape for JSON export and custom analysis | Download any dataset view as **JSON, CSV, Excel, XML, or RSS** from Apify Storage. #### Example Place Record ```json { "recordType": "place", "title": "Example Coffee Roasters", "categoryName": "Coffee shop", "categories": ["Coffee shop", "Cafe"], "address": "123 Market St, Austin, TX 78701", "city": "Austin", "state": "TX", "postalCode": "78701", "countryCode": "US", "latitude": 30.2672, "longitude": -97.7431, "phone": "+1 512-555-0184", "website": "https://example.com/", "domain": "example.com", "email": "hello@example.com", "emails": ["hello@example.com"], "instagram": "https://www.instagram.com/example/", "rating": 4.7, "totalScore": 4.7, "reviewsCount": 842, "imageUrl": "https://lh3.googleusercontent.com/...", "photo1Url": "https://lh3.googleusercontent.com/...", "placeId": "ChIJ...", "dataId": "0x...:0x...", "url": "https://www.google.com/maps/place/?q=place_id:ChIJ...", "leadScore": 89, "contactCompletenessScore": 100, "scrapedAt": "2026-07-16T12:00:00+00:00" } ``` #### Example Review Record ```json { "recordType": "review", "reviewId": "review-id", "placeTitle": "Example Coffee Roasters", "placeId": "ChIJ...", "dataId": "0x...:0x...", "authorName": "Alex Morgan", "authorProfileUrl": "https://www.google.com/maps/contrib/...", "rating": 5, "publishedAt": "2 days ago", "text": "Friendly team, excellent coffee, and quick service.", "likesCount": 3, "responseFromOwnerText": "Thank you for visiting!", "images": ["https://lh3.googleusercontent.com/..."], "placeUrl": "https://www.google.com/maps/place/?q=place_id:ChIJ...", "scrapedAt": "2026-07-16T12:00:00+00:00" } ``` Only fields available for that specific place or review are returned. *** ### ๐Ÿ“Š Run Summary Every run writes a compact `OUTPUT` record to the default key-value store. Open **Output โ†’ Run summary** to see: - final status: `SUCCEEDED`, `PARTIAL`, or `INPUT_NEEDS_ATTENTION`; - saved place, review, and diagnostic row counts; - processed searches and direct inputs; - duplicates and filtered places; - contact and review coverage; - run duration and places per minute; - applied filters and dataset URL; - clear hints when input needs attention. ```json { "status": "SUCCEEDED", "mode": "FULL", "totalPlaces": 50, "uniquePlaceIds": 50, "reviewRows": 0, "diagnosticRows": 0, "datasetItems": 50, "durationSeconds": 42.8, "placesPerMinute": 70.1, "searchTermsProcessed": ["restaurant"], "searchLocationsProcessed": ["New York, USA"] } ``` *** ### ๐ŸŽฏ Lead Scores Explained `leadScore` helps rank commercially useful businesses. It considers signals such as website and phone availability, public contact data, social profiles, rating, review volume, opening status, and business description. `contactCompletenessScore` focuses on contact coverage: website, phone, email, additional phones, social profiles, and address. Scores are prioritization aids, not guarantees of lead quality. *** ### โš™๏ธ Performance and Cost Controls - `maxCrawledPlacesPerSearch` controls the number of places per keyword/location pair. - `maxContactPages` controls website enrichment depth. - `maxReviews` controls review volume per place. - `maxImages` controls stored image URLs per place. - `maxConcurrency` controls parallel work; the default is suitable for normal runs. - `scrapePlaceDetailPage`, `scrapeContacts`, and `scrapeReviews` let you enable only the data you need. For a quick discovery run, disable details, contacts, and reviews. For richer lead data, enable details and contacts. Review collection adds more output and should be limited deliberately. *** ### โœ… Recommended Testing Pattern 1. Start with one search term, one location, and 5โ€“10 places. 2. Check the **Overview** and **Lead generation** views. 3. Adjust category, rating, and website filters. 4. Enable contacts or reviews only when needed. 5. Increase the result limit after the sample matches your use case. *** ### โ“ FAQ #### Can I search multiple keywords and locations? Yes. Every keyword is paired with every location, and duplicate places are removed within the run. #### Can I scrape a business from a Google Maps URL? Yes. Use `startUrls`, or provide a `placeId` or `featureId`. #### Can I continue from a previous Apify dataset? Yes. Select it with `datasetId`. The Actor recognizes common Google Maps URL and identifier fields. #### Why is an email missing? Many businesses do not publish an email address. Contact enrichment returns only public information found on the business website. #### Why are some optional place fields missing? Field availability varies by business type, country, and Google Maps record. The Actor omits unavailable values rather than inserting `null`, `undefined`, or placeholder text. #### How do I collect exactly 10 reviews per place? Set `scrapeReviews` to `true` and `maxReviews` to `10`. Choose `PLACE_ITEMS` to keep them under each business or `REVIEW_ITEMS` for one dataset row per review. #### How do reviews stay linked to the correct place? Review rows include place identifiers and the source Maps URL, so they can be joined back to the business reliably. #### Why did a successful run return a diagnostic row? The Actor keeps recoverable input and source problems visible instead of failing silently. Open **Diagnostics** and **Run summary** for the reason and suggested next action. #### Which mode should I use for the fastest search? Use `SEARCH` with `scrapePlaceDetailPage`, `scrapeContacts`, and `scrapeReviews` disabled. *** ### ๐Ÿ’ผ Common Use Cases - local business lead generation; - CRM and sales-list enrichment; - local SEO and category research; - competitor and market mapping; - reputation and review analysis; - franchise and branch discovery; - businesses-without-websites prospecting; - hospitality, healthcare, home-services, and retail research. *** ### ๐Ÿท๏ธ Keywords `google maps scraper` ยท `google maps leads` ยท `business contacts` ยท `email finder` ยท `local lead generation` ยท `place scraper` ยท `google reviews` ยท `business directory` ยท `crm enrichment` ยท `local SEO` # Actor input Schema ## `searchStringsArray` (type: `array`): What to search for on Google Maps. Add one or many terms such as restaurants, dentists, plumbers, coffee shops. ## `locationQueries` (type: `array`): Cities, countries, neighborhoods, ZIP codes, or any location text Google Maps understands. Each search term is combined with each location. ## `maxCrawledPlacesPerSearch` (type: `integer`): Maximum places to save for each search term and location combination. ## `language` (type: `string`): Language used for Google Maps results and place details. ## `mode` (type: `string`): Choose the main workflow. Full places is the best default for most users. ## `locationQuery` (type: `string`): Hidden compatibility field for older tasks that used one location string. ## `scrapeContacts` (type: `boolean`): Visit business websites and extract public emails, phone numbers, and social profiles when available. ## `maxContactPages` (type: `integer`): Homepage plus likely contact/about/team/legal pages to inspect for each business website. ## `scrapeReviews` (type: `boolean`): Fetch Google Maps review payloads when available. ## `maxReviews` (type: `integer`): Maximum reviews to fetch for each place when review scraping is enabled. ## `reviewsSort` (type: `string`): Order used for the Google review endpoint. ## `outputMode` (type: `string`): Keep reviews nested under each place, or output one dataset item per review. ## `categoryFilterWords` (type: `array`): Keep only places whose categories contain at least one of these words. ## `placeMinimumStars` (type: `number`): Skip places below this rating when a rating is available. ## `website` (type: `string`): Filter businesses by website presence. ## `skipClosedPlaces` (type: `boolean`): Skip permanently closed places when Google exposes that status. ## `startUrls` (type: `array`): Direct Google Maps place/search URLs. Use this when you already have Maps links. ## `placeIds` (type: `array`): Google Place IDs such as ChIJvSQIgqFZwokRFYQbJdzceSs. ## `featureIds` (type: `array`): Google Maps data IDs in the form 0x...:0x.... ## `datasetId` (type: `string`): Optional dataset containing googleMapsUrl, placeId, cid, dataId, or featureId fields. ## `scrapePlaceDetailPage` (type: `boolean`): Fetch each place detail endpoint for richer fields such as business description, posts, attributes, and links. ## `maxImages` (type: `integer`): Maximum image URLs to keep per place. ## `rawOutput` (type: `boolean`): Attach raw Google Maps nested arrays for debugging or custom parsing. ## `countryCode` (type: `string`): Google results country code, e.g. US, GB, DE, FR. ## `maxConcurrency` (type: `integer`): How many place/detail/contact requests to run in parallel. ## `maxRetries` (type: `integer`): Retry budget for HTTP 429/5xx and parse failures. ## `maxProxyRetries` (type: `integer`): Dedicated retry budget for proxy / transport failures. ## `proxy` (type: `object`): Optional connection settings for larger or repeated Google Maps runs. ## Actor input object example ```json { "searchStringsArray": [ "restaurant" ], "locationQueries": [ "New York, USA" ], "maxCrawledPlacesPerSearch": 10, "language": "en", "mode": "FULL", "locationQuery": "", "scrapeContacts": true, "maxContactPages": 1, "scrapeReviews": false, "maxReviews": 0, "reviewsSort": "relevant", "outputMode": "PLACE_ITEMS", "categoryFilterWords": [], "placeMinimumStars": 0, "website": "allPlaces", "skipClosedPlaces": false, "startUrls": [], "placeIds": [], "featureIds": [], "scrapePlaceDetailPage": true, "maxImages": 5, "rawOutput": false, "countryCode": "US", "maxConcurrency": 2, "maxRetries": 3, "maxProxyRetries": 3, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): Default dataset with place, lead, review, photo, and diagnostic views. ## `runSummary` (type: `string`): Status, counts, diagnostics, filters, and output links for this run. # 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 = { "searchStringsArray": [ "restaurant" ], "locationQueries": [ "New York, USA" ], "maxCrawledPlacesPerSearch": 10, "language": "en", "mode": "FULL", "scrapeContacts": true, "maxContactPages": 1, "scrapeReviews": false, "maxReviews": 0, "outputMode": "PLACE_ITEMS", "scrapePlaceDetailPage": true, "maxImages": 5, "rawOutput": false, "countryCode": "US", "maxConcurrency": 2, "maxRetries": 3, "maxProxyRetries": 3, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("shadowextractor/google-maps-business-intelligence").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 = { "searchStringsArray": ["restaurant"], "locationQueries": ["New York, USA"], "maxCrawledPlacesPerSearch": 10, "language": "en", "mode": "FULL", "scrapeContacts": True, "maxContactPages": 1, "scrapeReviews": False, "maxReviews": 0, "outputMode": "PLACE_ITEMS", "scrapePlaceDetailPage": True, "maxImages": 5, "rawOutput": False, "countryCode": "US", "maxConcurrency": 2, "maxRetries": 3, "maxProxyRetries": 3, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("shadowextractor/google-maps-business-intelligence").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 '{ "searchStringsArray": [ "restaurant" ], "locationQueries": [ "New York, USA" ], "maxCrawledPlacesPerSearch": 10, "language": "en", "mode": "FULL", "scrapeContacts": true, "maxContactPages": 1, "scrapeReviews": false, "maxReviews": 0, "outputMode": "PLACE_ITEMS", "scrapePlaceDetailPage": true, "maxImages": 5, "rawOutput": false, "countryCode": "US", "maxConcurrency": 2, "maxRetries": 3, "maxProxyRetries": 3, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call shadowextractor/google-maps-business-intelligence --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shadowextractor/google-maps-business-intelligence", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Scraper: Leads, Reviews & Business Data", "description": "Scrape Google Maps places by keyword, location, URL, or Place ID. Extract business contacts, emails, phones, websites, ratings, review text, photos, opening hours, coordinates, and lead-quality signals.", "version": "0.1", "x-build-id": "DPKmOwL07VT0j9g0k" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shadowextractor~google-maps-business-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shadowextractor-google-maps-business-intelligence", "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/shadowextractor~google-maps-business-intelligence/runs": { "post": { "operationId": "runs-sync-shadowextractor-google-maps-business-intelligence", "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/shadowextractor~google-maps-business-intelligence/run-sync": { "post": { "operationId": "run-sync-shadowextractor-google-maps-business-intelligence", "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": { "searchStringsArray": { "title": "๐Ÿ” Search term(s)", "type": "array", "description": "What to search for on Google Maps. Add one or many terms such as restaurants, dentists, plumbers, coffee shops.", "items": { "type": "string" }, "default": [] }, "locationQueries": { "title": "๐Ÿ“ Location(s)", "type": "array", "description": "Cities, countries, neighborhoods, ZIP codes, or any location text Google Maps understands. Each search term is combined with each location.", "items": { "type": "string" }, "default": [] }, "maxCrawledPlacesPerSearch": { "title": "๐Ÿ’ฏ Number of places to extract", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum places to save for each search term and location combination.", "default": 10 }, "language": { "title": "๐ŸŒ Language", "type": "string", "description": "Language used for Google Maps results and place details.", "default": "en" }, "mode": { "title": "๐Ÿงญ What to scrape", "enum": [ "FULL", "SEARCH", "DETAIL", "REVIEWS", "CONTACTS" ], "type": "string", "description": "Choose the main workflow. Full places is the best default for most users.", "default": "FULL" }, "locationQuery": { "title": "Legacy location", "type": "string", "description": "Hidden compatibility field for older tasks that used one location string.", "default": "" }, "scrapeContacts": { "title": "๐Ÿ“‡ Extract website contacts", "type": "boolean", "description": "Visit business websites and extract public emails, phone numbers, and social profiles when available.", "default": true }, "maxContactPages": { "title": "Website pages per business", "minimum": 1, "maximum": 20, "type": "integer", "description": "Homepage plus likely contact/about/team/legal pages to inspect for each business website.", "default": 1 }, "scrapeReviews": { "title": "โญ Scrape reviews", "type": "boolean", "description": "Fetch Google Maps review payloads when available.", "default": false }, "maxReviews": { "title": "Reviews per place", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum reviews to fetch for each place when review scraping is enabled.", "default": 0 }, "reviewsSort": { "title": "Reviews sort", "enum": [ "relevant", "newest", "highest", "lowest" ], "type": "string", "description": "Order used for the Google review endpoint.", "default": "relevant" }, "outputMode": { "title": "Review output style", "enum": [ "PLACE_ITEMS", "REVIEW_ITEMS" ], "type": "string", "description": "Keep reviews nested under each place, or output one dataset item per review.", "default": "PLACE_ITEMS" }, "categoryFilterWords": { "title": "Category must contain", "type": "array", "description": "Keep only places whose categories contain at least one of these words.", "items": { "type": "string" }, "default": [] }, "placeMinimumStars": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Skip places below this rating when a rating is available.", "default": 0 }, "website": { "title": "Website filter", "enum": [ "allPlaces", "withWebsite", "withoutWebsite" ], "type": "string", "description": "Filter businesses by website presence.", "default": "allPlaces" }, "skipClosedPlaces": { "title": "โญ๏ธ Skip closed places", "type": "boolean", "description": "Skip permanently closed places when Google exposes that status.", "default": false }, "startUrls": { "title": "๐Ÿ”— Google Maps URLs", "type": "array", "description": "Direct Google Maps place/search URLs. Use this when you already have Maps links.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "placeIds": { "title": "Place IDs", "type": "array", "description": "Google Place IDs such as ChIJvSQIgqFZwokRFYQbJdzceSs.", "items": { "type": "string" }, "default": [] }, "featureIds": { "title": "Data IDs / feature IDs", "type": "array", "description": "Google Maps data IDs in the form 0x...:0x....", "items": { "type": "string" }, "default": [] }, "datasetId": { "title": "Input dataset", "type": "string", "description": "Optional dataset containing googleMapsUrl, placeId, cid, dataId, or featureId fields." }, "scrapePlaceDetailPage": { "title": "๐Ÿงฉ Scrape detail page", "type": "boolean", "description": "Fetch each place detail endpoint for richer fields such as business description, posts, attributes, and links.", "default": true }, "maxImages": { "title": "Max images", "minimum": 0, "maximum": 200, "type": "integer", "description": "Maximum image URLs to keep per place.", "default": 5 }, "rawOutput": { "title": "Include raw Google arrays", "type": "boolean", "description": "Attach raw Google Maps nested arrays for debugging or custom parsing.", "default": false }, "countryCode": { "title": "๐ŸŒ Country code", "type": "string", "description": "Google results country code, e.g. US, GB, DE, FR.", "default": "US" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many place/detail/contact requests to run in parallel.", "default": 2 }, "maxRetries": { "title": "Max retries", "minimum": 0, "maximum": 20, "type": "integer", "description": "Retry budget for HTTP 429/5xx and parse failures.", "default": 3 }, "maxProxyRetries": { "title": "Max proxy retries", "minimum": 1, "maximum": 20, "type": "integer", "description": "Dedicated retry budget for proxy / transport failures.", "default": 3 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Optional connection settings for larger or repeated Google Maps runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```