# Houzz Professionals Scraper — Contractors & Designers (`hipersoft/houzz-scraper`) Actor

Scrape Houzz home-improvement professionals: business name, phone, address, area served, image and profile URL. By category or Houzz search URL. No setup.

- **URL**: https://apify.com/hipersoft/houzz-scraper.md
- **Developed by:** [Hipersoft](https://apify.com/hipersoft) (community)
- **Categories:** Lead generation, Other
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0015 / professional scraped

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

## Houzz Professionals Scraper — Contractors, Architects & Designers

Scrape **Houzz professionals** — home-improvement contractors, architects, interior designers, remodelers and more — into clean JSON, CSV, Excel or XML. Extract **business name, phone, full address, area served, image and profile URL** for pros in any category or location. Fast and reliable.

![Houzz Professionals Scraper input — category, startUrls and maxItems in the Apify Console](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/houzz-scraper-input.png)

### What does Houzz Professionals Scraper do?

The Houzz Professionals Scraper crawls Houzz professional listings and extracts every pro as a structured record. Choose a professional category or paste a location-specific Houzz search URL, and it exports a clean dataset of contractors, architects and designers with their phone numbers, addresses and service areas — an easy way to build home-services lead and outreach lists.

### What data can you scrape from Houzz?

| Data | Fields |
| --- | --- |
| 🏗️ Business | name, Houzz profile URL, logo/image |
| ☎️ Phone | contact telephone number |
| 📍 Address | street, city, region, postal code, country |
| 🗺️ Coverage | area served |
| 🕒 Meta | source listing URL, collected timestamp |

### Use cases

- **B2B lead generation** — build phone and address lists of contractors, architects and designers by category and location.
- **Home-services outreach** — reach remodelers, builders and landscapers for partnerships or sales.
- **Market research** — measure the density of pros by trade and region.
- **Competitor mapping** — see who operates in a location and what areas they serve.
- **CRM enrichment** — append addresses, phone numbers and service areas to existing records.
- **Supplier & referral sourcing** — find qualified pros by service focus for referrals or hiring.

### How to scrape Houzz data

1. Add the **Houzz Professionals Scraper** to your Apify account.
2. Choose a **category**, or paste a location-specific Houzz search URL into **startUrls**.
3. Set **maxItems** to cap how many professionals you collect.
4. Click **Run** and watch results stream into the dataset.
5. Export to JSON, CSV, Excel or XML, or pull them through the Apify API.

### Input

Pick a professional category, or paste a location-specific Houzz search URL for deeper location pulls. Cap the run with `maxItems`.

#### Example input

```json
{ "startUrls": ["https://www.houzz.com/professionals/general-contractor/new-york-ny-us-probr0-bo~t_11786~r_5128581"], "maxItems": 500 }
```

Or by category:

```json
{ "category": "interior-designer", "maxItems": 100 }
```

| Field | Description |
| --- | --- |
| `category` | Professional category slug, e.g. `general-contractor`, `architect`, `interior-designer`, `kitchen-and-bathroom-remodeler`. |
| `startUrls` | Houzz professionals search URLs copied from houzz.com for a specific location. Overrides `category`. |
| `maxItems` | Maximum number of professionals to return. |

### Output

Each professional is one clean record:

```json
{
  "id": "693469015",
  "name": "G D Builders & Design Corp.",
  "telephone": "(718) 414-4589",
  "streetAddress": "1545 White Plains Rd.",
  "city": "Bronx",
  "region": "NY",
  "postalCode": "10462",
  "country": "US",
  "areaServed": "New York",
  "image": "https://st.hzcdn.com/profiles/logos/693469015.jpg",
  "url": "https://www.houzz.com/professionals/general-contractors/g-d-builders-and-design-corp-pf~693469015",
  "sourceUrl": "https://www.houzz.com/professionals/general-contractor/new-york-ny-us-probr0-bo~t_11786~r_5128581",
  "collectedAt": "2026-07-30T12:00:00.000Z"
}
```

![Houzz Professionals Scraper output example — business name, phone and address as structured JSON](https://api.apify.com/v2/key-value-stores/SUfvnaFLd9z9eBCtV/records/houzz-scraper-output.png?v=1)

#### Output schema

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Unique Houzz professional identifier. |
| `name` | string | Business or professional name. |
| `telephone` | string | Contact phone number (the key lead field). |
| `streetAddress` | string | Street address of the business. |
| `city` | string | City where the business is located. |
| `region` | string | State or region code. |
| `postalCode` | string | Postal or ZIP code. |
| `country` | string | Country code. |
| `areaServed` | string | Geographic area the professional serves. |
| `image` | string (URL) | Profile logo or image URL. |
| `url` | string (URL) | Houzz profile page URL. |
| `sourceUrl` | string (URL) | Search listing page the record was collected from. |
| `collectedAt` | string (ISO date) | Timestamp when the record was scraped. |

### Need more local leads data?

- [GoodFirms Scraper](https://apify.com/hipersoft/goodfirms-scraper) — B2B agencies with ratings, reviews and pricing.
- [Google Maps Scraper](https://apify.com/hipersoft/google-maps-scraper) — local businesses, ratings and contact info.
- [BBB Scraper](https://apify.com/hipersoft/bbb-scraper) — Better Business Bureau company profiles and ratings.
- [Website Contact Scraper](https://apify.com/hipersoft/website-contact-scraper) — emails, phones and socials from any website.

### FAQ

**How many professionals can I scrape?**
As many as the listings contain — set `maxItems` to cap the run, or leave it open to collect an entire category or location.

**How does billing work?**
You pay only per professional you get — no subscription. Our per-item price floors 20% below the cheapest comparable scraper.

**What export formats are supported?**
JSON, CSV, Excel and XML, plus the Apify API for programmatic access.

**Can I scrape a specific location?**
Yes — paste the Houzz professionals search URL for that location into `startUrls` for the deepest location-specific pulls.

**How fresh is the data?**
Each run fetches live listings, so results reflect Houzz at the moment you run the actor. The `collectedAt` field timestamps every record.

**Is it legal?**
The actor returns only publicly available data. You are responsible for complying with Houzz's terms and applicable data and marketing laws.

**Can I connect it to my other tools?**
The Houzz Professionals Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JavaScript/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

### Related Actors

- [Europages Scraper](https://apify.com/hipersoft/europages-scraper) — European B2B suppliers and manufacturers.
- [Google Maps Reviews Scraper](https://apify.com/hipersoft/google-maps-reviews-scraper) — reviews and ratings for local businesses.
- [GoodFirms Scraper](https://apify.com/hipersoft/goodfirms-scraper) — agencies and software companies.

### Notes

Original clean-room implementation. Returns only public data; you are responsible for compliance with Houzz's terms. Not affiliated with Houzz.

# Actor input Schema

## `category` (type: `string`):

Professional category slug, e.g. general-contractor, architect, interior-designer, kitchen-and-bathroom-remodeler, home-builder, landscape-contractor. Used when no startUrls given.

## `startUrls` (type: `array`):

Optional Houzz professionals search URLs (copy from houzz.com for a specific location). Overrides category.

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

Maximum professionals to scrape.

## Actor input object example

```json
{
  "category": "general-contractor",
  "startUrls": [],
  "maxItems": 200
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/houzz-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 = {}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/houzz-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 '{}' |
apify call hipersoft/houzz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/houzz-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/VkKxIF9hjHfDhS4jn/builds/RuQZJpjIPSRUvanlo/openapi.json