# Home Service Business Lead Scraper (`digitalnomadph/home-service-business-lead-scraper`) Actor Scrape publicly available home service business leads from Houzz, Yellow Pages Directory, and BuildZoom. - **URL**: https://apify.com/digitalnomadph/home-service-business-lead-scraper.md - **Developed by:** [DigitalNomadPH](https://apify.com/digitalnomadph) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.20 / 1,000 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.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 ## Home Service Business Lead Scraper Collect verified contact data — phone numbers, addresses, websites, ratings, and service details — for home service contractors across the United States. The actor simultaneously scrapes **Houzz**, **Yellow Pages Directory**, and **BuildZoom**, deduplicates records across sources, and scores each lead by data completeness. Use it to build targeted outreach lists for plumbers, electricians, HVAC companies, roofers, landscapers, and more — no code required. ### Features - Scrapes four validated public directories: Houzz, Yellow Pages / YP, Yellow Pages Directory, and BuildZoom - Supports 8 home service trade categories - Deduplicates records across sources by phone, domain, name + location - Quality scoring: each lead receives a 0–100 quality score and a `high` / `medium` / `low` band - Configurable result cap (1–1,000 records) with per-source distribution logic - Optional email extraction (only from explicitly labeled email fields) - Optional website extraction - Apify Proxy support for reliable access - Debug mode for diagnosing source-level parsing issues ### Why use Home Service Business Lead Scraper? This actor is useful for anyone who needs a list of local home service contractors: - **Sales teams** prospecting HVAC, roofing, or plumbing companies for B2B outreach - **Marketing agencies** building contact lists for local service verticals - **Local SEO tools** seeding contractor data for a new market - **Aggregator platforms** bootstrapping a contractor directory without a manual data entry effort - **Researchers** studying the density and distribution of trade contractors by metro area ### How much will it cost? This actor uses Cheerio (fast HTTP scraping) for Yellow Pages Directory and BuildZoom, and Playwright (headless browser) for Houzz. Playwright runs cost more than plain HTTP requests. | Run size | Approx. compute units | Approx. cost (pay-as-you-go) | |-------------|----------------------|-------------------------------| | 30 results | 0.05–0.20 CU | ~$0.01–$0.04 | | 100 results | 0.20–0.60 CU | ~$0.04–$0.12 | | 500 results | 0.80–2.50 CU | ~$0.16–$0.50 | Proxy usage (Apify Proxy residential) adds approximately $0.40/GB. Typical runs consume under 20 MB per 100 results. Costs vary based on selected sources and proxy tier. ### How to use 1. Go to the [Apify Store](https://apify.com/store) page for this actor and click **Try for free**. 2. In the **Input** tab, select a **Category** (e.g., Plumber) and enter a **Location** (e.g., `Chicago, IL`). 3. Adjust **Maximum results** and select which **Sources** to scrape. 4. Click **Start** to run the actor. 5. When the run completes, open the **Storage** tab to download your leads as JSON, CSV, or Excel. You can also run this actor via the [Apify API](https://docs.apify.com/api/v2) or schedule it to run on a recurring basis from the **Schedules** tab. ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------------------|---------|----------|------------------------------------------------------|-------------| | `category` | string | Yes | `plumber` | Trade category to search. One of: `plumber`, `electrician`, `hvac`, `roofer`, `landscaper`, `cleaning_service`, `handyman`, `general_contractor` | | `location` | string | Yes | `Austin, TX` | US city or metro area. Example: `Denver, CO` or `Portland, OR` | | `maxResults` | integer | No | `30` | Maximum unique records to save (1–1,000). Distributed evenly across sources. | | `sources` | array | No | `["houzz", "yp", "yellow_pages_directory", "build_zoom"]` | Directories to scrape. Select one or more. | | `includeEmails` | boolean | No | `false` | Extract emails from explicitly labeled email fields on directory pages. | | `includeWebsite` | boolean | No | `true` | Extract business website URLs. | | `deduplicate` | boolean | No | `true` | Merge duplicate businesses found across sources. | | `debugMode` | boolean | No | `false` | Log detailed source and parsing diagnostics to the run log. | | `proxyConfiguration` | object | No | `{ "useApifyProxy": true }` | Apify Proxy settings. Recommended to keep enabled for reliable scraping. | #### Example input ```json { "category": "plumber", "location": "Austin, TX", "maxResults": 30, "includeEmails": false, "includeWebsite": true, "deduplicate": true, "sources": ["houzz", "yp", "yellow_pages_directory", "build_zoom"], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ```` ### Output Each saved dataset item follows this schema: ```json { "businessName": "ABC Plumbing LLC", "sector": "home_services", "category": "plumber", "trade": "plumber", "phone": "+15125551212", "email": null, "website": "https://example.com", "profileUrl": "https://www.buildzoom.com/contractor/abc-plumbing-llc", "address": "123 Main St", "city": "Austin", "region": "TX", "postalCode": "78701", "country": "US", "rating": 4.7, "reviewCount": 128, "description": "Local plumbing company serving Austin and surrounding areas.", "services": ["Drain cleaning", "Water heater repair"], "serviceArea": ["Austin", "Round Rock"], "licenseNumber": null, "yearsInBusiness": null, "emergencyService": true, "source": "build_zoom", "sourceName": "BuildZoom", "sourcesSeen": ["build_zoom", "houzz"], "profileUrlsSeen": [ "https://www.buildzoom.com/contractor/abc-plumbing-llc", "https://www.houzz.com/professionals/abc-plumbing" ], "scrapedAt": "2026-06-15T00:00:00.000Z", "qualityScore": 87, "qualityBand": "high" } ``` **Field notes:** - `qualityScore` — 0–100 based on data completeness (phone, address, website, email, rating, description). - `qualityBand` — `high` (≥80), `medium` (≥50), or `low` (<50). - `sourcesSeen` — all source IDs where this business was found (populated after deduplication). - `profileUrlsSeen` — all directory profile URLs found for this business. - `emergencyService` — `true` if the description mentions 24/7 or emergency service; `null` if unknown. ### Supported Sources | Source ID | Display Name | Crawler type | |-------------------------|-----------------------|--------------| | `houzz` | Houzz | Playwright | | `yp` | Yellow Pages / YP | Playwright | | `yellow_pages_directory`| Yellow Pages Directory| Cheerio | | `build_zoom` | BuildZoom | Cheerio | Houzz and Yellow Pages / YP use a headless browser (Playwright) due to JavaScript rendering and bot protection. Yellow Pages Directory and BuildZoom are scraped via fast HTTP requests (Cheerio). ### Supported Categories | Input value | Description | |----------------------|---------------------------| | `plumber` | Plumbers | | `electrician` | Electricians | | `hvac` | HVAC companies | | `roofer` | Roofers | | `landscaper` | Landscapers | | `cleaning_service` | Cleaning services | | `handyman` | Handyman services | | `general_contractor` | General contractors | Category aliases are accepted (e.g. `"plumbing contractor"` normalizes to `"plumber"`). ### Tips - **Per-source cap:** When multiple sources are selected, the actor applies a per-source limit of `ceil(maxResults / numberOfSources)` to prevent a single fast source from filling the entire result quota before slower sources contribute. - **Proxy:** Residential proxy is recommended (and set by default). Yellow Pages / YP and Houzz block datacenter IPs on the Apify platform. Yellow Pages Directory and BuildZoom work with datacenter proxy if you want to lower costs. - **Yellow Pages / YP reliability:** YP actively rotates bot defenses (403, rate limits, empty pages). Expect 24–28 records on a 30-result run — when YP is blocked, the other three sources still deliver results cleanly. This is a target-site limitation, not an actor bug. - **Location format:** Use `City, ST` format (e.g. `Austin, TX`, `Miami, FL`). Multi-word cities work fine: `San Antonio, TX`. - **Email extraction:** Enable `includeEmails` only when you specifically need email addresses. Emails are only extracted from labeled email fields on profile pages — not guessed from description text. - **Deduplication:** When `deduplicate` is `true`, records found across multiple sources are merged and the `sourcesSeen` array reflects all sources where the business was found. ### Limitations - US locations only (MVP scope). - Public pages only — no login support. - No CAPTCHA solving. - No deep website crawling. - No email verification. - No CRM integrations. - Source selectors may require maintenance when directory layouts change. ### Responsible Use This actor extracts publicly available business information from supported directory pages. Users are responsible for ensuring that their use of the scraped data complies with applicable laws, platform terms of service, privacy regulations (including CAN-SPAM, GDPR where applicable), and marketing rules. The actor must not be used to collect private, login-gated, sensitive, or restricted information. ### Local Development ```bash npm install npx playwright install chromium # required for Houzz (Playwright source) npm test npm run build npm start ``` Local runs use Apify local storage under `storage/`. Set `APIFY_HEADLESS=1` to run Playwright in headless mode locally. ### Support Found a bug or want to request a new source or category? Open an issue on the actor's GitHub repository or contact the author through Apify. # Actor input Schema ## `category` (type: `string`): Home service category to scrape. ## `location` (type: `string`): City, metro, or region to search, for example Austin, TX. ## `maxResults` (type: `integer`): Maximum number of unique records to save. ## `includeEmails` (type: `boolean`): Extract only emails visibly present on supported public directory pages. ## `includeWebsite` (type: `boolean`): Extract business website links when visible. ## `deduplicate` (type: `boolean`): Merge duplicate records across selected sources. ## `sources` (type: `array`): Public directories to scrape. Houzz and Yellow Pages / YP use a headless browser; Yellow Pages Directory and BuildZoom use fast HTTP requests. ## `debugMode` (type: `boolean`): Log extra source and parsing diagnostics. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Residential proxy is recommended for reliable access to all sources. ## Actor input object example ```json { "category": "plumber", "location": "Austin, TX", "maxResults": 30, "includeEmails": false, "includeWebsite": true, "deduplicate": true, "sources": [ "houzz", "yp", "yellow_pages_directory", "build_zoom" ], "debugMode": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `results` (type: `string`): Dataset items containing normalized home service business leads. ## `runSummary` (type: `string`): Summary of requested sources, successful sources, failed sources, saved records, and source-level counts. # 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 = { "category": "plumber", "location": "Austin, TX" }; // Run the Actor and wait for it to finish const run = await client.actor("digitalnomadph/home-service-business-lead-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 = { "category": "plumber", "location": "Austin, TX", } # Run the Actor and wait for it to finish run = client.actor("digitalnomadph/home-service-business-lead-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 '{ "category": "plumber", "location": "Austin, TX" }' | apify call digitalnomadph/home-service-business-lead-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=digitalnomadph/home-service-business-lead-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Home Service Business Lead Scraper", "description": "Scrape publicly available home service business leads from Houzz, Yellow Pages Directory, and BuildZoom.", "version": "0.1", "x-build-id": "zWjLnnLXhuJFz8Nvc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/digitalnomadph~home-service-business-lead-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-digitalnomadph-home-service-business-lead-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/digitalnomadph~home-service-business-lead-scraper/runs": { "post": { "operationId": "runs-sync-digitalnomadph-home-service-business-lead-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/digitalnomadph~home-service-business-lead-scraper/run-sync": { "post": { "operationId": "run-sync-digitalnomadph-home-service-business-lead-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", "required": [ "category", "location" ], "properties": { "category": { "title": "Category", "enum": [ "plumber", "electrician", "hvac", "roofer", "landscaper", "cleaning_service", "handyman", "general_contractor" ], "type": "string", "description": "Home service category to scrape." }, "location": { "title": "Location", "minLength": 1, "type": "string", "description": "City, metro, or region to search, for example Austin, TX." }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of unique records to save.", "default": 30 }, "includeEmails": { "title": "Include emails", "type": "boolean", "description": "Extract only emails visibly present on supported public directory pages.", "default": false }, "includeWebsite": { "title": "Include websites", "type": "boolean", "description": "Extract business website links when visible.", "default": true }, "deduplicate": { "title": "Deduplicate", "type": "boolean", "description": "Merge duplicate records across selected sources.", "default": true }, "sources": { "title": "Sources", "type": "array", "description": "Public directories to scrape. Houzz and Yellow Pages / YP use a headless browser; Yellow Pages Directory and BuildZoom use fast HTTP requests.", "items": { "type": "string", "enum": [ "houzz", "yp", "yellow_pages_directory", "build_zoom" ], "enumTitles": [ "Houzz", "Yellow Pages / YP", "Yellow Pages Directory", "BuildZoom" ] }, "default": [ "houzz", "yp", "yellow_pages_directory", "build_zoom" ] }, "debugMode": { "title": "Debug mode", "type": "boolean", "description": "Log extra source and parsing diagnostics.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Residential proxy is recommended for reliable access to all sources.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```