# Angi (Angie's List) Contractor & Reviews Scraper (`parseforge/angies-list-scraper`) Actor

Extract verified home service contractor profiles, ratings, reviews, services, addresses, and business hours from Angi (Angie's List). Used by contractors, insurance, and lead-gen teams.

- **URL**: https://apify.com/parseforge/angies-list-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Business, Lead generation
- **Stats:** 4 total users, 2 monthly users, 93.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🏠 Angie's List Scraper — Contractor Profiles & Reviews

> 🕒 **Last updated:** 2026-06-17 · **4 input fields** · **Scalable to 1M+ results**

**Scrape contractor profiles and customer reviews from Angi (formerly Angie's List).** Extract business name, rating, review count, service categories, contact information, and full review text. Filter by service type and location to build targeted lists of home service providers. Export as JSON, CSV, Excel, XML, or JSONL.

---

### 🎯 Target Audience | Use Cases

| Audience | What they get |
|----------|---------------|
| **Lead generation** | Contractor contact lists by service category and location |
| **Market analysts** | Review trends, rating distributions, service category saturation |
| **Homeowners** | Vetted contractor data with real customer reviews |
| **Agencies** | Enrichment data for home services marketplaces and directories |

---

### ⚙️ What the Scraper Does

Scrapes contractor business profiles and customer reviews from Angi.com.

- **Service category search** — filter by trade (plumbers, electricians, roofers, landscapers, etc.)
- **Location targeting** — narrow by city, state, or ZIP
- **Profile extraction** — business name, phone, address, years in business, licenses
- **Review extraction** — star rating, review count, full review text with dates

---

### 🎬 Full Demo

_Coming soon._

---

### 🔧 Input

| Field | Type | Required | Description |
|-------|------|:--------:|-------------|
| `searchTerm` | string | Yes | Service or trade to search (e.g. "plumber", "electrician", "roofing") |
| `location` | string | No | City, state, or ZIP to filter results |
| `maxItems` | integer | No | Free: 100. Paid: up to 1,000,000 |
| `proxyConfiguration` | object | No | Proxy settings if needed |

**Example:**
```json
{
  "searchTerm": "electrician",
  "location": "Austin, TX",
  "maxItems": 50
}
````

***

### 📊 Output

Each result is one contractor profile with these fields (derived from the input schema):

| Field | Type | Description |
|-------|------|-------------|
| `businessName` | string | Contractor business name |
| `category` | string | Service category |
| `rating` | number | Average star rating (1-5) |
| `reviewCount` | integer | Total number of reviews |
| `phone` | string | Business phone number |
| `address` | string | Street address |
| `city` | string | City |
| `state` | string | State |
| `zip` | string | ZIP code |
| `yearsInBusiness` | integer | Years in business |
| `reviews` | array | Recent review texts with ratings and dates |

> ⚠️ Output fields derived from input schema. No recent completed runs — fields will be validated after the next run.

***

### 💎 Why Choose This Actor

- **Angi-specific** — built for Angi's structure, not a generic scraper
- **Contact data** — phone, address, years in business included
- **Review extraction** — full review text, not just aggregates
- **Flexible output** — JSON, CSV, Excel, XML, JSONL

***

### 📈 How It Compares

| Feature | This Actor | Angi website | Manual collection |
|---------|:----------:|:------------:|:-----------------:|
| Bulk export | ✅ | ❌ | ❌ |
| Multi-category search | ✅ | Partial | ❌ |
| Review text extraction | ✅ | ✅ (one by one) | ❌ |
| API / automation | ✅ | ❌ | ❌ |

***

### 🚀 How to Use

1. **[Sign up for Apify](https://console.apify.com/sign-up?fpr=vmoqkp)**
2. **Set your search** — pick a service (e.g. "roofer") and location
3. **Run** — results appear in the dataset tab
4. **Export** as JSON, CSV, Excel, XML, or JSONL

***

### 💼 Business Use Cases

#### 📊 Data & Analytics

Track contractor availability, review quality, and service coverage by region.

#### 🏢 Operations & Strategy

Monitor competitor contractors, pricing signals from review data.

#### 🎯 Marketing & Growth

Build targeted prospect lists of contractors by trade and location.

#### 🛠️ Engineering & Product

Enrich home services platforms with live contractor and review data.

***

### 🌟 Beyond Business

#### 🎓 Research

Study local service economies, contractor review dynamics, and trust signals.

#### 🎨 Personal

Find top-rated contractors for home renovation projects.

#### 🤝 Non-profit

Identify service providers for community and housing programs.

***

### 🤖 Ask an AI Assistant

Ask any AI assistant about this scraper for faster setup and troubleshooting.

***

### ❓ Frequently Asked Questions

**Q: What search terms work?**
Any trade or service: plumber, electrician, roofer, HVAC, painter, landscaper, handyman, etc.

**Q: How do I filter by location?**
Set the `location` field to a city (e.g. "Denver"), state ("CO"), or ZIP code.

**Q: Do I get reviews or just ratings?**
Both. Ratings, review count, and individual review text are included.

**Q: Is there a rate limit?**
The scraper respects Angi's rate limits automatically.

**Q: Can I schedule recurring runs?**
Yes. Use Apify's scheduler to track contractors and reviews over time.

***

### 🔌 Integrations

Works with Make, Zapier, Slack, Google Sheets, Airtable, and any webhook-compatible tool.

***

### 💡 More ParseForge Actors

1,500+ keyless scrapers available. Check the store for Yelp, Google Maps, Houzz, and more.

***

### 🚀 Ready to Start?

[Try it free on Apify](https://console.apify.com/sign-up?fpr=vmoqkp)

***

### 🆘 Need Help?

[Open an issue](https://github.com/ParseForge) or use our contact form.

***

### ⚠️ Disclaimer

This scraper accesses publicly available Angi data. Users are responsible for complying with Angi's terms of service.

# Actor input Schema

## `searchUrls` (type: `array`):

One or more Angi listing URLs. Use a city + service URL (e.g. https://www.angi.com/companylist/us/ca/los-angeles/plumbers.htm), a state-wide service URL (https://www.angi.com/companylist/us/ny/electricians.htm), or a directory page (https://www.angi.com/companylist/us/tx/). The scraper visits each URL and aggregates contractor profiles.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000.

## `fetchProfileDetails` (type: `boolean`):

When enabled the scraper visits each contractor's profile page to enrich records with description, address, phone, badges, and review highlights. Disable for a faster, listing-only run.

## `proxyConfiguration` (type: `object`):

Apify residential US proxy is recommended to bypass Cloudflare and DataDome challenges reliably.

## Actor input object example

```json
{
  "searchUrls": [
    "https://www.angi.com/companylist/us/az/phoenix/electrical.htm",
    "https://www.angi.com/companylist/us/az/phoenix/house-cleaning.htm",
    "https://www.angi.com/companylist/us/az/phoenix/hvac.htm",
    "https://www.angi.com/companylist/us/az/phoenix/landscaping.htm",
    "https://www.angi.com/companylist/us/az/phoenix/painting.htm",
    "https://www.angi.com/companylist/us/az/phoenix/plumbing.htm",
    "https://www.angi.com/companylist/us/az/phoenix/roofing.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/electrical.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/hvac.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/painting.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/roofing.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/electrical.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/hvac.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/painting.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/roofing.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/electrical.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/hvac.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/painting.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/roofing.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/electrical.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/hvac.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/painting.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/roofing.htm",
    "https://www.angi.com/companylist/us/co/denver/electrical.htm",
    "https://www.angi.com/companylist/us/co/denver/house-cleaning.htm",
    "https://www.angi.com/companylist/us/co/denver/hvac.htm",
    "https://www.angi.com/companylist/us/co/denver/landscaping.htm",
    "https://www.angi.com/companylist/us/co/denver/painting.htm",
    "https://www.angi.com/companylist/us/co/denver/plumbing.htm",
    "https://www.angi.com/companylist/us/co/denver/roofing.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/electrical.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/house-cleaning.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/hvac.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/landscaping.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/painting.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/plumbing.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/roofing.htm",
    "https://www.angi.com/companylist/us/il/chicago/electrical.htm",
    "https://www.angi.com/companylist/us/il/chicago/house-cleaning.htm",
    "https://www.angi.com/companylist/us/il/chicago/hvac.htm",
    "https://www.angi.com/companylist/us/il/chicago/landscaping.htm",
    "https://www.angi.com/companylist/us/il/chicago/painting.htm",
    "https://www.angi.com/companylist/us/il/chicago/plumbing.htm",
    "https://www.angi.com/companylist/us/il/chicago/roofing.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/electrical.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/house-cleaning.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/hvac.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/landscaping.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/painting.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/plumbing.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/roofing.htm",
    "https://www.angi.com/companylist/us/ma/boston/electrical.htm",
    "https://www.angi.com/companylist/us/ma/boston/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ma/boston/hvac.htm",
    "https://www.angi.com/companylist/us/ma/boston/landscaping.htm",
    "https://www.angi.com/companylist/us/ma/boston/painting.htm",
    "https://www.angi.com/companylist/us/ma/boston/plumbing.htm",
    "https://www.angi.com/companylist/us/ma/boston/roofing.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/electrical.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/house-cleaning.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/hvac.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/landscaping.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/painting.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/plumbing.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/roofing.htm",
    "https://www.angi.com/companylist/us/oh/columbus/electrical.htm",
    "https://www.angi.com/companylist/us/oh/columbus/house-cleaning.htm",
    "https://www.angi.com/companylist/us/oh/columbus/hvac.htm",
    "https://www.angi.com/companylist/us/oh/columbus/landscaping.htm",
    "https://www.angi.com/companylist/us/oh/columbus/painting.htm",
    "https://www.angi.com/companylist/us/oh/columbus/plumbing.htm",
    "https://www.angi.com/companylist/us/oh/columbus/roofing.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/electrical.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/house-cleaning.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/hvac.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/landscaping.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/painting.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/plumbing.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/roofing.htm",
    "https://www.angi.com/companylist/us/tn/nashville/electrical.htm",
    "https://www.angi.com/companylist/us/tn/nashville/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tn/nashville/hvac.htm",
    "https://www.angi.com/companylist/us/tn/nashville/landscaping.htm",
    "https://www.angi.com/companylist/us/tn/nashville/painting.htm",
    "https://www.angi.com/companylist/us/tn/nashville/plumbing.htm",
    "https://www.angi.com/companylist/us/tn/nashville/roofing.htm",
    "https://www.angi.com/companylist/us/tx/austin/electrical.htm",
    "https://www.angi.com/companylist/us/tx/austin/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/austin/hvac.htm",
    "https://www.angi.com/companylist/us/tx/austin/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/austin/painting.htm",
    "https://www.angi.com/companylist/us/tx/austin/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/austin/roofing.htm",
    "https://www.angi.com/companylist/us/tx/dallas/electrical.htm",
    "https://www.angi.com/companylist/us/tx/dallas/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/dallas/hvac.htm",
    "https://www.angi.com/companylist/us/tx/dallas/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/dallas/painting.htm",
    "https://www.angi.com/companylist/us/tx/dallas/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/dallas/roofing.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/electrical.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/hvac.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/painting.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/roofing.htm",
    "https://www.angi.com/companylist/us/tx/houston/electrical.htm",
    "https://www.angi.com/companylist/us/tx/houston/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/houston/hvac.htm",
    "https://www.angi.com/companylist/us/tx/houston/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/houston/painting.htm",
    "https://www.angi.com/companylist/us/tx/houston/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/houston/roofing.htm",
    "https://www.angi.com/companylist/us/wa/seattle/electrical.htm",
    "https://www.angi.com/companylist/us/wa/seattle/house-cleaning.htm",
    "https://www.angi.com/companylist/us/wa/seattle/hvac.htm",
    "https://www.angi.com/companylist/us/wa/seattle/landscaping.htm",
    "https://www.angi.com/companylist/us/wa/seattle/painting.htm",
    "https://www.angi.com/companylist/us/wa/seattle/plumbing.htm",
    "https://www.angi.com/companylist/us/wa/seattle/roofing.htm"
  ],
  "maxItems": 10,
  "fetchProfileDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

## `contractors` (type: `string`):

Complete dataset of contractor profile records.

## `overview` (type: `string`):

Tabular overview of contractor profiles.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchUrls": [
        "https://www.angi.com/companylist/us/az/phoenix/electrical.htm",
        "https://www.angi.com/companylist/us/az/phoenix/house-cleaning.htm",
        "https://www.angi.com/companylist/us/az/phoenix/hvac.htm",
        "https://www.angi.com/companylist/us/az/phoenix/landscaping.htm",
        "https://www.angi.com/companylist/us/az/phoenix/painting.htm",
        "https://www.angi.com/companylist/us/az/phoenix/plumbing.htm",
        "https://www.angi.com/companylist/us/az/phoenix/roofing.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/electrical.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/hvac.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/painting.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/roofing.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/electrical.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/hvac.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/painting.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/roofing.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/electrical.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/hvac.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/painting.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/roofing.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/electrical.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/hvac.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/painting.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/roofing.htm",
        "https://www.angi.com/companylist/us/co/denver/electrical.htm",
        "https://www.angi.com/companylist/us/co/denver/house-cleaning.htm",
        "https://www.angi.com/companylist/us/co/denver/hvac.htm",
        "https://www.angi.com/companylist/us/co/denver/landscaping.htm",
        "https://www.angi.com/companylist/us/co/denver/painting.htm",
        "https://www.angi.com/companylist/us/co/denver/plumbing.htm",
        "https://www.angi.com/companylist/us/co/denver/roofing.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/electrical.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/house-cleaning.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/hvac.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/landscaping.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/painting.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/plumbing.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/roofing.htm",
        "https://www.angi.com/companylist/us/il/chicago/electrical.htm",
        "https://www.angi.com/companylist/us/il/chicago/house-cleaning.htm",
        "https://www.angi.com/companylist/us/il/chicago/hvac.htm",
        "https://www.angi.com/companylist/us/il/chicago/landscaping.htm",
        "https://www.angi.com/companylist/us/il/chicago/painting.htm",
        "https://www.angi.com/companylist/us/il/chicago/plumbing.htm",
        "https://www.angi.com/companylist/us/il/chicago/roofing.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/electrical.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/house-cleaning.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/hvac.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/landscaping.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/painting.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/plumbing.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/roofing.htm",
        "https://www.angi.com/companylist/us/ma/boston/electrical.htm",
        "https://www.angi.com/companylist/us/ma/boston/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ma/boston/hvac.htm",
        "https://www.angi.com/companylist/us/ma/boston/landscaping.htm",
        "https://www.angi.com/companylist/us/ma/boston/painting.htm",
        "https://www.angi.com/companylist/us/ma/boston/plumbing.htm",
        "https://www.angi.com/companylist/us/ma/boston/roofing.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/electrical.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/house-cleaning.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/hvac.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/landscaping.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/painting.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/plumbing.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/roofing.htm",
        "https://www.angi.com/companylist/us/oh/columbus/electrical.htm",
        "https://www.angi.com/companylist/us/oh/columbus/house-cleaning.htm",
        "https://www.angi.com/companylist/us/oh/columbus/hvac.htm",
        "https://www.angi.com/companylist/us/oh/columbus/landscaping.htm",
        "https://www.angi.com/companylist/us/oh/columbus/painting.htm",
        "https://www.angi.com/companylist/us/oh/columbus/plumbing.htm",
        "https://www.angi.com/companylist/us/oh/columbus/roofing.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/electrical.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/house-cleaning.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/hvac.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/landscaping.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/painting.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/plumbing.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/roofing.htm",
        "https://www.angi.com/companylist/us/tn/nashville/electrical.htm",
        "https://www.angi.com/companylist/us/tn/nashville/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tn/nashville/hvac.htm",
        "https://www.angi.com/companylist/us/tn/nashville/landscaping.htm",
        "https://www.angi.com/companylist/us/tn/nashville/painting.htm",
        "https://www.angi.com/companylist/us/tn/nashville/plumbing.htm",
        "https://www.angi.com/companylist/us/tn/nashville/roofing.htm",
        "https://www.angi.com/companylist/us/tx/austin/electrical.htm",
        "https://www.angi.com/companylist/us/tx/austin/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/austin/hvac.htm",
        "https://www.angi.com/companylist/us/tx/austin/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/austin/painting.htm",
        "https://www.angi.com/companylist/us/tx/austin/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/austin/roofing.htm",
        "https://www.angi.com/companylist/us/tx/dallas/electrical.htm",
        "https://www.angi.com/companylist/us/tx/dallas/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/dallas/hvac.htm",
        "https://www.angi.com/companylist/us/tx/dallas/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/dallas/painting.htm",
        "https://www.angi.com/companylist/us/tx/dallas/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/dallas/roofing.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/electrical.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/hvac.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/painting.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/roofing.htm",
        "https://www.angi.com/companylist/us/tx/houston/electrical.htm",
        "https://www.angi.com/companylist/us/tx/houston/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/houston/hvac.htm",
        "https://www.angi.com/companylist/us/tx/houston/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/houston/painting.htm",
        "https://www.angi.com/companylist/us/tx/houston/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/houston/roofing.htm",
        "https://www.angi.com/companylist/us/wa/seattle/electrical.htm",
        "https://www.angi.com/companylist/us/wa/seattle/house-cleaning.htm",
        "https://www.angi.com/companylist/us/wa/seattle/hvac.htm",
        "https://www.angi.com/companylist/us/wa/seattle/landscaping.htm",
        "https://www.angi.com/companylist/us/wa/seattle/painting.htm",
        "https://www.angi.com/companylist/us/wa/seattle/plumbing.htm",
        "https://www.angi.com/companylist/us/wa/seattle/roofing.htm"
    ],
    "maxItems": 10,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/angies-list-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchUrls": [
        "https://www.angi.com/companylist/us/az/phoenix/electrical.htm",
        "https://www.angi.com/companylist/us/az/phoenix/house-cleaning.htm",
        "https://www.angi.com/companylist/us/az/phoenix/hvac.htm",
        "https://www.angi.com/companylist/us/az/phoenix/landscaping.htm",
        "https://www.angi.com/companylist/us/az/phoenix/painting.htm",
        "https://www.angi.com/companylist/us/az/phoenix/plumbing.htm",
        "https://www.angi.com/companylist/us/az/phoenix/roofing.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/electrical.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/hvac.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/painting.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/los-angeles/roofing.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/electrical.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/hvac.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/painting.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/san-diego/roofing.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/electrical.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/hvac.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/painting.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/san-francisco/roofing.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/electrical.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/hvac.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/landscaping.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/painting.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/plumbing.htm",
        "https://www.angi.com/companylist/us/ca/san-jose/roofing.htm",
        "https://www.angi.com/companylist/us/co/denver/electrical.htm",
        "https://www.angi.com/companylist/us/co/denver/house-cleaning.htm",
        "https://www.angi.com/companylist/us/co/denver/hvac.htm",
        "https://www.angi.com/companylist/us/co/denver/landscaping.htm",
        "https://www.angi.com/companylist/us/co/denver/painting.htm",
        "https://www.angi.com/companylist/us/co/denver/plumbing.htm",
        "https://www.angi.com/companylist/us/co/denver/roofing.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/electrical.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/house-cleaning.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/hvac.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/landscaping.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/painting.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/plumbing.htm",
        "https://www.angi.com/companylist/us/fl/jacksonville/roofing.htm",
        "https://www.angi.com/companylist/us/il/chicago/electrical.htm",
        "https://www.angi.com/companylist/us/il/chicago/house-cleaning.htm",
        "https://www.angi.com/companylist/us/il/chicago/hvac.htm",
        "https://www.angi.com/companylist/us/il/chicago/landscaping.htm",
        "https://www.angi.com/companylist/us/il/chicago/painting.htm",
        "https://www.angi.com/companylist/us/il/chicago/plumbing.htm",
        "https://www.angi.com/companylist/us/il/chicago/roofing.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/electrical.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/house-cleaning.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/hvac.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/landscaping.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/painting.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/plumbing.htm",
        "https://www.angi.com/companylist/us/in/indianapolis/roofing.htm",
        "https://www.angi.com/companylist/us/ma/boston/electrical.htm",
        "https://www.angi.com/companylist/us/ma/boston/house-cleaning.htm",
        "https://www.angi.com/companylist/us/ma/boston/hvac.htm",
        "https://www.angi.com/companylist/us/ma/boston/landscaping.htm",
        "https://www.angi.com/companylist/us/ma/boston/painting.htm",
        "https://www.angi.com/companylist/us/ma/boston/plumbing.htm",
        "https://www.angi.com/companylist/us/ma/boston/roofing.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/electrical.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/house-cleaning.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/hvac.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/landscaping.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/painting.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/plumbing.htm",
        "https://www.angi.com/companylist/us/nc/charlotte/roofing.htm",
        "https://www.angi.com/companylist/us/oh/columbus/electrical.htm",
        "https://www.angi.com/companylist/us/oh/columbus/house-cleaning.htm",
        "https://www.angi.com/companylist/us/oh/columbus/hvac.htm",
        "https://www.angi.com/companylist/us/oh/columbus/landscaping.htm",
        "https://www.angi.com/companylist/us/oh/columbus/painting.htm",
        "https://www.angi.com/companylist/us/oh/columbus/plumbing.htm",
        "https://www.angi.com/companylist/us/oh/columbus/roofing.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/electrical.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/house-cleaning.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/hvac.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/landscaping.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/painting.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/plumbing.htm",
        "https://www.angi.com/companylist/us/pa/philadelphia/roofing.htm",
        "https://www.angi.com/companylist/us/tn/nashville/electrical.htm",
        "https://www.angi.com/companylist/us/tn/nashville/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tn/nashville/hvac.htm",
        "https://www.angi.com/companylist/us/tn/nashville/landscaping.htm",
        "https://www.angi.com/companylist/us/tn/nashville/painting.htm",
        "https://www.angi.com/companylist/us/tn/nashville/plumbing.htm",
        "https://www.angi.com/companylist/us/tn/nashville/roofing.htm",
        "https://www.angi.com/companylist/us/tx/austin/electrical.htm",
        "https://www.angi.com/companylist/us/tx/austin/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/austin/hvac.htm",
        "https://www.angi.com/companylist/us/tx/austin/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/austin/painting.htm",
        "https://www.angi.com/companylist/us/tx/austin/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/austin/roofing.htm",
        "https://www.angi.com/companylist/us/tx/dallas/electrical.htm",
        "https://www.angi.com/companylist/us/tx/dallas/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/dallas/hvac.htm",
        "https://www.angi.com/companylist/us/tx/dallas/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/dallas/painting.htm",
        "https://www.angi.com/companylist/us/tx/dallas/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/dallas/roofing.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/electrical.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/hvac.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/painting.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/fort-worth/roofing.htm",
        "https://www.angi.com/companylist/us/tx/houston/electrical.htm",
        "https://www.angi.com/companylist/us/tx/houston/house-cleaning.htm",
        "https://www.angi.com/companylist/us/tx/houston/hvac.htm",
        "https://www.angi.com/companylist/us/tx/houston/landscaping.htm",
        "https://www.angi.com/companylist/us/tx/houston/painting.htm",
        "https://www.angi.com/companylist/us/tx/houston/plumbing.htm",
        "https://www.angi.com/companylist/us/tx/houston/roofing.htm",
        "https://www.angi.com/companylist/us/wa/seattle/electrical.htm",
        "https://www.angi.com/companylist/us/wa/seattle/house-cleaning.htm",
        "https://www.angi.com/companylist/us/wa/seattle/hvac.htm",
        "https://www.angi.com/companylist/us/wa/seattle/landscaping.htm",
        "https://www.angi.com/companylist/us/wa/seattle/painting.htm",
        "https://www.angi.com/companylist/us/wa/seattle/plumbing.htm",
        "https://www.angi.com/companylist/us/wa/seattle/roofing.htm",
    ],
    "maxItems": 10,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/angies-list-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 '{
  "searchUrls": [
    "https://www.angi.com/companylist/us/az/phoenix/electrical.htm",
    "https://www.angi.com/companylist/us/az/phoenix/house-cleaning.htm",
    "https://www.angi.com/companylist/us/az/phoenix/hvac.htm",
    "https://www.angi.com/companylist/us/az/phoenix/landscaping.htm",
    "https://www.angi.com/companylist/us/az/phoenix/painting.htm",
    "https://www.angi.com/companylist/us/az/phoenix/plumbing.htm",
    "https://www.angi.com/companylist/us/az/phoenix/roofing.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/electrical.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/hvac.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/painting.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/los-angeles/roofing.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/electrical.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/hvac.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/painting.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/san-diego/roofing.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/electrical.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/hvac.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/painting.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/san-francisco/roofing.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/electrical.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/hvac.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/landscaping.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/painting.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/plumbing.htm",
    "https://www.angi.com/companylist/us/ca/san-jose/roofing.htm",
    "https://www.angi.com/companylist/us/co/denver/electrical.htm",
    "https://www.angi.com/companylist/us/co/denver/house-cleaning.htm",
    "https://www.angi.com/companylist/us/co/denver/hvac.htm",
    "https://www.angi.com/companylist/us/co/denver/landscaping.htm",
    "https://www.angi.com/companylist/us/co/denver/painting.htm",
    "https://www.angi.com/companylist/us/co/denver/plumbing.htm",
    "https://www.angi.com/companylist/us/co/denver/roofing.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/electrical.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/house-cleaning.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/hvac.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/landscaping.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/painting.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/plumbing.htm",
    "https://www.angi.com/companylist/us/fl/jacksonville/roofing.htm",
    "https://www.angi.com/companylist/us/il/chicago/electrical.htm",
    "https://www.angi.com/companylist/us/il/chicago/house-cleaning.htm",
    "https://www.angi.com/companylist/us/il/chicago/hvac.htm",
    "https://www.angi.com/companylist/us/il/chicago/landscaping.htm",
    "https://www.angi.com/companylist/us/il/chicago/painting.htm",
    "https://www.angi.com/companylist/us/il/chicago/plumbing.htm",
    "https://www.angi.com/companylist/us/il/chicago/roofing.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/electrical.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/house-cleaning.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/hvac.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/landscaping.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/painting.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/plumbing.htm",
    "https://www.angi.com/companylist/us/in/indianapolis/roofing.htm",
    "https://www.angi.com/companylist/us/ma/boston/electrical.htm",
    "https://www.angi.com/companylist/us/ma/boston/house-cleaning.htm",
    "https://www.angi.com/companylist/us/ma/boston/hvac.htm",
    "https://www.angi.com/companylist/us/ma/boston/landscaping.htm",
    "https://www.angi.com/companylist/us/ma/boston/painting.htm",
    "https://www.angi.com/companylist/us/ma/boston/plumbing.htm",
    "https://www.angi.com/companylist/us/ma/boston/roofing.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/electrical.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/house-cleaning.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/hvac.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/landscaping.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/painting.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/plumbing.htm",
    "https://www.angi.com/companylist/us/nc/charlotte/roofing.htm",
    "https://www.angi.com/companylist/us/oh/columbus/electrical.htm",
    "https://www.angi.com/companylist/us/oh/columbus/house-cleaning.htm",
    "https://www.angi.com/companylist/us/oh/columbus/hvac.htm",
    "https://www.angi.com/companylist/us/oh/columbus/landscaping.htm",
    "https://www.angi.com/companylist/us/oh/columbus/painting.htm",
    "https://www.angi.com/companylist/us/oh/columbus/plumbing.htm",
    "https://www.angi.com/companylist/us/oh/columbus/roofing.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/electrical.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/house-cleaning.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/hvac.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/landscaping.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/painting.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/plumbing.htm",
    "https://www.angi.com/companylist/us/pa/philadelphia/roofing.htm",
    "https://www.angi.com/companylist/us/tn/nashville/electrical.htm",
    "https://www.angi.com/companylist/us/tn/nashville/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tn/nashville/hvac.htm",
    "https://www.angi.com/companylist/us/tn/nashville/landscaping.htm",
    "https://www.angi.com/companylist/us/tn/nashville/painting.htm",
    "https://www.angi.com/companylist/us/tn/nashville/plumbing.htm",
    "https://www.angi.com/companylist/us/tn/nashville/roofing.htm",
    "https://www.angi.com/companylist/us/tx/austin/electrical.htm",
    "https://www.angi.com/companylist/us/tx/austin/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/austin/hvac.htm",
    "https://www.angi.com/companylist/us/tx/austin/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/austin/painting.htm",
    "https://www.angi.com/companylist/us/tx/austin/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/austin/roofing.htm",
    "https://www.angi.com/companylist/us/tx/dallas/electrical.htm",
    "https://www.angi.com/companylist/us/tx/dallas/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/dallas/hvac.htm",
    "https://www.angi.com/companylist/us/tx/dallas/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/dallas/painting.htm",
    "https://www.angi.com/companylist/us/tx/dallas/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/dallas/roofing.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/electrical.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/hvac.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/painting.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/fort-worth/roofing.htm",
    "https://www.angi.com/companylist/us/tx/houston/electrical.htm",
    "https://www.angi.com/companylist/us/tx/houston/house-cleaning.htm",
    "https://www.angi.com/companylist/us/tx/houston/hvac.htm",
    "https://www.angi.com/companylist/us/tx/houston/landscaping.htm",
    "https://www.angi.com/companylist/us/tx/houston/painting.htm",
    "https://www.angi.com/companylist/us/tx/houston/plumbing.htm",
    "https://www.angi.com/companylist/us/tx/houston/roofing.htm",
    "https://www.angi.com/companylist/us/wa/seattle/electrical.htm",
    "https://www.angi.com/companylist/us/wa/seattle/house-cleaning.htm",
    "https://www.angi.com/companylist/us/wa/seattle/hvac.htm",
    "https://www.angi.com/companylist/us/wa/seattle/landscaping.htm",
    "https://www.angi.com/companylist/us/wa/seattle/painting.htm",
    "https://www.angi.com/companylist/us/wa/seattle/plumbing.htm",
    "https://www.angi.com/companylist/us/wa/seattle/roofing.htm"
  ],
  "maxItems": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call parseforge/angies-list-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/angies-list-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Angi (Angie's List) Contractor & Reviews Scraper",
        "description": "Extract verified home service contractor profiles, ratings, reviews, services, addresses, and business hours from Angi (Angie's List). Used by contractors, insurance, and lead-gen teams.",
        "version": "1.0",
        "x-build-id": "YB4V5DQbEDmBJtltR"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~angies-list-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-angies-list-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/parseforge~angies-list-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-angies-list-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/parseforge~angies-list-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-angies-list-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",
                "properties": {
                    "searchUrls": {
                        "title": "Angi search URLs",
                        "type": "array",
                        "description": "One or more Angi listing URLs. Use a city + service URL (e.g. https://www.angi.com/companylist/us/ca/los-angeles/plumbers.htm), a state-wide service URL (https://www.angi.com/companylist/us/ny/electricians.htm), or a directory page (https://www.angi.com/companylist/us/tx/). The scraper visits each URL and aggregates contractor profiles.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000."
                    },
                    "fetchProfileDetails": {
                        "title": "Fetch full contractor profile details",
                        "type": "boolean",
                        "description": "When enabled the scraper visits each contractor's profile page to enrich records with description, address, phone, badges, and review highlights. Disable for a faster, listing-only run.",
                        "default": true
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Apify residential US proxy is recommended to bypass Cloudflare and DataDome challenges reliably."
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```