# USA Roofing Contractor Directory Scraper (`happitap/usa-roofing-contractor-scraper`) Actor Extract premium roofing contractors, roof repair specialists, and commercial roofers across the United States. High-ticket B2B leads - **URL**: https://apify.com/happitap/usa-roofing-contractor-scraper.md - **Developed by:** [HappiTap](https://apify.com/happitap) (community) - **Categories:** Lead generation, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 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. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Roofing Contractor Directory Scraper **Extract premium roofing contractors, roof repair specialists, and commercial roofers across the United States.** The USA Roofing Contractor Directory Scraper extracts high-quality, high-ticket B2B leads from major US directories like YellowPages, providing you with contractor names, phone numbers, and ratings. ### What can USA Roofing Contractor Directory Scraper do? - ✅ **Extract Premium Leads** - Get company names, physical addresses, and direct phone numbers. - ✅ **Assess Quality** - Scrape star ratings and review counts to target the best contractors. - ✅ **Extract Services** - Identify specific services offered (e.g., Roof Repair, Installation, Commercial). - ✅ **Export formats** - Download data in JSON, CSV, Excel, or HTML formats. - ✅ **Integrations** - Connect seamlessly with API, webhooks, Make, or Zapier. - ✅ **No coding required** - Use our simple interface to start scraping immediately. ### Why scrape USA Roofing Contractors? US contractor directories contain incredibly valuable data for: - 🎯 **B2B Suppliers** - Target companies that need roofing materials, shingles, and tools. - 📊 **Lead Gen Agencies** - Connect with roofers to sell expensive local consumer leads. - 📍 **Software Providers** - Pitch estimating, CRM, and drone measurement software to roofing businesses. ### What data can you extract? | Data Field | Description | Example | |------------|-------------|---------| | **contractorName** | The name of the business | "Miami Roofing Experts" | | **services** | Types of services offered | "Roof Repair, Installation" | | **address** | The full address | "123 Ocean Drive, Miami, FL 33139" | | **phone** | Direct contact number | "(305) 123-4567" | | **rating** | User rating and review count | "5.0 (25 Reviews)" | | **website** | Company website | "https://www.example.com" | | **listingUrl** | Link to the directory listing | "https://www.yellowpages.com/..." | ### How to scrape Roofing Contractor data 1. **Click "Try for free"** to start using the actor. 2. **Enter your input** - Provide a keyword (e.g., "roofing contractor") and location (e.g., "Miami, FL"). 3. **Configure options** - Set the maximum number of leads you want to extract. 4. **Start the scraper** - Click Start and let the actor do the work. 5. **Download results** - Export your leads as JSON, CSV, or Excel. ### Input Configure the scraper with these key settings: - **Keyword** - The specific niche (e.g., 'roofing contractor', 'roof repair'). - **Location** - The US City, State, or Zip Code (e.g., 'Miami, FL', 'Dallas, TX'). - **Maximum Leads** - The total number of records to extract. - **Proxy Configuration** - Apify Residential Proxy (US targeted) is required. ### Output You can download data in multiple formats: - **JSON** - For developers and programmatic access - **CSV** - For easy import into Excel or CRM systems - **Excel** - Ready-to-use spreadsheet #### Output example ```json { "contractorName": "Miami Roofing Experts", "services": "Roof Repair, Installation", "address": "123 Ocean Drive, Miami, FL 33139", "phone": "(305) 123-4567", "website": "https://www.example.com", "rating": "5.0 25 Reviews", "listingUrl": "https://www.yellowpages.com/...", "scrapedAt": "2026-07-02T15:00:00Z" } ```` ### How much does it cost? This actor uses a Pay-Per-Event (PPE) pricing model: - **Base Fee**: $0.25 per start - **Lead Fee**: $3.50 per 1,000 roofing leads extracted ($0.0035 per lead) **Free tier**: Apify provides $5 in free monthly credits, allowing you to extract over 1,000 premium leads for free! ### Is it legal to scrape? Yes, scraping publicly available data is generally legal. This Actor only extracts public information. **Best practices**: - Use the data ethically for B2B outreach. - Respect the target site's Terms of Service. - Ensure compliance with CAN-SPAM/CCPA equivalents when handling contact information. ### Integrations Connect with 1000+ apps: - **Google Sheets** - Auto-update spreadsheets with new leads. - **Slack** - Get notifications when scraping finishes. - **Webhooks** - Send data directly to your CRM. - **API** - Programmatic access for developers. *** **License**: Apache-2.0 | **Version**: 1.0.0 # Actor input Schema ## `startUrls` (type: `array`): List of search URLs to scrape. ## `maxLeads` (type: `integer`): Maximum number of US roofing contractor leads to extract. ## `proxyConfiguration` (type: `object`): Proxy settings. Apify Residential Proxy (US targeted) is required. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.yellowpages.com/search?search_terms=roofing+contractor&geo_location_terms=Miami%2C+FL" } ], "maxLeads": 100, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (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 = { "startUrls": [ { "url": "https://www.yellowpages.com/search?search_terms=roofing+contractor&geo_location_terms=Miami%2C+FL" } ], "proxyConfiguration": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("happitap/usa-roofing-contractor-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 = { "startUrls": [{ "url": "https://www.yellowpages.com/search?search_terms=roofing+contractor&geo_location_terms=Miami%2C+FL" }], "proxyConfiguration": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("happitap/usa-roofing-contractor-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 '{ "startUrls": [ { "url": "https://www.yellowpages.com/search?search_terms=roofing+contractor&geo_location_terms=Miami%2C+FL" } ], "proxyConfiguration": { "useApifyProxy": true } }' | apify call happitap/usa-roofing-contractor-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=happitap/usa-roofing-contractor-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "USA Roofing Contractor Directory Scraper", "description": "Extract premium roofing contractors, roof repair specialists, and commercial roofers across the United States. High-ticket B2B leads", "version": "1.0", "x-build-id": "vq5bXh895bubh1hMK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/happitap~usa-roofing-contractor-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-happitap-usa-roofing-contractor-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/happitap~usa-roofing-contractor-scraper/runs": { "post": { "operationId": "runs-sync-happitap-usa-roofing-contractor-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/happitap~usa-roofing-contractor-scraper/run-sync": { "post": { "operationId": "run-sync-happitap-usa-roofing-contractor-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of search URLs to scrape.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxLeads": { "title": "Maximum Leads", "minimum": 1, "type": "integer", "description": "Maximum number of US roofing contractor leads to extract.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Apify Residential Proxy (US targeted) is required." } } }, "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 } } } } } } } } } } ```