# Google Maps Lead Generator (`netdesignr/google-maps-lead-generator`) Actor Find local business leads from Google Maps, filter for real SMEs with websites, and output NetPulse-ready records for outreach, audits, and AI workflows. - **URL**: https://apify.com/netdesignr/google-maps-lead-generator.md - **Developed by:** [Netdesignr](https://apify.com/netdesignr) (community) - **Categories:** Lead generation, Automation, SEO tools - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $3.00 / 1,000 lead records This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Lead Generator Generate Google Maps business leads that are easier to use in outbound, enrichment, and website-audit pipelines. This actor is built for two audiences: - teams that want a practical Google Maps lead source for agencies, sales ops, growth, and local-market research - AI agents and internal tools that need clear inputs, stable outputs, and lead records that are easy to parse downstream It searches Google Maps by niche and location, extracts local business listings, applies quality filters, optionally pre-checks websites, and emits lead records designed to be usable in NetPulse-style diagnosis and enrichment workflows. ### What this actor is good at - finding local businesses by service plus geography - filtering for leads that actually have usable websites - removing obvious duplicates and common chain businesses - screening out weak leads before they hit a more expensive pipeline - producing outputs that humans can export and AI agents can consume with minimal cleanup ### What data can I extract with Google Maps Lead Generator? | Business identity | Local context | Website and qualification signals | | --- | --- | --- | | Business name, category, industry, phone, and website | Address, area, postcode, city, country, plus code, coordinates, and Google Maps URL | Rating, review count, opening status, opening hours, and temporary-closure hints | | Google place hint data when visible in the Maps URL | Query and rank within the collected result set | Website pre-check result with redirect, SSL, response timing, and failure warnings | | Stable `recordType` and `outputFormat` fields for downstream parsing | `scrapedAt` timestamp for pipeline traceability | Optional website enrichment with emails, phones, social links, and conservative decision-maker hints | The actor also emits one `run-summary` record for the whole run with query counts, lead counts, and failure counts. ### What You Can Do With It - build local-business lead lists for agencies and outbound teams - source SMEs with websites for NetPulse-style website audits - create prospect batches by niche, town, county, or metro area - filter out chain businesses and obvious low-signal listings - pre-check websites before sending them into a diagnosis or crawl pipeline - feed the output into CRMs, spreadsheets, Airtable, or AI agent workflows ### Common Use Cases #### 1. Agency prospecting for local niches Search for businesses like: - `dentists in surrey` - `accountants kingston upon thames` - `removals companies london` Use the actor to build a shortlist of local businesses with: - a live website - a minimum review threshold - a reasonable Google rating - enough structure for email or website-based follow-up Typical output to use: - default dataset `google-maps-lead` records - `run-summary` record for batch reporting #### 2. NetPulse website-audit intake Use `requireWebsite = true` and `websitePreCheck = true` when you want to: - skip phone-only businesses - avoid Facebook-only “websites” - avoid parked or placeholder domains - save scan budget for real business websites Typical output to use: - `website` - `websitePreCheck` - `verifiedWebsiteDomain` - `query`, `category`, `reviewCount`, and `rating` #### 3. Local market mapping Use the actor to answer questions like: - who shows up for this service in this area? - which businesses have strong review signals? - how dense is the market in a specific postcode or town? Typical output to use: - `category` - `address`, `area`, `city`, `postcode` - `rating` - `reviewCount` - `googleMapsUrl` #### 4. AI-agent lead sourcing This actor works well for AI agents that need: - one input object with explicit filters - one dataset with consistent record types - lightweight fields that are easy to rank, filter, or summarize - pre-qualified websites before launching a heavier audit or enrichment step Recommended agent flow: 1. Run the actor with `searchQueries`, `minReviews`, `minRating`, `requireWebsite`, and `websitePreCheck`. 2. Read the default dataset and keep only `recordType = "google-maps-lead"`. 3. Rank by niche, review count, rating, and website status. 4. Send the surviving `website` URLs into the next pipeline step. ### Quick “Can I Use This For…” Guide You can use this actor if you want to: - find local service businesses from Google Maps - build a website-first SME lead list - screen leads before running a more expensive audit - feed structured local-business records into an agent or CRM - export a clean shortlist for spreadsheets or sales ops This actor is probably not the right fit if you need: - a full Google Places API replacement - guaranteed place IDs for every result - deep review-text extraction from Google reviews - consumer-facing marketplace scraping outside local lead generation ### How to use Google Maps Lead Generator #### Step 1: Add your search queries In **Search Queries**, add one query per line. Each query should combine: - a business type - a location Good examples: - `dentists in Surrey` - `removals companies London` - `accountants Kingston upon Thames` - `family lawyers Manchester` - `roofers leeds` #### Step 2: Decide how many results you want Use **Max Results Per Query** to control run size. - smaller values are faster and safer for quick prospecting runs - larger values are better for market mapping or list building #### Step 2b: Tighten locality when Google drifts Use **Strict Location** when you want results to stay anchored to a specific place such as `Chessington`. Use **Location Radius (km)** when you want a hard geographic cutoff around that location. Example: - `strictLocation = "Chessington"` - `locationRadiusKm = 5` This is useful when Google Maps returns nearby towns that are relevant to the search term but outside your real catchment. #### Step 3: Set lead quality filters Use these together to improve downstream lead quality: - **Minimum Google Reviews** - **Minimum Google Rating** - **Require Website URL** - **Skip Known Chains/Franchises** These filters help reduce: - inactive listings - low-signal businesses - large brands that are not your target ICP - listings that have no website to audit or enrich #### Step 4: Enable website validation when needed Use **Run Website Pre-Check** when you want to avoid spending time on bad websites. The pre-check helps surface: - HTTP status - final redirect target - SSL presence - response timing - Facebook-only redirects - parked or placeholder domains #### Step 5: Run and export Start the actor and read: - `google-maps-lead` records for the actual lead rows - the final `run-summary` record for run health and counts You can export results as JSON, CSV, Excel, XML, HTML, or RSS from Apify, or fetch them via API. ### Input parameters | Parameter | Type | Required | Default | Description | | --- | --- | :---: | --- | --- | | `searchQueries` | array | Yes | - | Google Maps search queries, each usually combining niche + location | | `maxResultsPerQuery` | integer | No | `50` | Maximum businesses to collect per query | | `countryFilter` | string | No | `GB` | Two-letter country filter used for Google Maps localization | | `language` | string | No | `en` | Google Maps interface language | | `strictLocation` | string | No | `null` | Optional locality name used to keep results tied to a specific place | | `locationRadiusKm` | integer | No | `null` | Optional radius around `strictLocation` for tighter geographic filtering | | `minReviews` | integer | No | `5` | Skip businesses below this review threshold | | `minRating` | number | No | `0` | Skip businesses below this rating threshold | | `requireWebsite` | boolean | No | `true` | Skip listings with no website | | `skipChains` | boolean | No | `true` | Filter out obvious chain or franchise businesses | | `excludePlaceIds` | array | No | `[]` | Exclude already-known place IDs when available | | `websitePreCheck` | boolean | No | `true` | Run lightweight website validation before emitting the lead | | `skipFacebookOnly` | boolean | No | `true` | Skip websites that resolve to Facebook pages | | `skipParkedDomains` | boolean | No | `true` | Skip parked or placeholder domains | | `requestDelayMs` | integer | No | `3000` | Delay between page loads to reduce block risk | | `maxRetries` | integer | No | `2` | Retries per failed query or navigation flow | | `webhookUrl` | string | No | `null` | Optional completion webhook for downstream automation | | `outputFormat` | string | No | `netpulse-ready` | `netpulse-ready`, `raw`, or `csv-friendly` | ### Example input ```json { "searchQueries": [ "removals companies London", "dentists Surrey", "accountants Kingston upon Thames" ], "maxResultsPerQuery": 40, "countryFilter": "GB", "language": "en", "strictLocation": "Chessington", "locationRadiusKm": 5, "minReviews": 8, "minRating": 4.0, "requireWebsite": true, "skipChains": true, "websitePreCheck": true, "skipFacebookOnly": true, "skipParkedDomains": true, "requestDelayMs": 3000, "maxRetries": 2, "outputFormat": "netpulse-ready" } ```` ### Output records #### `google-maps-lead` Each lead record can include: - `outputFormat` - `query` - `rank` - `businessName` - `category` - `industry` - `address` - `area` - `postcode` - `city` - `countryCode` - `latitude` / `longitude` - `plusCode` - `placeId` - `googleMapsUrl` - `website` - `phone` - `rating` - `reviewCount` - `openingStatus` - `openingHours` - `verifiedWebsiteDomain` - `websitePreCheck` - `enrichment` - `warnings` #### `run-summary` One final summary record with: - `queriesRequested` - `queriesCompleted` - `totalLeads` - `enrichedLeads` - `failedQueries` - `failedListings` - `countryCode` - `outputFormat` - `finishedAt` ### Example output ```json { "recordType": "google-maps-lead", "outputFormat": "netpulse-ready", "query": "dentists Surrey", "rank": 3, "businessName": "Surrey Dental Studio", "category": "Dentist", "industry": "Dentist", "address": "21 High Street, Guildford GU1 3AA, United Kingdom", "area": "21 High Street, Guildford GU1 3AA", "postcode": "GU1 3AA", "city": "Guildford", "countryCode": "gb", "googleMapsUrl": "https://www.google.com/maps/place/...", "website": "https://surreydentalstudio.co.uk", "phone": "+44 1483 123456", "rating": 4.7, "reviewCount": 42, "openingStatus": "Open", "temporarilyClosed": false, "verifiedWebsiteDomain": "surreydentalstudio.co.uk", "websitePreCheck": { "status": "passed", "httpStatus": 200, "finalUrl": "https://surreydentalstudio.co.uk/", "sslEnabled": true, "responseTimeMs": 642, "redirectedToFacebook": false, "parkedDomain": false, "warnings": [] }, "enrichment": { "status": "not_requested", "emails": [], "phones": [], "decisionMakerHints": [], "warnings": [] }, "warnings": [], "scrapedAt": "2026-04-06T17:00:00.000Z" } ``` ### What makes it easy to integrate - simple input structure for both humans and agents - one main dataset with explicit `recordType` - one run-level summary record for health checks - optional website screening before downstream processing - output fields that work well for CRM import, spreadsheets, or agent ranking ### API usage #### JavaScript ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('netdesignr/google-maps-lead-generator').call({ searchQueries: [ 'removals companies London', 'dentists Surrey' ], maxResultsPerQuery: 25, countryFilter: 'GB', minReviews: 8, requireWebsite: true, websitePreCheck: true, outputFormat: 'netpulse-ready' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` #### Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ["APIFY_TOKEN"]) run = client.actor("netdesignr/google-maps-lead-generator").call(run_input={ "searchQueries": ["accountants Kingston upon Thames"], "maxResultsPerQuery": 20, "countryFilter": "GB", "requireWebsite": True, "websitePreCheck": True, "outputFormat": "netpulse-ready", }) items = client.dataset(run["defaultDatasetId"]).list_items().items print(items) ``` #### cURL ```bash curl -X POST "https://api.apify.com/v2/acts/netdesignr~google-maps-lead-generator/runs?token=$APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "searchQueries": ["dentists Surrey", "removals companies London"], "maxResultsPerQuery": 30, "countryFilter": "GB", "requireWebsite": true, "websitePreCheck": true, "outputFormat": "netpulse-ready" }' ``` ### Limitations - Google Maps layout changes can break selectors over time. - Some searches can trigger consent walls, throttling, or anti-bot interstitials. - Place IDs are best-effort because Google Maps does not expose them consistently in every page state. - Chain detection is heuristic, not perfect. - Website pre-checks are intentionally lightweight and are not a substitute for a full crawl or audit. - Decision-maker hints, when enabled, are inferred from public website text and should not be treated as verified identity data. ### Good defaults for AI agents If an AI agent needs a safe starting configuration, use: - `maxResultsPerQuery: 20` - `countryFilter: "GB"` - `minReviews: 5` - `minRating: 0` - `requireWebsite: true` - `skipChains: true` - `websitePreCheck: true` - `skipFacebookOnly: true` - `skipParkedDomains: true` - `requestDelayMs: 3000` - `maxRetries: 2` - `outputFormat: "netpulse-ready"` This gives a reasonable balance between speed, lead quality, and downstream usefulness. ### Local validation ```bash pnpm --filter @apify-actors/shared build pnpm --filter google-maps-lead-generator build pnpm --filter google-maps-lead-generator test pnpm --filter google-maps-lead-generator run type-check ``` # Actor input Schema ## `searchQueries` (type: `array`): List of Google Maps search queries. Each query should combine a business type with a location. Examples: 'dentists in Surrey', 'removals companies London', 'accountants Kingston upon Thames'. ## `maxResultsPerQuery` (type: `integer`): Maximum number of businesses to scrape per search query. Google Maps typically returns up to 120 results per search. Lower values run faster. ## `countryFilter` (type: `string`): Only return businesses in this country. Use ISO 3166-1 alpha-2 codes. ## `language` (type: `string`): Language for Google Maps interface. Affects result ordering and localisation. ## `strictLocation` (type: `string`): Optional locality filter applied after scraping. Use this when you want results to stay anchored to a specific place like 'Chessington' or 'Kingston upon Thames' even if Google Maps drifts to nearby areas. ## `locationRadiusKm` (type: `integer`): Optional radius around Strict Location. If provided, only businesses within this radius are kept when coordinates are available. ## `minReviews` (type: `integer`): Skip businesses with fewer reviews than this. Filters out inactive or very new businesses. Set to 0 to include all. ## `minRating` (type: `number`): Skip businesses rated below this threshold. Set to 0 to include all. ## `requireWebsite` (type: `boolean`): Skip businesses that have no website listed on Google Maps. Essential for NetPulse pipeline. Only disable if you want phone-only leads. ## `skipChains` (type: `boolean`): Attempt to filter out large chain businesses (e.g. Specsavers, Costa, McDonald's). Uses a built-in chain detection list. Not 100% accurate but removes obvious non-SME results. ## `excludePlaceIds` (type: `array`): List of Google Place IDs to skip. Use this to avoid re-scraping businesses already in your lead database. Pass from your CRM or Airtable export. ## `websitePreCheck` (type: `boolean`): Perform a quick HTTP HEAD request on each business website before outputting. Captures: HTTP status, SSL present, response time, redirect target. Filters out dead sites, parked domains, and Facebook-only pages. Adds ~1 second per result but saves NetPulse scan capacity. ## `skipFacebookOnly` (type: `boolean`): If the listed website redirects to facebook.com, skip this business. These leads have no real website to diagnose. ## `skipParkedDomains` (type: `boolean`): If the website returns a known parking page or site builder placeholder, skip this business. ## `requestDelayMs` (type: `integer`): Milliseconds to wait between Google Maps page loads. Higher values are safer but slower. Recommended: 2000-4000. ## `maxRetries` (type: `integer`): Number of times to retry a failed search query before skipping it. ## `webhookUrl` (type: `string`): Optional webhook URL to call when the run completes. Use this to trigger your NetPulse batch scan automatically. The webhook receives the dataset ID and run metadata. ## `outputFormat` (type: `string`): Choose how results are structured in the dataset. ## Actor input object example ```json { "searchQueries": [ "removals companies London", "dentists Surrey", "accountants Kingston upon Thames" ], "maxResultsPerQuery": 50, "countryFilter": "GB", "language": "en", "strictLocation": "", "minReviews": 5, "minRating": 0, "requireWebsite": true, "skipChains": true, "excludePlaceIds": [], "websitePreCheck": true, "skipFacebookOnly": true, "skipParkedDomains": true, "requestDelayMs": 3000, "maxRetries": 2, "outputFormat": "netpulse-ready" } ``` # Actor output Schema ## `overview` (type: `string`): No description ## `detailed` (type: `string`): No description ## `decisionMakers` (type: `string`): No description ## `runSummary` (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 = { "searchQueries": [ "removals companies London", "dentists Surrey", "accountants Kingston upon Thames" ] }; // Run the Actor and wait for it to finish const run = await client.actor("netdesignr/google-maps-lead-generator").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchQueries": [ "removals companies London", "dentists Surrey", "accountants Kingston upon Thames", ] } # Run the Actor and wait for it to finish run = client.actor("netdesignr/google-maps-lead-generator").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "removals companies London", "dentists Surrey", "accountants Kingston upon Thames" ] }' | apify call netdesignr/google-maps-lead-generator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=netdesignr/google-maps-lead-generator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Google Maps Lead Generator", "description": "Find local business leads from Google Maps, filter for real SMEs with websites, and output NetPulse-ready records for outreach, audits, and AI workflows.", "version": "0.1", "x-build-id": "egGKxGfCPVTTF6wY3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/netdesignr~google-maps-lead-generator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-netdesignr-google-maps-lead-generator", "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/netdesignr~google-maps-lead-generator/runs": { "post": { "operationId": "runs-sync-netdesignr-google-maps-lead-generator", "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/netdesignr~google-maps-lead-generator/run-sync": { "post": { "operationId": "run-sync-netdesignr-google-maps-lead-generator", "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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search Queries", "minItems": 1, "type": "array", "description": "List of Google Maps search queries. Each query should combine a business type with a location. Examples: 'dentists in Surrey', 'removals companies London', 'accountants Kingston upon Thames'.", "items": { "type": "string" } }, "maxResultsPerQuery": { "title": "Max Results Per Query", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of businesses to scrape per search query. Google Maps typically returns up to 120 results per search. Lower values run faster.", "default": 50 }, "countryFilter": { "title": "Country Filter", "enum": [ "GB", "US", "AE", "DE", "FR", "ES", "IT", "NL", "AU", "CA" ], "type": "string", "description": "Only return businesses in this country. Use ISO 3166-1 alpha-2 codes.", "default": "GB" }, "language": { "title": "Language", "type": "string", "description": "Language for Google Maps interface. Affects result ordering and localisation.", "default": "en" }, "strictLocation": { "title": "Strict Location", "type": "string", "description": "Optional locality filter applied after scraping. Use this when you want results to stay anchored to a specific place like 'Chessington' or 'Kingston upon Thames' even if Google Maps drifts to nearby areas.", "default": "" }, "locationRadiusKm": { "title": "Location Radius (km)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Optional radius around Strict Location. If provided, only businesses within this radius are kept when coordinates are available." }, "minReviews": { "title": "Minimum Google Reviews", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Skip businesses with fewer reviews than this. Filters out inactive or very new businesses. Set to 0 to include all.", "default": 5 }, "minRating": { "title": "Minimum Google Rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Skip businesses rated below this threshold. Set to 0 to include all.", "default": 0 }, "requireWebsite": { "title": "Require Website URL", "type": "boolean", "description": "Skip businesses that have no website listed on Google Maps. Essential for NetPulse pipeline. Only disable if you want phone-only leads.", "default": true }, "skipChains": { "title": "Skip Known Chains/Franchises", "type": "boolean", "description": "Attempt to filter out large chain businesses (e.g. Specsavers, Costa, McDonald's). Uses a built-in chain detection list. Not 100% accurate but removes obvious non-SME results.", "default": true }, "excludePlaceIds": { "title": "Exclude Place IDs", "type": "array", "description": "List of Google Place IDs to skip. Use this to avoid re-scraping businesses already in your lead database. Pass from your CRM or Airtable export.", "items": { "type": "string" }, "default": [] }, "websitePreCheck": { "title": "Run Website Pre-Check", "type": "boolean", "description": "Perform a quick HTTP HEAD request on each business website before outputting. Captures: HTTP status, SSL present, response time, redirect target. Filters out dead sites, parked domains, and Facebook-only pages. Adds ~1 second per result but saves NetPulse scan capacity.", "default": true }, "skipFacebookOnly": { "title": "Skip Facebook-Only Websites", "type": "boolean", "description": "If the listed website redirects to facebook.com, skip this business. These leads have no real website to diagnose.", "default": true }, "skipParkedDomains": { "title": "Skip Parked/Placeholder Domains", "type": "boolean", "description": "If the website returns a known parking page or site builder placeholder, skip this business.", "default": true }, "requestDelayMs": { "title": "Delay Between Requests (ms)", "minimum": 1000, "maximum": 10000, "type": "integer", "description": "Milliseconds to wait between Google Maps page loads. Higher values are safer but slower. Recommended: 2000-4000.", "default": 3000 }, "maxRetries": { "title": "Max Retries Per Query", "minimum": 0, "maximum": 5, "type": "integer", "description": "Number of times to retry a failed search query before skipping it.", "default": 2 }, "webhookUrl": { "title": "Webhook URL (on completion)", "type": "string", "description": "Optional webhook URL to call when the run completes. Use this to trigger your NetPulse batch scan automatically. The webhook receives the dataset ID and run metadata." }, "outputFormat": { "title": "Output Format", "enum": [ "netpulse-ready", "raw", "csv-friendly" ], "type": "string", "description": "Choose how results are structured in the dataset.", "default": "netpulse-ready" } } }, "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 } } } } } } } } } } ```