🚀 Angi HomeAdvisor Contractor & Cost Scraper

Production-grade, high-speed data extraction tool for extracting real-time structured data from Angi Contractor Leads. Designed specifically for B2B data teams, automated workflows, and LLM/RAG pipelines with Pay-Per-Result (PPR) pricing and Free Platform Usage.

---

🥊 Why This Actor Beats the Competition

Feature	⚡ This Actor (angi-contractor-leads-scraper)	🐌 Legacy Scrapers
Pricing Model	Pay-Per-Result ($3.00/1k)	Heavy monthly rental or surprise compute charges
Platform Compute	100% FREE (Bundled in PPR)	Buyer pays for compute hours & memory
Speed	Sub-second direct HTTP (200+ items/sec)	5–15 seconds per page via heavy Puppeteer
Anti-Bot Resilience	Native browser fingerprint spoofing	Frequent 403 blocks and IP bans
Volume Discounts	10% Bronze / 20% Silver / 30% Gold	Fixed high price across all tiers
Setup Friction	Zero auth or external API key required	Requires complicated API registration

---

🛠️ How to Use

Method 1: Apify Web Console (No-Code GUI)

1. Navigate to the Actor page on the Apify Console.
2. Enter your target Home Trade Specialty or Service and set Maximum Results Count.
3. Click Start and download your dataset in JSON, CSV, Excel, or XML format.

Method 2: Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run_input = {
    "tradeCategory": "Roofing Repair",
    "maxItems": 50
}

run = client.actor("litezero/angi-contractor-leads-scraper").call(run_input=run_input)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Method 3: Node.js SDK

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('litezero/angi-contractor-leads-scraper').call({
    tradeCategory: 'Roofing Repair',
    maxItems: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Method 4: REST API (cURL)

curl -X POST "https://api.apify.com/v2/acts/litezero~angi-contractor-leads-scraper/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tradeCategory": "Roofing Repair", "maxItems": 20}'

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
tradeCategory	String	Yes	"Roofing Repair"	Service specialty (e.g. 'Roofing Repair', 'Plumbing', 'HVAC Installation', 'Electrician', 'Landscaping').
maxItems	Integer	No	20	Maximum number of records to extract (1 to 1000).
proxyConfiguration	Object	No	None	Optional proxy settings.

---

📤 Output Data Dictionary & Sample JSON

Every extracted record includes complete metadata and conforms to the following schema:

{
  "contractorName": "Apex Precision Roofing & Solar",
  "trade": "Roofing Repair & Replacement",
  "location": "Denver, CO",
  "zipCode": "80202",
  "rating": 4.8,
  "reviewsCount": 184,
  "isScreened": true,
  "isAngiCertified": true,
  "averageCostRange": "$4,500 - $12,800",
  "emergencyService": true,
  "phone": "(303) 555-0182",
  "angiProfileUrl": "https://www.angi.com/companylist/us/co/denver/apex-precision-roofing.htm",
  "scrapedAt": "2026-10-06T10:00:00.000Z"
}

---

💡 Top Commercial Use Cases

1. Market & Competitor Intelligence: Benchmark pricing, ratings, and customer sentiment continuously.
2. B2B Lead Generation & Outreach: Enrich your CRM with verified profiles, addresses, and contacts.
3. AI & RAG Vector Pipelines: Ingest fresh, structured domain data into enterprise LLMs and vector stores.

---

Maintained under Apify Creator Account litezero. Built in full compliance with the Apify Store quality guidelines.