# 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:** [hiper soft](https://apify.com/hipersoft) (community)
- **Categories:** Lead generation, Other
- **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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

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

**Do I need any setup or a login?**
No setup and no login. Just add the actor, choose a category or paste a location URL, and run.

**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
}
```

# Actor output Schema

## `results` (type: `string`):

The scraped results as dataset items.

# 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/L1DlxQqh3gSkiXJ49/openapi.json