HomeAdvisor / Angi Scraper — US Contractor Lead Generation

Extract home service professionals from HomeAdvisor.com by service type and location. Get company name, rating, review count, review text, Screened & Approved / Elite badges, services, service areas, project cost data, and profile URLs — all structured JSON via Angi's internal API, no browser required.

Build Contractor Lead Databases Without Official API Access

HomeAdvisor has no public API (Supergood grades it F). This actor calls Angi's internal pro-search endpoint directly and returns clean structured data for every contractor found.

Key Use Cases

• Lead generation — build targeted lists of contractors by trade + geography for outreach campaigns
• Competitive intelligence — compare ratings, review counts, and Elite badges across providers in a metro area
• Market research — analyze service coverage, pricing patterns, and review sentiment by city
• CRM enrichment — append verified contractor data (name, address, rating, services) to existing contact databases
• Franchise development — identify top-performing pros in expansion markets
• Insurance & supplier outreach — find licensed, well-reviewed contractors for partnerships

How It Works

1. You provide service types (plumbing, HVAC, roofing, electrical, etc.) and locations (Houston TX, Denver CO, etc.)
2. The actor calls Angi's internal JSON API (api.angi.com/api/lpfe/proxy/landing/api/v4/pro-profiles) with the same headers the website uses
3. It paginates through results (20 pros per page) up to your configured max
4. Each professional profile is normalized into a clean dataset row with ratings, badges, services, hours, amenities, and photos

No Cloudflare scraping, no browser rendering, no fragile DOM parsing.

Extract Real Estate & Home Service Listings for Market Research

Input

Field	Type	Required	Default	Notes
serviceTypes	string[]	Yes	["plumbing"]	Lowercase slugs: plumbing, hvac, roofing, electrical, painting, landscaping, flooring, carpentry, handyman, pest-control, cleaning, fencing, tree-service, concrete, water-heater-repair, garage-door, drywall, kitchen-remodel, bathroom-remodel, deck-building, window-replacement, siding-installation
locations	string[]	Yes	["Houston, TX"]	City, State pairs. Built-in ZIP maps for: Houston, Dallas, New York, Denver, Chicago, Los Angeles, Phoenix, Austin, Miami, Atlanta, Seattle, San Francisco, Boston, Nashville, San Antonio
maxResults	integer	No	50	Max professionals per service+location (1–500)
includeReviews	boolean	No	true	Store individual customer reviews in a separate reviews dataset
maxReviewsPerPro	integer	No	10	Reserved for future use (0–100)
maxPagesPerSearch	integer	No	10	Max API pages per search (each page = 20 results)
useApifyProxy	boolean	No	true	Use Apify proxy for requests
apifyProxyGroups	string[]	No	["RESIDENTIAL"]	Proxy groups (RESIDENTIAL recommended)

Output

Each dataset item contains:

Field	Description
companyName	Professional/company name
legacyId	HomeAdvisor legacy ID
profileUrl	Direct link to the HA profile page
averageRating	Overall rating (0–5)
reviewCount	Total number of reviews
recommendedRate	Percentage of customers who recommend
averageRatings	Per-dimension breakdown: professionalism, punctuality, responsiveness, quality, value
bestReview	Highest-rated review with comment text and date
awards	Super Service Awards and Elite badge status
isSponsored	Whether the pro is a sponsored listing
eliteService	Whether the pro has Elite/Super Service status
services	List of services offered
yearsInBusiness	Years operating
businessDescription	Pro's self-description
streetAddress, city, state, postalCode	Full address
serviceHours	Weekly schedule with open/close times
responseRate	Percentage of inquiries responded to
freeEstimates, emergencyServices	Amenity flags
logoPhotoUrl, proSuppliedPhotos	Logo and project photos
serviceType, searchedLocation	Search context metadata
scrapedAt	Run timestamp

Example Input

{
  "serviceTypes": ["plumbing", "hvac", "roofing"],
  "locations": ["Houston, TX", "Denver, CO", "Dallas, TX"],
  "maxResults": 100,
  "includeReviews": true,
  "maxPagesPerSearch": 10,
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"]
}

Example Output

{
  "companyName": "Show Plumbing LLC",
  "legacyId": "158986471",
  "profileUrl": "https://www.homeadvisor.com/rated.showplumbingllc.158986471.html",
  "businessType": "LEADS",
  "city": "Houston",
  "state": "TX",
  "postalCode": "77008",
  "streetAddress": "1420 North Durham Drive",
  "averageRating": 4.58,
  "reviewCount": 492,
  "recommendedRate": 95,
  "averageRatings": {
    "PROFESSIONALISM": 5,
    "PUNCTUALITY": 4.92,
    "OVERALL": 4.85,
    "RESPONSIVENESS": 4.88,
    "QUALITY": 4.89,
    "VALUE": 4.58
  },
  "bestReview": {
    "reviewId": "...",
    "comment": "Excellent service, showed up on time...",
    "createdOn": "2022-10-25T09:03:47Z"
  },
  "eliteService": true,
  "awards": [{ "name": "Super Service Award 2025" }],
  "services": ["Faucets, Fixtures and Pipes", "Water Heater Install"],
  "yearsInBusiness": 47,
  "freeEstimates": true,
  "emergencyServices": false,
  "serviceType": "plumbing",
  "searchedLocation": "Houston, TX",
  "scrapedAt": "2026-09-10T11:26:49.439Z"
}

Integrations & Automation

• Webhooks — get notified when new contractors appear in a search
• Zapier / Make — pipe results into your CRM, Google Sheets, or outreach tool
• API — access results programmatically via the Apify API

Recommended schedule: Run daily or weekly to monitor new contractors entering a market, track rating changes, and detect new Elite/Super Service Award winners.

Related Actors

• Angi Scraper by igolaizola — Angi contractor profiles with phone numbers
• HomeAdvisor Search Page Scraper — Full profiles including phone/website
• Google Maps Scraper — Supplement contractor data with Google Maps reviews and contact info
• Outscraper Google Maps API — Enterprise-grade location data
• LinkedIn Profile Scraper — Cross-reference contractor owners on LinkedIn

FAQ

Why use this actor instead of the official API?

HomeAdvisor has no public API — the Supergood API Report Card gives it an F grade. Only a one-way webhook exists for pro accounts. This actor calls the same internal JSON endpoint the website uses, giving you programmatic access to contractor search results without browser automation.

What are the alternatives to HomeAdvisor for contractor data?

• Thumbtack — similar contractor marketplace, different data fields
• Houzz — design-focused professionals
• Porch — home services platform
• BuildZoom — permit-based contractor data
• Google Maps — general business listings with reviews

Traditional databases like Apollo and ZoomInfo miss 80–90% of licensed contractors according to 2026 research, making HomeAdvisor/Angi one of the richest sources for this niche.

How many results can I get per search?

Each API page returns 20 pros. With maxPagesPerSearch: 100 and maxResults: 500, you can extract up to 500 professionals per service+location combination.

Can I scrape cities beyond the built-in ZIP map?

Yes — pass any City, ST pair. The built-in ZIP override map improves ranking for 15 major metros; unknown cities use the locality slug alone (results still return, but with fewer ZIP overrides).

Is this legal?

This actor retrieves publicly available business listing data from HomeAdvisor/Angi. Users are responsible for compliance with applicable Terms of Service and data protection regulations. Do not use scraped data for unsolicited communications without proper consent.

SEO Keywords

homeadvisor scraper, angi scraper, homeadvisor api alternative, contractor lead generation, home services data extraction, plumber lead generation, hvac contractor database, contractor database building, home service professionals list, homeadvisor reviews scraping, angi contractor data, home services lead generation, roofing contractor database, plumbing contractor directory, hvac company list by state, homeadvisor vs thumbtack, home improvement contractor list, contractor contact data, scrape homeadvisor ratings, homeadvisor data export, angi pro scraper, home services professionals scraping

For AI Agents & LLM Apps

Purpose: Extract US home service professionals from HomeAdvisor/Angi by service type and location, returning structured contractor profiles with ratings, reviews, badges, services, and contact information.

Minimal working input:

{
  "serviceTypes": ["plumbing"],
  "locations": ["Houston, TX"],
  "maxResults": 50
}

Output fields: companyName, legacyId, profileUrl, averageRating, reviewCount, recommendedRate, averageRatings, bestReview, eliteService, awards, services, yearsInBusiness, businessDescription, streetAddress, city, state, postalCode, serviceHours, responseRate, freeEstimates, emergencyServices, logoPhotoUrl, proSuppliedPhotos, serviceType, searchedLocation, scrapedAt

Behaviors an agent should know:

• serviceTypes accepts lowercase slugs (e.g. plumbing, hvac) — not display names
• locations uses City, ST format — built-in ZIP maps exist for 15 major US metros
• maxResults caps per service+location combination, not total
• maxPagesPerSearch controls pagination depth (each page = 20 results)
• Reviews are fetched on a best-effort basis — the list API always returns a summary row
• The actor uses Apify Residential proxy by default — disable only if your plan lacks the add-on

Billing model: Pay-per-event ($0.003 per professional, $0.001 per review, $0.0005 per actor start)

Legal & Compliance Disclaimer

This actor is independent and not affiliated with, endorsed by, or sponsored by Angi Inc. or HomeAdvisor. It accesses only publicly available business listing pages on HomeAdvisor.com — no login bypass, no CAPTCHA solving, no private API exploitation. Users are responsible for their own compliance with HomeAdvisor's Terms of Service and applicable data-protection law. Do not use scraped data for unsolicited commercial outreach in violation of applicable law (e.g. CAN-SPAM, TCPA).