# Google Maps Scraper (`intergration/google-maps-scraper`) Actor Scrapes Google Maps places — business data, reviews, images, contacts. Pay-per-event pricing. - **URL**: https://apify.com/intergration/google-maps-scraper.md - **Developed by:** [Ian Emmanuel](https://apify.com/intergration) (community) - **Categories:** Integrations, Automation, AI - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $3.20 / 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. 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 Extract business data, reviews, contacts, and images from Google Maps — with pay-per-event pricing and support for 20 languages. --- ### What This Actor Does The Google Maps Scraper searches Google Maps for businesses, landmarks, and services in any location worldwide. It returns structured place records and supports optional add-ons for reviews, images, contact details, and enriched business data. Results are returned in your chosen language — independent of the scraping location or proxy IP. --- ### Output Fields Each place record includes the following fields: | Field | Description | |---|---| | `title` | Business name | | `address` | Full formatted address | | `phone` | Phone number (E.164 formatted) | | `website` | Website URL (tracking params stripped) | | `category` | Google Maps category label | | `totalScore` | Star rating (1.0 – 5.0) | | `reviewsCount` | Total number of reviews | | `lat` / `lng` | GPS coordinates (7 decimal places) | | `openingHours` | Opening hours by day | | `priceBracket` | Price level ($ to $$$$) | | `placeId` | Unique Google Maps Place ID | | `isExternalServicePlace` | `true` for booking-provider injected results | | `reviews[]` | Array of review objects *(when enabled)* | | `images[]` | Array of image objects *(when enabled)* | | `emails[]` | Extracted email addresses *(when enabled)* | | `socialUrls[]` | Social media profile URLs *(when enabled)* | | `scrapedAt` | ISO 8601 timestamp of extraction | --- ### Pricing This actor uses a **pay-per-event** model. You are charged only for events that actually fire during your run — no subscriptions, no idle fees, no minimum commitments. | Event | Rate | Billing Unit | When It Fires | |---|---|---|---| | Actor start | $0.0056 | Per run | Every run — infrastructure flat fee | | Place scraped | $0.0032 | Per place | Every successfully returned place | | Filter applied | $0.0008 | Per filter × place | When any filter is active (category, rating, website, keyword) | | Additional place details | $0.0016 | Per place | When enriched details are enabled | | Contact details scraped | $0.0016 | Per place w/ website | Only places with a website | | Review scraped | $0.0004 | Per review | Each individual review extracted | | Image scraped | $0.0004 | Per image | Each image including metadata | #### Worked Examples | Job Type | Configuration | Formula | Cost | |---|---|---|---| | Plain directory | 3,500 places, no add-ons | 3,500 × $0.0032 + $0.0056 | **$11.21** | | Filtered search | 1,200 places, 3 filters | 1,200 × $0.0032 + 1,200 × 3 × $0.0008 + $0.0056 | **$6.73** | | Contact leads | 2,000 places, 1,400 with websites | 2,000 × $0.0032 + 1,400 × $0.0016 + $0.0056 | **$8.65** | | Review extraction | 500 places, 60 reviews/place cap | 500 × $0.0032 + 30,000 × $0.0004 + $0.0056 | **$13.61** | | Full enrichment | 400 places, 2 filters, 350 websites, 25 reviews, 8 images | 400×$0.0032 + 800×$0.0008 + 400×$0.0016 + 350×$0.0016 + 10,000×$0.0004 + 3,200×$0.0004 + $0.0056 | **$8.41** | | Direct ID lookup | 5,000 Place IDs | 5,000 × $0.0032 + 5,000 × $0.0016 + $0.0056 | **$24.01** | > 💡 Multiple categories under the category filter = 1 filter event — no extra charge for category breadth. > 💡 Direct Place ID/URL input always triggers Additional place details ($0.0016/place) — minimum base rate is $0.0048/place. > ⚠️ Set `reviewsPerPlaceLimit` and `imagesPerPlaceLimit` before every run — these are the highest-scaling line items. --- ### Input Fields #### Search | Field | Type | Default / Required | Description | |---|---|---|---| | `searchTerms` | array | **Required** (or `directPlaceIds`) | Keywords to search Google Maps (e.g. `"restaurant"`, `"pharmacy"`). Each term triggers a full map-scroll pass. | | `directPlaceIds` | array | Optional | List of Place IDs or Google Maps URLs. Skips the search step and extracts specific places directly. | #### Location | Field | Type | Default / Required | Description | |---|---|---|---| | `location` | string | Recommended | City, region, or country name. Resolved via OpenStreetMap. | | `country` | string | Optional | ISO 3166-1 alpha-2 country code (e.g. `"KE"`, `"NG"`, `"ZA"`). | | `state` | string | Optional | State or province name. | | `city` | string | Optional | City name. | | `postalCode` | string | Optional | Postal or ZIP code. | | `customGeolocation` | object | Optional | GeoJSON Polygon, MultiPolygon, or Point with `radiusKm`. Subdivides the area into tiles and bypasses the 120-place limit. | #### Run Control | Field | Type | Default | Description | |---|---|---|---| | `maxCrawledPlaces` | integer | 100 | Hard cap on total places returned. Set before every run to control cost. | | `language` | string | English | Result language — 20 supported including Mandarin Chinese, Arabic, Hindi, and Swahili. | #### Filters | Field | Type | Default | Description | |---|---|---|---| | `categories` | array | Optional | Only keep places matching these category labels. | | `minimumStarRating` | number | Optional | Exclude places below this rating (1.0 – 5.0). | | `requiresWebsite` | boolean | false | Only return places with a website URL. Recommended when contact scraping is enabled. | | `titleKeyword` | string | Optional | Only return places whose name contains this string (case-insensitive). | #### Add-ons | Field | Type | Default | Description | |---|---|---|---| | `scrapeAdditionalDetails` | boolean | false | Extract enriched fields: reservations, web results, Q&A, menu URLs, booking links. | | `scrapeContacts` | boolean | false | Visit each business website to extract emails and social media URLs. Charged $0.0016/place with a website. | | `enrichSocialMedia` | boolean | false | Categorise discovered social URLs by platform. **Requires** `scrapeContacts`. | | `scrapeBusinessLeads` | boolean | false | Pull LinkedIn profiles for key personnel. Part of Additional place details — $0.0016/place. | #### Reviews | Field | Type | Default | Description | |---|---|---|---| | `scrapeReviews` | boolean | false | Extract individual reviews per place. | | `reviewsPerPlaceLimit` | integer | 50 | Cap on reviews per place. Set conservatively — 200 reviews × 5,000 places = $400 in review charges alone. | | `scrapeReviewerData` | boolean | false | Include reviewer name, ID, photo, `isLocalGuide` flag. Separate toggle — enabling reviews does not automatically enable this. | #### Images | Field | Type | Default | Description | |---|---|---|---| | `scrapeImages` | boolean | false | Extract gallery images and metadata per place. | | `imagesPerPlaceLimit` | integer | 10 | Cap on images per place. 50 images × 10,000 places = $200 in image charges alone. | #### Other | Field | Type | Default | Description | |---|---|---|---| | `estimatedPlaces` | integer | Optional | Enter your expected place count to log a pre-run cost estimate before scraping begins. | | `proxyConfiguration` | object | Optional | Apify proxy settings. Residential proxy recommended for production runs. | | `debugMode` | boolean | false | Enable verbose logging — XHR hits, selector misses, filter rejection reasons. | --- ### Important Notes #### ⚠️ 120-place limit without geolocation Without a `location`, `country`, `city`, or `customGeolocation`, Google Maps renders a single screen and returns at most ~120 results. Provide any geolocation field to get full coverage. The `customGeolocation` field (GeoJSON polygon) subdivides the area into tiles and bypasses this limit entirely. #### ⚠️ GeoJSON coordinate order GeoJSON (RFC 7946) uses `[longitude, latitude]` order — the **opposite** of Google Maps display order. Pasting coordinates from Google Maps directly will scrape the wrong area with no error. Use [geojson.io](https://geojson.io) to build and visually verify your polygon before running. #### ⚠️ Direct Place ID billing Inputting Place IDs or Google Maps URLs directly skips the search step and goes straight to detail extraction. This automatically triggers the Additional place details add-on ($0.0016/place) on every place — the minimum base rate for direct-ID runs is **$0.0048/place**. #### ⚠️ Social enrichment dependency `enrichSocialMedia` requires `scrapeContacts` to also be enabled. Without contact scraping, there are no discovered social URLs to enrich and the feature produces no output. #### ⚠️ Overlapping search terms Each search term triggers a full independent map-scroll pass. Near-duplicate terms like `"restaurant"` and `"restaurants"` re-scrape the same places, inflating run time and cost. Use distinct, non-overlapping terms only, and use category filters to narrow results instead. #### ℹ️ External service places Hotel and accommodation searches may include places sourced from booking providers. These are flagged with `isExternalServicePlace: true` and may have incomplete fields (`phone`, `address`, and `hours` may be `null`). Filter them post-run using this field. #### ℹ️ Review data and privacy Reviewer personal data (name, ID, photo, `isLocalGuide`) is disabled by default for privacy compliance. Only enable `scrapeReviewerData` when you have a documented lawful basis. #### ℹ️ 5,000-review dataset limit Places with more than 5,000 reviews are split into multiple dataset items sharing the same place fields. Use the Reviews export view (append `&view=reviews` to the dataset API URL) to get one flat row per review. --- ### Getting Started Example The following example runs a full-enrichment scrape of cafes in Nairobi with all major add-ons enabled. It is designed to test every billing event type with a minimal place count to keep cost predictable. ```json { "searchTerms": ["cafe"], "location": "Nairobi, Kenya", "country": "KE", "city": "Nairobi", "maxCrawledPlaces": 5, "language": "English", "categories": ["Cafe", "Coffee shop", "Espresso bar", "Bakery"], "minimumStarRating": 1.0, "requiresWebsite": false, "scrapeAdditionalDetails": true, "scrapeContacts": true, "enrichSocialMedia": true, "scrapeReviews": true, "reviewsPerPlaceLimit": 3, "scrapeReviewerData": true, "scrapeImages": true, "imagesPerPlaceLimit": 3, "estimatedPlaces": 5, "debugMode": false } ```` **Expected cost:** ~$0.08 – $0.12 depending on how many places have websites. #### Each place record will include: | Field Group | Fields | |---|---| | Core | `title`, `address`, `phone`, `website`, `category`, `totalScore`, `reviewsCount`, `lat`, `lng`, `openingHours`, `priceBracket`, `placeId`, `scrapedAt` | | Additional details | `reservationUrl`, `orderUrl`, `menuUrl`, `qaItems[]`, `webResults[]` | | Contacts | `emails[]`, `socialUrls[]`, `socialProfiles{}`, `phonesFromSite[]` | | Reviews | `reviewId`, `text`, `stars`, `publishedDate`, `ownerResponse`, `reviewerName`*, `reviewerUrl`*, `isLocalGuide`\* | | Images | `url`, `authorName`, `uploadDate` | *\*Only included when `scrapeReviewerData` is enabled.* *** *Built with Node.js 18+ · Crawlee · Playwright · Apify SDK* # Actor input Schema ## `searchTerms` (type: `array`): Keywords to search on Google Maps (e.g. 'restaurant', 'pharmacy'). Use distinct, non-overlapping terms. Each term triggers a full map-scroll pass — duplicate or adjacent terms inflate run time and cost without adding unique places. ## `location` (type: `string`): City, region, or country name. Resolved via OpenStreetMap Nominatim. Omitting this field AND all geolocation parameters caps output at 120 places. ## `country` (type: `string`): ISO 3166-1 alpha-2 country code for precise resolution (e.g. 'KE', 'NG', 'ZA'). ## `state` (type: `string`): State or province name for more precise location resolution (e.g. 'Nairobi County', 'Lagos State'). ## `city` (type: `string`): City name for precise location resolution (e.g. Nairobi, Lagos, Cape Town). ## `postalCode` (type: `string`): Postal or ZIP code for precise location resolution. ## `customGeolocation` (type: `object`): GeoJSON Polygon, MultiPolygon, or Point with radiusKm. IMPORTANT: coordinates must be in \[longitude, latitude] order per RFC 7946 — the opposite of Google Maps display order. Use geojson.io to build and visually verify before pasting. ## `directPlaceIds` (type: `array`): Skip search — extract specific known places directly. WARNING: Direct Place ID/URL input automatically triggers the 'Additional place details' add-on ($0.0016/place) on top of the standard place-scraped rate. Minimum cost per place is $0.0048. ## `maxCrawledPlaces` (type: `integer`): Hard cap on total places returned. Set this to control cost on large runs. ## `language` (type: `string`): Language for Google Maps results and UI. Overrides region-based language detection — results will be returned in this language regardless of the scraping location or proxy IP. Affects place names, categories, reviews, and all text fields in the output. ## `categories` (type: `array`): Only keep places matching these Google Maps category labels. Include ALL synonyms — 'Divorce attorney' and 'Divorce lawyer' are different category IDs. Missing a synonym silently excludes all places under that label. Multiple categories count as 1 filter event. ## `minimumStarRating` (type: `number`): Exclude places below this rating (1.0–5.0). Each active filter adds $0.0008 per place. ## `requiresWebsite` (type: `boolean`): Only return places that have a website URL. Recommended when contact details are enabled — prevents spending place-scraping budget on listings that cannot return contact data. ## `titleKeyword` (type: `string`): Only return places whose name contains this string (case-insensitive partial match). Adds $0.0008 per place. ## `scrapeAdditionalDetails` (type: `boolean`): Extract enriched fields: table reservations, web results, Q\&A. Flat $0.0016/place regardless of how many detail types are enabled. Always enable all types you need — selecting fewer does not reduce cost. ## `scrapeContacts` (type: `boolean`): Visit each business website to extract email addresses and social media profile URLs. Charged $0.0016 per place that has a website. Enable the 'Has website' filter to avoid spending place budget on listings with no website. ## `scrapeReviews` (type: `boolean`): Extract individual reviews (text, rating, date, owner response). Charged $0.0004 per review. Set reviewsPerPlaceLimit to control cost. ## `reviewsPerPlaceLimit` (type: `integer`): Maximum reviews to extract per place. Set this before every review run — without a cap, places with thousands of reviews can drive significant cost. A cap of 200 reviews on 5,000 places = $400 in review charges. ## `scrapeReviewerData` (type: `boolean`): Include reviewer name, ID, URL, photo, isLocalGuide flag, and review count. Disabled by default for privacy compliance. Only enable when you have a documented lawful basis. Requires 'Reviews' to also be enabled. ## `scrapeImages` (type: `boolean`): Extract images and metadata (author, upload date) from each place listing. Charged $0.0004 per image. Set imagesPerPlaceLimit to control cost. ## `imagesPerPlaceLimit` (type: `integer`): Maximum images to extract per place. Set conservatively — 50 images × 10,000 places = $200 in image charges. ## `enrichSocialMedia` (type: `boolean`): Retrieve follower counts, descriptions, and verification status for discovered social profiles. REQUIRES 'Contact details' to also be enabled — social enrichment has no URLs to process if contacts are not scraped first. ## `scrapeBusinessLeads` (type: `boolean`): Pull LinkedIn profiles for identified personnel. Part of the Additional place details add-on — $0.0016/place (mandatory) plus $0.0016/place for contacts. ## `proxyConfiguration` (type: `object`): Apify proxy settings. Residential proxies are strongly recommended for production runs. ## `debugMode` (type: `boolean`): Enable verbose logging including selector miss events and raw XHR body samples. ## `estimatedPlaces` (type: `integer`): Optional. Enter your expected place count to see a cost estimate in the billing summary before the run starts. Does not affect scraping — purely informational. Leave blank to skip pre-run estimate. ## Actor input object example ```json { "searchTerms": [ "restaurant", "bar", "cafe" ], "location": "Nairobi, Kenya", "maxCrawledPlaces": 100, "language": "English", "categories": [ "Divorce lawyer", "Divorce attorney", "Family law attorney" ], "requiresWebsite": false, "scrapeAdditionalDetails": false, "scrapeContacts": false, "scrapeReviews": false, "reviewsPerPlaceLimit": 50, "scrapeReviewerData": false, "scrapeImages": false, "imagesPerPlaceLimit": 10, "enrichSocialMedia": false, "scrapeBusinessLeads": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "debugMode": false } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("intergration/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 = {} # Run the Actor and wait for it to finish run = client.actor("intergration/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 '{}' | apify call intergration/google-maps-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=intergration/google-maps-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Scraper", "description": "Scrapes Google Maps places — business data, reviews, images, contacts. Pay-per-event pricing.", "version": "1.0", "x-build-id": "K6TGsG8syPK4MKbtg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/intergration~google-maps-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-intergration-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/intergration~google-maps-scraper/runs": { "post": { "operationId": "runs-sync-intergration-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/intergration~google-maps-scraper/run-sync": { "post": { "operationId": "run-sync-intergration-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to search on Google Maps (e.g. 'restaurant', 'pharmacy'). Use distinct, non-overlapping terms. Each term triggers a full map-scroll pass — duplicate or adjacent terms inflate run time and cost without adding unique places.", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, region, or country name. Resolved via OpenStreetMap Nominatim. Omitting this field AND all geolocation parameters caps output at 120 places." }, "country": { "title": "Country code", "type": "string", "description": "ISO 3166-1 alpha-2 country code for precise resolution (e.g. 'KE', 'NG', 'ZA')." }, "state": { "title": "State / province", "type": "string", "description": "State or province name for more precise location resolution (e.g. 'Nairobi County', 'Lagos State')." }, "city": { "title": "City", "type": "string", "description": "City name for precise location resolution (e.g. Nairobi, Lagos, Cape Town)." }, "postalCode": { "title": "Postal code", "type": "string", "description": "Postal or ZIP code for precise location resolution." }, "customGeolocation": { "title": "Custom search area (GeoJSON)", "type": "object", "description": "GeoJSON Polygon, MultiPolygon, or Point with radiusKm. IMPORTANT: coordinates must be in [longitude, latitude] order per RFC 7946 — the opposite of Google Maps display order. Use geojson.io to build and visually verify before pasting." }, "directPlaceIds": { "title": "Direct Place IDs or Google Maps URLs", "type": "array", "description": "Skip search — extract specific known places directly. WARNING: Direct Place ID/URL input automatically triggers the 'Additional place details' add-on ($0.0016/place) on top of the standard place-scraped rate. Minimum cost per place is $0.0048.", "items": { "type": "string" } }, "maxCrawledPlaces": { "title": "Max places to scrape", "minimum": 1, "type": "integer", "description": "Hard cap on total places returned. Set this to control cost on large runs.", "default": 100 }, "language": { "title": "Language", "enum": [ "English", "Mandarin Chinese", "Spanish", "Arabic", "Hindi", "Portuguese", "Indonesian", "French", "Japanese", "Russian", "German", "Korean", "Turkish", "Vietnamese", "Thai", "Italian", "Polish", "Dutch", "Persian", "Swahili" ], "type": "string", "description": "Language for Google Maps results and UI. Overrides region-based language detection — results will be returned in this language regardless of the scraping location or proxy IP. Affects place names, categories, reviews, and all text fields in the output.", "default": "English" }, "categories": { "title": "Category filter", "type": "array", "description": "Only keep places matching these Google Maps category labels. Include ALL synonyms — 'Divorce attorney' and 'Divorce lawyer' are different category IDs. Missing a synonym silently excludes all places under that label. Multiple categories count as 1 filter event.", "items": { "type": "string" } }, "minimumStarRating": { "title": "Minimum star rating", "minimum": 1, "maximum": 5, "type": "number", "description": "Exclude places below this rating (1.0–5.0). Each active filter adds $0.0008 per place." }, "requiresWebsite": { "title": "Has website (filter)", "type": "boolean", "description": "Only return places that have a website URL. Recommended when contact details are enabled — prevents spending place-scraping budget on listings that cannot return contact data.", "default": false }, "titleKeyword": { "title": "Title keyword filter", "type": "string", "description": "Only return places whose name contains this string (case-insensitive partial match). Adds $0.0008 per place." }, "scrapeAdditionalDetails": { "title": "Additional place details", "type": "boolean", "description": "Extract enriched fields: table reservations, web results, Q&A. Flat $0.0016/place regardless of how many detail types are enabled. Always enable all types you need — selecting fewer does not reduce cost.", "default": false }, "scrapeContacts": { "title": "Contact details", "type": "boolean", "description": "Visit each business website to extract email addresses and social media profile URLs. Charged $0.0016 per place that has a website. Enable the 'Has website' filter to avoid spending place budget on listings with no website.", "default": false }, "scrapeReviews": { "title": "Reviews", "type": "boolean", "description": "Extract individual reviews (text, rating, date, owner response). Charged $0.0004 per review. Set reviewsPerPlaceLimit to control cost.", "default": false }, "reviewsPerPlaceLimit": { "title": "Reviews per place (cap)", "minimum": 1, "type": "integer", "description": "Maximum reviews to extract per place. Set this before every review run — without a cap, places with thousands of reviews can drive significant cost. A cap of 200 reviews on 5,000 places = $400 in review charges.", "default": 50 }, "scrapeReviewerData": { "title": "Reviewer personal data", "type": "boolean", "description": "Include reviewer name, ID, URL, photo, isLocalGuide flag, and review count. Disabled by default for privacy compliance. Only enable when you have a documented lawful basis. Requires 'Reviews' to also be enabled.", "default": false }, "scrapeImages": { "title": "Images", "type": "boolean", "description": "Extract images and metadata (author, upload date) from each place listing. Charged $0.0004 per image. Set imagesPerPlaceLimit to control cost.", "default": false }, "imagesPerPlaceLimit": { "title": "Images per place (cap)", "minimum": 1, "type": "integer", "description": "Maximum images to extract per place. Set conservatively — 50 images × 10,000 places = $200 in image charges.", "default": 10 }, "enrichSocialMedia": { "title": "Social media profile enrichment", "type": "boolean", "description": "Retrieve follower counts, descriptions, and verification status for discovered social profiles. REQUIRES 'Contact details' to also be enabled — social enrichment has no URLs to process if contacts are not scraped first.", "default": false }, "scrapeBusinessLeads": { "title": "Business leads enrichment (LinkedIn)", "type": "boolean", "description": "Pull LinkedIn profiles for identified personnel. Part of the Additional place details add-on — $0.0016/place (mandatory) plus $0.0016/place for contacts.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings. Residential proxies are strongly recommended for production runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Enable verbose logging including selector miss events and raw XHR body samples.", "default": false }, "estimatedPlaces": { "title": "Estimated places (for pre-run cost estimate)", "minimum": 1, "type": "integer", "description": "Optional. Enter your expected place count to see a cost estimate in the billing summary before the run starts. Does not affect scraping — purely informational. Leave blank to skip pre-run estimate." } } }, "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 } } } } } } } } } } ```