# Angi Scraper: Contractors, Reviews & Cost Guides (`datascraperes/angi-scraper`) Actor

Find Angi home-service contractors by service and US ZIP code. Export business profiles, phones, ratings and public reviews, or collect local and national cost estimates with guide articles. Includes service search and category discovery.

- **URL**: https://apify.com/datascraperes/angi-scraper.md
- **Developed by:** [DataScraperES](https://apify.com/datascraperes) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.88 / 1,000 angi records

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Angi Scraper collects **contractor profiles, public reviews and cost guides**. Enter an exact service such as Plumbing and a US ZIP code to receive structured business profiles, or select a dedicated review, search or cost-guide mode.

### What this Actor does

Find professionals serving a ZIP code and collect public business profiles and service categories. Attach a limited set of reviews to each profile, export reviews as separate rows, or collect local and national home-service costs with the corresponding guide article.

Search mode finds service category and task IDs. Categories mode returns service categories. Direct profile and review modes accept numeric professional IDs from a previous professional search.

### Use cases

- Build a contractor research list with business phone, address, services and ratings when available.
- Compare public customer feedback for selected professionals.
- Research local home-service costs alongside national guide data.
- Resolve service names into category and task selectors.

### How to use

1. Select **Find professionals**.
2. Enter **Plumbing**, ZIP **78701**, and a small maximum record count.
3. Start the Actor and open its Dataset. Check the summary if collection ends incomplete.

Quick start:

```json
{
  "mode": "pros",
  "query": "Plumbing",
  "zipCode": "78701",
  "maxItems": 2
}
```

### Input

Select one mode per run. `maxItems` defaults to 20 and accepts 1–500 rows. This is a run safety limit, not a promise that every requested count is available.

For a normal professional search, choose **Find professionals**, enter **Service name** and **US ZIP code**, and leave the optional sections unchanged. The result limit already has a default. No field is globally mandatory in the form; the selected collection mode determines which information is needed.

**Profiles and standalone reviews** has an individual numeric entry for each professional ID, so you do not need to write JSON. Use it only for Profiles or Reviews and clear Service name. **Review options** controls attached or standalone reviews. **Advanced service selection** is optional: most users can leave it empty and use a service name instead. These sections can be collapsed.

```json
{
  "mode": "pros",
  "query": "Plumbing",
  "zipCode": "78701",
  "maxItems": 2,
  "proIds": [],
  "categoryId": null,
  "taskId": null,
  "includeReviews": false,
  "maxReviews": 2
}
```

| Field | Behavior |
|---|---|
| `mode` | `pros`, `profiles`, `reviews`, `costGuides`, `search` or `categories`. |
| `query` | Exact service name for pros; service phrase for search or cost guides. Leave empty when using an ID. |
| `zipCode` | Five-digit US ZIP; defaults to 78701. Used for service coverage, review sorting and local costs. |
| `maxItems` | Maximum Dataset rows across this run. Defaults to 20; range 1–500 rows. |
| `proIds` | Up to 50 numeric IDs from `data.proId`; required for profiles and reviews. Duplicates are removed. |
| `categoryId` | Advanced pros selector from search. Negative values are valid. Use instead of query or taskId. |
| `taskId` | Advanced pros or costGuides selector from search. A service task ID, not a cost-guide ID. |
| `includeReviews` | Attach reviews in pros or profiles mode. Defaults to false. |
| `maxReviews` | Maximum reviews per professional; defaults to 20, range 1–500 results per professional. Standalone rows also respect maxItems. |

Clear selectors that do not belong to the selected mode. An ambiguous professional service phrase stops with guidance to use search and choose an ID. Search returns the source's available suggestions, up to 20. Cost-guide phrase searches process returned service tasks and deduplicate guides by guide ID and ZIP.

### Output

Each Dataset row contains `recordId`, `recordType`, `retrievedAt` and `data`. Row types are `pro`, `review`, `costGuide`, `searchResult` and `category`. Export JSON, CSV or Excel; JSON preserves nested services, reviews and cost data.

A professional includes its ID, name, overview, address, phone, rating, review count, services, coordinates and available profile link. Attached reviews include `reviewsTotal` and `reviewsTruncated` to distinguish a subset from all available reviews. Missing source fields remain null; reviews are an empty array when attachment is disabled.

A standalone review contains its ID, professional ID, rating, text, date, task, cost and coarse city/state when available. A cost guide contains the service task, ZIP, guide ID, name, local range, local/national data, article and related tasks. Estimates are not binding quotes.

Complete professional example from the quick-start run:

```json
{
  "recordId": "pro:158861273",
  "recordType": "pro",
  "retrievedAt": "2026-11-13T16:38:55.113249+00:00",
  "data": {
    "proId": 158861273,
    "name": "Cold is on the Right Plumbing",
    "description": "We're Committed. Cold is on the Right Plumbing is a service based plumbing provider that is committed to you and your home or business. Growing up in the plumbing trade has allowed us to have the liberty to work with some of the best (and worst!) tradespeople in the industry. When we decided to open the doors to the Cedar Park and Austin and Lakeway communities it was under the belief that we could adapt everything learned over the years to provide a more meaningful and helpful experience to our customers.",
    "profileUrl": "https://www.angi.com/companylist/us/tx/austin/cold-is-on-the-right-plumbing-reviews-6526384.htm",
    "legacyProfilePath": "/rated.coldisontherightplumbing.158861273.html",
    "rating": "0.0",
    "reviewCount": "0",
    "address": {
      "address1": "PO Box 341505",
      "address2": "",
      "city": "Austin",
      "state": "TX",
      "zip": "78734"
    },
    "phone": "5127628243",
    "latitude": 30.3763,
    "longitude": -97.9464,
    "spanishSpeaking": false,
    "isCorporate": false,
    "isSponsored": true,
    "logoUrl": "https://cdn.homeadvisor.com/files/eid/158860000/158861273/20433170_original.jpg",
    "services": [
      {
        "categoryOid": -14820,
        "name": "Solar",
        "urlName": "Solar"
      },
      {
        "categoryOid": -12058,
        "name": "Plumbing",
        "urlName": "Plumbing"
      },
      {
        "categoryOid": -12077,
        "name": "Water Treatment System",
        "urlName": "Water-Treatment-System"
      }
    ],
    "reviews": [],
    "reviewsTotal": null,
    "reviewsTruncated": false
  }
}
```

If an input needs correction, the run ends normally and the log shows a warning naming the field and how to fix it. The summary records `invalid_input` and `complete: false`; it does not claim a completed collection. Unavailable selections and ambiguous services follow the same correction flow. Previously delivered records remain available, and correction notices do not create billable records.

Apify also checks the input form before starting a run. If it rejects a value there, correct the highlighted field and try again; the Actor has not started yet and cannot write a run log. Enter service names rather than page URLs, and use numeric professional IDs from this Actor's results.

The run summary reports completion and delivered rows. A run can retain useful Dataset rows while remaining incomplete; check its summary before treating an export as exhaustive.

### Pricing

This Actor uses pay-per-event pricing. Check the **Pricing** tab for the current configuration before running.

| Apify tier | Price per record (USD) | Equivalent per 1,000 records (USD) |
|---|---:|---:|
| FREE | 0.0025 | 2.50 |
| BRONZE | 0.00225 | 2.25 |
| SILVER | 0.002 | 2.00 |
| GOLD | 0.001875 | 1.875 |
| PLATINUM | 0.001875 | 1.875 |
| DIAMOND | 0.001875 | 1.875 |

One billable record is one unique Dataset row delivered and verified. Attached reviews are included in their professional record; each standalone review is a separate record. A guide, service search result or category is also one record. There is no start fee or attached-review supplement; platform usage during collection is included. Duplicate identities, input correction reports and summaries do not create result events. Usage after a run, such as reading stored data, follows Apify's platform pricing.

### Related Actors

| Actor | Best for |
|---|---|
| [Google Maps Business Scraper | $1 per 1,000](https://apify.com/datascraperes/actor-google-maps) | Find businesses across locations and compare them with your Angi research. |
| [Trustpilot Reviews Scraper | Business Data](https://apify.com/datascraperes/trustpilot-reviews-scraper) | Research company reputation and feedback on Trustpilot. |

### Limits and data quality

Coverage is limited to public US source data. Professionals may serve the requested ZIP while being based in another city. Rankings, availability, ratings, costs and review totals can change during collection. Use professional IDs returned by this Actor; numbers embedded in unrelated Angi page URLs are not interchangeable.

Temporary source restrictions, unavailable targets or collection safeguards can leave a run incomplete. Delivered records remain available. The Actor does not collect logged-in account data or perform bookings. Consumer names, consumer ZIP codes and contact emails are excluded. Review text is preserved as published and may itself contain personal information.

### Frequently asked questions

#### Can I paste an Angi page URL?

Use an exact service and ZIP, or professional IDs from its output. Arbitrary page URLs are not supported.

#### Can I export more than one page of reviews?

Yes. Reviews continue across available pages until the selected limits or reported end. A page that cannot be verified leaves the run incomplete.

#### Are cost estimates guaranteed prices?

No. Availability varies by task and ZIP. Estimates may include regional or national data.

### Responsible use

Use data in accordance with applicable source terms and laws. Review exports before sharing customer feedback and respect privacy and intellectual property requirements.

### Support

Open an issue in the Actor's **Issues** tab with your input and run ID. Remove sensitive information before sharing a reproduction.

Integration examples and CSV workflows: [GitHub repository](https://github.com/datacrawler-edu/angi-scraper-python).

# Actor input Schema

## `mode` (type: `string`):

Start with Find professionals. Choose Profiles or Reviews only when you already have professional IDs from a previous result. Other settings are optional unless the selected mode needs them.

## `query` (type: `string`):

For Find professionals, Cost guides or Find services, enter a service such as Plumbing. Leave blank for Profiles, Reviews and Categories. If you use an advanced service ID, clear this field.

## `zipCode` (type: `string`):

Used for professional searches, review ordering and local cost guides. Keep the default or enter a five-digit US ZIP. Not needed for service search or categories.

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

Leave the default to collect up to 20 results. A professional with attached reviews counts as one result; standalone reviews count separately.

## `proIds` (type: `array`):

Add one numeric ID per entry. Copy proId from a Find professionals result. No JSON is needed. Leave this list empty for other collection modes.

## `includeReviews` (type: `boolean`):

Turn on only for Find professionals or Profiles. Keep off for standalone Reviews, Cost guides, Find services and Categories.

## `maxReviews` (type: `integer`):

Used when attaching reviews or collecting standalone Reviews. Default: 20. Maximum results still caps the total number of standalone review rows.

## `categoryId` (type: `integer`):

For Find professionals only. Use a nonzero category ID from Find services; negative IDs are valid. Clear Service name and leave Task ID blank.

## `taskId` (type: `integer`):

For Find professionals or Cost guides. Use a task ID from Find services, not a cost-guide ID. Clear Service name and leave Category ID blank.

## Actor input object example

```json
{
  "mode": "pros",
  "query": "Plumbing",
  "zipCode": "78701",
  "maxItems": 2,
  "proIds": [],
  "includeReviews": false,
  "maxReviews": 2
}
```

# Actor output Schema

## `dataset` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 = {
    "mode": "pros",
    "query": "Plumbing",
    "zipCode": "78701",
    "maxItems": 2,
    "proIds": [],
    "includeReviews": false,
    "maxReviews": 2
};

// Run the Actor and wait for it to finish
const run = await client.actor("datascraperes/angi-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 = {
    "mode": "pros",
    "query": "Plumbing",
    "zipCode": "78701",
    "maxItems": 2,
    "proIds": [],
    "includeReviews": False,
    "maxReviews": 2,
}

# Run the Actor and wait for it to finish
run = client.actor("datascraperes/angi-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "pros",
  "query": "Plumbing",
  "zipCode": "78701",
  "maxItems": 2,
  "proIds": [],
  "includeReviews": false,
  "maxReviews": 2
}' |
apify call datascraperes/angi-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datascraperes/angi-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HcGrT8BPf54Eugdiv/builds/eMzHZDlFpIKEa2202/openapi.json
