Angi (HomeAdvisor) Business Scraper

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Scrape Angi (formerly HomeAdvisor) business listings, customer reviews, ratings, project photos, and service areas. Extract license information, background check status, and hire counts. Essential for home service contractors and competitive analysis. Built by John Rippy (https://www.linkedin.com/in/johnrippy/ | https://johnrippy.link/).

Features

• Profile Scraping: Complete business profile data
• Search: Find contractors by service type and location
• Review Extraction: Customer reviews with ratings and projects
• Photo Extraction: Project and portfolio photos
• Service Categories: Plumbers, electricians, HVAC, remodelers, etc.
• Bulk Processing: Scrape multiple listings efficiently

Quick Start

{
  "url": "https://example.com",
  "maxResults": 100
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Description
scrapeType	string	Type: business_profile, search, reviews
businessUrl	string	Direct Angi listing URL
searchTerm	string	Service type to search (plumber, electrician, etc.)
location	string	City, state or ZIP code
serviceType	string	Filter: plumbing, electrical, hvac, roofing, etc.
minRating	number	Minimum star rating (1.0-5.0)
includeReviews	boolean	Scrape reviews (default: true)
maxReviewsPerBusiness	number	Max reviews per listing (default: 20)
includePhotos	boolean	Extract project photos
maxResults	number	Maximum listings (default: 50)
sortBy	string	Sort: relevance, rating, review_count, years_in_business
proxyConfiguration	object	Proxy settings
demoMode	boolean	Return sample data for testing

Output Format

Listing Output

{
  "businessName": "Mike's Plumbing & Drain",
  "angiUrl": "https://www.angi.com/companylist/us/fl/miami/mikes-plumbing.htm",
  "angiId": "12345678",
  "categories": ["Plumber", "Drain Cleaning", "Water Heater"],
  "rating": 4.8,
  "reviewCount": 156,
  "grade": "A",
  "yearsInBusiness": 15,
  "hiredOnAngi": 342,
  "address": {
    "city": "Miami",
    "state": "FL",
    "zipCode": "33101"
  },
  "phone": "(305) 555-1234",
  "website": "https://mikesplumbing.com",
  "serviceAreas": ["Miami", "Miami Beach", "Coral Gables", "Kendall"],
  "licenses": ["CFC1428532", "State Licensed"],
  "insurance": true,
  "backgroundChecked": true,
  "photos": [
    "https://d2xuzatlf0eg6.cloudfront.net/photos/abc123.jpg"
  ],
  "reviews": [
    {
      "reviewId": "rev123",
      "rating": 5,
      "title": "Excellent service!",
      "text": "Mike fixed our kitchen drain quickly and professionally...",
      "author": "John D.",
      "date": "December 2024",
      "projectType": "Drain Cleaning",
      "projectCost": "$150-$300",
      "verified": true
    }
  ],
  "scrapedAt": "2024-12-21T10:30:00.000Z"
}

Pricing

This actor uses pay-per-event billing: This actor uses pay-per-event pricing:

Event	Description	Price
apify-actor-start	Base cost per run	$0.10
listing_scraped	Per business scraped	$0.04
review_scraped	Per review extracted	$0.004
photo_scraped	Per photo URL extracted	$0.002

Example costs:

• 50 contractors with 20 reviews each: $0.10 + (50 × $0.04) + (1000 × $0.004) = $6.10
• 100 contractors, no reviews: $0.10 + (100 × $0.04) = $4.10

Use Cases

• Competitive Analysis: Compare contractor ratings
• Lead Generation: Find service professionals in target areas
• Reputation Monitoring: Track your Angi presence
• Market Research: Analyze home service industry trends
• Pricing Intelligence: Understand market rates
• Review Aggregation: Combine with other platforms

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal