HomeAdvisor Pro Directory Scraper

Extract home-services pro business listings from HomeAdvisor's directory, by trade and city. Get business name, star rating, review count, years in business, HomeAdvisor's Approved screening badge, and service area for every pro listed under a trade in a city you choose.

What it does

HomeAdvisor lists screened home-service professionals — roofers, plumbers, remodelers, movers, and 29 other trades — for cities across the US. This actor reads that directory for you: pick one or more trades and one or more cities, and it returns every pro listing it finds, paginating through the full result set up to your maxItems cap.

Example use cases:

• Build a prospect list of contractors in a specific trade and metro for B2B outreach
• Track a market's pro count, average rating, and screening rate over time
• Benchmark a specific business's rating and review count against local competitors
• Feed a local-services lead list or directory aggregator

Input

Field	Type	Description
trades	Array of enums	Trades to crawl (e.g. Roofing, Additions-Remodeling, Painting). Leave empty to crawl all 33 trades HomeAdvisor lists.
locations	Array of strings	Required. One or more "City, ST" entries (e.g. "Chicago, IL", "Los Angeles, CA"). Spelling/capitalization must match how HomeAdvisor lists the city.
maxItems	Integer	Maximum number of pro listings to save, across every selected trade and location combination.

Example input:

{
  "trades": ["Roofing", "Additions-Remodeling"],
  "locations": ["Chicago, IL", "Denver, CO"],
  "maxItems": 100
}

Output

Each record is one pro listing:

Field	Description
id	Numeric HomeAdvisor business id
business_name	Business/pro name as listed on HomeAdvisor
trade	Trade this listing was crawled under
city	City searched
state	Two-letter state abbreviation searched
profile_url	HomeAdvisor pro profile URL
rating	Average star rating (0-5), when the pro has reviews
review_count	Number of reviews backing the rating
years_in_business	Years in business, when HomeAdvisor discloses it
screened_approved	Whether the listing carries HomeAdvisor/Angi's Approved screening badge
service_area	Free-text service area shown on the listing (e.g. "Serving Chicago, IL and surrounding areas")
scrapedAt	ISO-8601 timestamp when the record was scraped

Example output record:

{
  "id": "129943266",
  "business_name": "Five Sons Roofing Co.",
  "trade": "Roofing",
  "city": "Denver",
  "state": "CO",
  "profile_url": "https://www.homeadvisor.com/rated.FiveSonsRoofingCo.129943266.html",
  "rating": 4.8,
  "review_count": 27,
  "years_in_business": 31,
  "screened_approved": true,
  "service_area": "Serving Denver, CO and surrounding areas",
  "scrapedAt": "2026-08-20T06:18:14.925Z"
}

Notes

• HomeAdvisor is a lead-generation marketplace, not a classic contact directory — it does not publish a pro's phone number or website on either the listing or the profile page; contact happens through HomeAdvisor's own "Request Quote" flow. This actor does not carry a phone or website field for that reason.
• rating and review_count are absent (null) for pros with no reviews yet — that's real, not missing data.
• trades and locations fan out as a cross product: 2 trades x 2 locations = 4 combinations, each paginated independently up to your maxItems budget.

Resuming a large crawl

Every run emits a resumeCursor in its Output. If a large crawl stops before it finishes — because it hit maxItems, your spend cap (maxTotalChargeUsd), or was aborted — start a new run with the same input plus that resumeCursor to continue from where it left off. The crawl resumes from the queued work the previous run didn't reach.

• You are not re-charged for records the earlier run already delivered.
• Resume within your account's run-retention window — on the free tier, roughly your 10 most recent runs. Once the source run is pruned, its resumeCursor is no longer valid.
• resumeCursor is opaque — supply it unmodified.

FAQ

How do I scrape HomeAdvisor's pro directory?

Set locations to one or more "City, ST" entries, optionally narrow trades to specific services, and set maxItems. The actor returns every matching pro listing as structured JSON — no need to know HomeAdvisor's category taxonomy or URL structure ahead of time.

Does this include every pro HomeAdvisor has for a trade/city?

Up to maxItems, yes — the actor paginates through HomeAdvisor's own result count for that trade and city combination.