# ๐Ÿ”ง USA Plumbers Scraper โ€” Leads with Phone, Address & Website (`muhammadafzal/usa-plumbers-scraper`) Actor Scrape USA plumbing businesses from Google Maps. Returns business name, phone, address, website, rating, reviews & hours. CRM-ready JSON. No login needed. - **URL**: https://apify.com/muhammadafzal/usa-plumbers-scraper.md - **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community) - **Categories:** Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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 ## ๐Ÿ”ง USA Plumbers Scraper โ€” Extract Leads with Phone, Address & Website Scrape plumbing businesses across the United States from Google Maps and get structured, CRM-ready lead data instantly. No login required, no API keys needed. Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools. ### What data does it extract? | Field | Example | |---|---| | Business Name | Joe's Plumbing LLC | | Phone | +1-713-555-0192 | | Address | 4821 Westheimer Rd, Houston, TX 77056 | | City | Houston | | State | TX | | ZIP Code | 77056 | | Website | https://joesplumbing.com | | Rating | 4.7 | | Review Count | 183 | | Categories | Plumber, Water Heater Installation | | Business Hours | { monday: "8AMโ€“6PM", ... } | | Google Maps URL | Full link | | Plus Code | VXQG+74 Houston, TX | | Scraped At | 2026-04-08T12:00:00.000Z | ### Who is this for? - **Sales & marketing agencies** building local contractor outreach lists - **Franchise operators** researching the competitive plumbing landscape by city - **Lead generation companies** selling verified B2B plumbing contacts - **AI pipelines** that need structured local business data via MCP - **Real estate & home services platforms** enriching contractor directories ### How to use #### Option 1: Search by query (recommended) Set **Search Queries** to your desired locations: ```json { "searchQueries": [ "plumbers in Dallas TX", "emergency plumber Miami FL", "plumbers near Denver CO" ], "maxResults": 200 } ```` #### Option 2: Auto-expand by city list Provide a list of cities and the actor generates `"plumbers in [city]"` queries automatically: ```json { "cities": ["Atlanta GA", "Seattle WA", "Portland OR"], "maxResults": 300 } ``` #### Option 3: Direct Google Maps URLs Paste Google Maps search or business URLs directly: ```json { "startUrls": [ { "url": "https://www.google.com/maps/search/plumbers+in+Chicago" } ], "maxResults": 100 } ``` #### Option 4: Default run (no input required) Run with zero configuration โ€” the actor automatically searches the top 20 US cities for plumbing businesses and returns up to 100 results. ### Output format Each result is a flat JSON object: ```json { "businessName": "Joe's Plumbing LLC", "phone": "+1-713-555-0192", "address": "4821 Westheimer Rd, Houston, TX 77056", "city": "Houston", "state": "TX", "zipCode": "77056", "website": "https://joesplumbing.com", "rating": 4.7, "reviewCount": 183, "categories": ["Plumber", "Water Heater Installation"], "hours": { "monday": "8AMโ€“6PM", "tuesday": "8AMโ€“6PM", "saturday": "9AMโ€“3PM", "sunday": "Closed" }, "googleMapsUrl": "https://www.google.com/maps/place/...", "plusCode": "VXQG+74 Houston, TX", "source_url": "https://www.google.com/maps/search/plumbers+in+Houston+TX", "scraped_at": "2026-04-08T12:00:00.000Z" } ``` ### Pricing This actor uses **PAY\_PER\_EVENT** pricing at **$0.002 per result** โ€” you only pay for what you get. | Results | Cost | |---|---| | 100 | $0.20 | | 500 | $1.00 | | 2,000 | $4.00 | | 10,000 | $20.00 | ### Performance tips - Set `maxResultsPerQuery` to 20โ€“50 for fastest runs - Use `cities` array to cover multiple states systematically - For large-scale runs (5,000+), switch proxy config to **Residential** in settings - Schedule daily runs to keep your leads list fresh ### Technical notes - Scrapes Google Maps search results and individual business panels - Uses Playwright with stealth mode + session rotation to avoid rate limits - Datacenter proxies by default; residential proxy fallback supported - All redirected website URLs are decoded to real destinations ### Legal & ethical use This actor extracts publicly available data from Google Maps. Use in compliance with Google's Terms of Service and applicable data privacy laws (GDPR, CCPA). Do not use scraped data for spam or unsolicited outreach without user consent. *** Built by [USERNAME/usa-plumbers-scraper](https://apify.com/USERNAME/usa-plumbers-scraper) ยท [Report an issue](https://apify.com/USERNAME/usa-plumbers-scraper/issues) # Actor input Schema ## `searchQueries` (type: `array`): List of Google Maps search queries. E.g. 'plumbers in Houston TX', 'emergency plumber Los Angeles'. Leave empty to auto-search top 20 US cities. ## `cities` (type: `array`): Provide a list of US city names (e.g. 'Chicago IL') to auto-generate 'plumbers in \[city]' queries. Overrides searchQueries if both are set. ## `startUrls` (type: `array`): Paste direct Google Maps business or search URLs to scrape specific listings. ## `maxResults` (type: `integer`): Maximum number of plumber records to return across all queries. ## `maxResultsPerQuery` (type: `integer`): How many results to extract per search query (Google Maps shows ~20 per scroll). ## `language` (type: `string`): Language code for Google Maps results (e.g. 'en' for English). ## `proxyConfig` (type: `object`): Apify proxy settings. Datacenter proxies are used by default. Switch to residential if blocked. ## Actor input object example ```json { "searchQueries": [ "plumbers in Houston TX", "plumbers in Phoenix AZ" ], "cities": [ "Chicago IL", "Dallas TX", "Miami FL" ], "maxResults": 100, "maxResultsPerQuery": 20, "language": "en" } ``` # 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": [ "plumbers in Houston TX", "plumbers in Phoenix AZ" ], "cities": [ "Chicago IL", "Dallas TX", "Miami FL" ] }; // Run the Actor and wait for it to finish const run = await client.actor("muhammadafzal/usa-plumbers-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 = { "searchQueries": [ "plumbers in Houston TX", "plumbers in Phoenix AZ", ], "cities": [ "Chicago IL", "Dallas TX", "Miami FL", ], } # Run the Actor and wait for it to finish run = client.actor("muhammadafzal/usa-plumbers-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 '{ "searchQueries": [ "plumbers in Houston TX", "plumbers in Phoenix AZ" ], "cities": [ "Chicago IL", "Dallas TX", "Miami FL" ] }' | apify call muhammadafzal/usa-plumbers-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=muhammadafzal/usa-plumbers-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "๐Ÿ”ง USA Plumbers Scraper โ€” Leads with Phone, Address & Website", "description": "Scrape USA plumbing businesses from Google Maps. Returns business name, phone, address, website, rating, reviews & hours. CRM-ready JSON. No login needed.", "version": "1.0", "x-build-id": "pR5iZozpdzqyfjKSg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~usa-plumbers-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-usa-plumbers-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/muhammadafzal~usa-plumbers-scraper/runs": { "post": { "operationId": "runs-sync-muhammadafzal-usa-plumbers-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/muhammadafzal~usa-plumbers-scraper/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-usa-plumbers-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": { "searchQueries": { "title": "Search Queries", "type": "array", "description": "List of Google Maps search queries. E.g. 'plumbers in Houston TX', 'emergency plumber Los Angeles'. Leave empty to auto-search top 20 US cities.", "items": { "type": "string" } }, "cities": { "title": "Auto-expand Cities", "type": "array", "description": "Provide a list of US city names (e.g. 'Chicago IL') to auto-generate 'plumbers in [city]' queries. Overrides searchQueries if both are set.", "items": { "type": "string" } }, "startUrls": { "title": "Direct Google Maps URLs", "type": "array", "description": "Paste direct Google Maps business or search URLs to scrape specific listings.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max Total Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of plumber records to return across all queries.", "default": 100 }, "maxResultsPerQuery": { "title": "Max Results Per Query", "minimum": 1, "maximum": 500, "type": "integer", "description": "How many results to extract per search query (Google Maps shows ~20 per scroll).", "default": 20 }, "language": { "title": "Language", "type": "string", "description": "Language code for Google Maps results (e.g. 'en' for English).", "default": "en" }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. Datacenter proxies are used by default. Switch to residential if blocked." } } }, "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 } } } } } } } } } } ```