# Local Lead Qualifier (`simmonssolutions/local-lead-qualifier`) Actor Turn raw Google Maps scrapes into a qualified outreach list. Cuts franchises, lead-gen shells, and dead listings; flags businesses that market services with no visible way to book (the outreach wedge). - **URL**: https://apify.com/simmonssolutions/local-lead-qualifier.md - **Developed by:** [Logan Simmons](https://apify.com/simmonssolutions) (community) - **Categories:** Lead generation, Business, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## Local Lead Qualifier **Scrapers find businesses. This tells you which ones are worth contacting.** Feed it the output of any Google Maps scraper and get back a scored list: - **QUALIFIED** — real, established, owner-reachable businesses - **CUT** — with the reason: franchise/chain, keyword-stuffed lead-gen shell, too new, too big, aggregator-only web presence, missing data - **WEDGE flag** — businesses that market their services but have **no visible booking or capture path** on their website. They are paying for interest they cannot capture — the strongest cold-outreach opener there is. ### Why qualify? Raw Maps scrapes are ~50-80% noise: franchises whose marketing is corporate-owned, SEO shell listings that are not real businesses, and shops too new or too big to buy from you. Sending to noise burns your sender reputation and your time. This actor applies the filters a good SDR would apply by hand, in seconds. ### Input ```json { "leads": [ { "name": "Example Restoration Co", "rating": 4.8, "reviews": 132, "website": "https://example.com", "phone": "+1 555 0100", "email": "owner@example.com" } ], "minRating": "3.7", "maxRating": "4.8", "minReviews": 20, "maxReviews": 200, "scanWebsites": true } ```` Works with the JSON/CSV output of any Maps scraper (Outscraper, Apify Google Maps actors, etc.). Extra fields are ignored safely. ### The default gates (and why) - **Rating 3.7–4.8** — below = struggling; a perfect 5.0 usually means too new or gamed - **Reviews 20–200** — below = unproven; above = you'll reach staff layers, not the owner - **Chain/franchise cut** — corporate owns their marketing; there is no owner to sell - **Shell cut** — keyword-stuffed name + thin reviews + weak site = lead-gen front, not a business - **Wedge scan** — homepage fetched and checked for booking/quote/capture paths Built by [Simmons Solutions](https://simmonssolutionsco.com) — AI systems that get service businesses more customers. # Actor input Schema ## `leads` (type: `array`): Array of scraped businesses. Each item should have: name, rating, reviews, website, phone, email (extra fields are passed through untouched). Paste the JSON output of any Google Maps scraper. ## `minRating` (type: `string`): Below this = struggling business, harder sell. Default 3.7. ## `maxRating` (type: `string`): A perfect 5.0 with few reviews is usually too new or gamed. Default 4.8. ## `minReviews` (type: `integer`): Below this the business is too new/unproven. Default 20. ## `maxReviews` (type: `integer`): Above this you usually hit staff layers and agencies instead of the owner. Default 200. ## `scanWebsites` (type: `boolean`): Fetch each surviving lead's homepage and check for booking/quote/capture paths. Businesses with none get the WEDGE flag - they are paying for interest they cannot capture. ## Actor input object example ```json { "leads": [ { "name": "Example Restoration Co", "rating": 4.8, "reviews": 132, "website": "https://example.com", "phone": "+1 555 0100", "email": "owner@example.com" } ], "minRating": "3.7", "maxRating": "4.8", "minReviews": 20, "maxReviews": 200, "scanWebsites": true } ``` # 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 = { "leads": [ { "name": "Example Restoration Co", "rating": 4.8, "reviews": 132, "website": "https://example.com", "phone": "+1 555 0100", "email": "owner@example.com" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("simmonssolutions/local-lead-qualifier").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 = { "leads": [{ "name": "Example Restoration Co", "rating": 4.8, "reviews": 132, "website": "https://example.com", "phone": "+1 555 0100", "email": "owner@example.com", }] } # Run the Actor and wait for it to finish run = client.actor("simmonssolutions/local-lead-qualifier").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 '{ "leads": [ { "name": "Example Restoration Co", "rating": 4.8, "reviews": 132, "website": "https://example.com", "phone": "+1 555 0100", "email": "owner@example.com" } ] }' | apify call simmonssolutions/local-lead-qualifier --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=simmonssolutions/local-lead-qualifier", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Local Lead Qualifier", "description": "Turn raw Google Maps scrapes into a qualified outreach list. Cuts franchises, lead-gen shells, and dead listings; flags businesses that market services with no visible way to book (the outreach wedge).", "version": "0.1", "x-build-id": "FQQ8dOqgWKNHSu7ql" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simmonssolutions~local-lead-qualifier/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simmonssolutions-local-lead-qualifier", "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/simmonssolutions~local-lead-qualifier/runs": { "post": { "operationId": "runs-sync-simmonssolutions-local-lead-qualifier", "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/simmonssolutions~local-lead-qualifier/run-sync": { "post": { "operationId": "run-sync-simmonssolutions-local-lead-qualifier", "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": [ "leads" ], "properties": { "leads": { "title": "Leads", "type": "array", "description": "Array of scraped businesses. Each item should have: name, rating, reviews, website, phone, email (extra fields are passed through untouched). Paste the JSON output of any Google Maps scraper." }, "minRating": { "title": "Minimum rating", "type": "string", "description": "Below this = struggling business, harder sell. Default 3.7.", "default": "3.7" }, "maxRating": { "title": "Maximum rating", "type": "string", "description": "A perfect 5.0 with few reviews is usually too new or gamed. Default 4.8.", "default": "4.8" }, "minReviews": { "title": "Minimum reviews", "type": "integer", "description": "Below this the business is too new/unproven. Default 20.", "default": 20 }, "maxReviews": { "title": "Maximum reviews", "type": "integer", "description": "Above this you usually hit staff layers and agencies instead of the owner. Default 200.", "default": 200 }, "scanWebsites": { "title": "Scan websites for the capture gap", "type": "boolean", "description": "Fetch each surviving lead's homepage and check for booking/quote/capture paths. Businesses with none get the WEDGE flag - they are paying for interest they cannot capture.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```