# Houzz Professional Scraper 🏠 (`easyapi/houzz-professional-scraper`) Actor

Scrape professional designers' profiles from Houzz.com, including their contact information, reviews, badges, and business details. Perfect for market research and lead generation in the home improvement industry.

- **URL**: https://apify.com/easyapi/houzz-professional-scraper.md
- **Developed by:** [EasyApi](https://apify.com/easyapi) (community)
- **Categories:** Lead generation, Jobs, Other
- **Stats:** 269 total users, 35 monthly users, 90.2% runs succeeded, 7 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

from $2.99 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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 Professional Scraper 🏠

Extract detailed information about professional home designers and contractors from Houzz.com. This actor helps you gather valuable data about home improvement professionals in specific locations.

### Features ✨

- 🎯 Search by location and professional type
- 📊 Get comprehensive business information
- 🏆 Extract professional badges and achievements
- 📍 Collect detailed contact information and addresses
- ⭐ Gather customer reviews and ratings
- 💼 Access business descriptions and specialties
- 📱 Retrieve social media and website links

### Output Data Structure 📋

The actor provides detailed information for each professional, including:

- Business contact details
- Physical location and service areas
- Professional certifications and badges
- Years in business
- Customer reviews and ratings
- Business descriptions
- Budget levels
- Specializations and services offered

### Use Cases 🎯

- Market research in the home improvement industry
- Lead generation for construction suppliers
- Competitive analysis for design firms
- Real estate market analysis
- Construction industry networking

### Input Parameters 🔧

- `searchUrls`: List of Houzz professional search URLs
- `maxItems`: Maximum number of results to collect
- `proxyConfiguration`: Optional proxy settings for better performance

### Output Example 📝

The actor provides data in JSON format, including comprehensive information about each professional listing. See the API tab for a detailed output example.

### Limitations ⚠️

- Respect Houzz.com's terms of service and fair usage policy
- Rate limiting may apply

#### Input Example

A full explanation of an input example in JSON.

```json
{
    "searchUrls": [
        "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"
    ],
    "maxItems": 30
}
```

#### Output sample

The results will be wrapped into a dataset which you can always find in the **Storage** tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

```json
[
    {
        "searchUrl": "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398",
        "scrapedAt": "2025-02-02T03:27:56.886Z",
        "professional": {
            "userId": 64904,
            "professionalId": 8960,
            "formattedAddress": "512 N. Main St.<br/>Glen Ellyn, IL 60137",
            "formattedPhone": "(630) 556-8881",
            "aboutMe": "Since 1987, Drury Design has been at the forefront of luxury home remodeling, bringing an artistic touch to Chicagoland homes. \r\n\r\nDrury Design's talented staff of professional designers assist individual homeowners with their plan, and create ideal spaces in a broad range of budgets with a client-focused design™ approach, expert installation, and project management services.\r\n\r\nLocated in suburban Glen Ellyn, 25 miles west of Chicago, Drury Design serves Chicago area clients with custom kitchen, bathroom and other design and remodeling projects. The 8,500 sq. ft. design studio features full-size room vignettes featuring a multitude of on-trend design styles and materials for inspiration and reference.\r\n\r\nDrury Design’s artistic home design projects grace thousands of Chicago-area homes and have earned the acclaim of both clients, design peers and the press.  Drury Design has been honored with over 80 kitchen and bath design honors since 1998.\r\n\r\nContact us to schedule a no-obligation design consultation in your home to discuss your upcoming kitchen, bath or other room projects.  Large or small, remodel or new home - we'd love to hear about your project goals.",
            "proTypeDisplayName": "Kitchen & Bath Designers",
            "location": "Glen Ellyn, IL",
            "proType": 8,
            "address": "512 N. Main St. ",
            "city": "Glen Ellyn",
            "state": "IL",
            "zip": "60137",
            "country": "US",
            "seoHint": {
                "paths": {
                    "ViewProfessional": {
                        "command": "professionals",
                        "extraSlugs": "kitchen-and-bath-designers",
                        "titleSlug": "drury-design",
                        "seoPageType": "pfvwus",
                        "indexing": true
                    }
                }
            },
            "latitude": 41.8661,
            "longitude": -88.0648,
            "highlightBadges": {
                "profileBadges": [
                    {
                        "id": 1000,
                        "title": "Best of Houzz winner",
                        "shortTitle": "Best of Houzz winner",
                        "titleWithValue": "Best of Houzz winner",
                        "description": "The annual Best of Houzz Award recognizes the top-rated & top-contributing home pros around the world.",
                        "selfDescription": "The annual Best of Houzz Award recognizes the top-rated & top-contributing home pros around the world.",
                        "type": 16,
                        "cta": "",
                        "modified": "2021-08-17 14:12:42",
                        "awardedOnDate": "1629234762",
                        "imageNames": [
                            "badge1"
                        ]
                    },
                    {
                        "id": 1011,
                        "title": "Woman owned",
                        "shortTitle": "Woman owned",
                        "titleWithValue": "Woman owned",
                        "description": "This business is proud to be woman owned and operated.",
                        "selfDescription": "This business is proud to be woman owned and operated.",
                        "type": 16,
                        "cta": "",
                        "modified": "2021-08-17 14:12:41",
                        "awardedOnDate": "1629234761",
                        "imageNames": [
                            "female_symbol"
                        ],
                        "value": 0
                    },
                    {
                        "id": 1134,
                        "title": "34 years in business",
                        "shortTitle": "34 years in business",
                        "titleWithValue": "34 years in business",
                        "description": "This business has highlighted the number of years that they have been in continuous operation.",
                        "selfDescription": "This business has highlighted the number of years that they have been in continuous operation.",
                        "type": 16,
                        "cta": "",
                        "modified": "2021-08-17 14:12:43",
                        "awardedOnDate": "1629234763",
                        "imageNames": [
                            "birthday_cake"
                        ],
                        "value": 0
                    }
                ],
                "directoryBadge": {
                    "id": 1000,
                    "title": "Best of Houzz winner",
                    "shortTitle": "Best of Houzz winner",
                    "titleWithValue": "Best of Houzz winner",
                    "description": "The annual Best of Houzz Award recognizes the top-rated & top-contributing home pros around the world.",
                    "selfDescription": "The annual Best of Houzz Award recognizes the top-rated & top-contributing home pros around the world.",
                    "type": 16,
                    "cta": "",
                    "modified": "2021-08-17 14:12:42",
                    "awardedOnDate": "1629234762",
                    "imageNames": [
                        "badge1"
                    ]
                }
            },
            "isSponsoredResult": false,
            "distance": 22.864918297706826,
            "localProjectCount": 22,
            "isVideoConsultationEnabled": false,
            "budgetLevels": [
                "1v3",
                "1v4"
            ],
            "proDirectoryCardSetting": {
                "showHighlightVideo": true,
                "budgetLevels": [
                    "1v3",
                    "1v4"
                ],
                "badgeSettings": [
                    {
                        "badgeOptionId": 4000,
                        "presentableMinValue": -1
                    },
                    {
                        "badgeOptionId": 4001,
                        "presentableMinValue": -1
                    }
                ],
                "badgeSettingsMap": {
                    "4000": {
                        "presentableMinValue": -1
                    },
                    "4001": {
                        "presentableMinValue": -1
                    }
                }
            },
            "webProTrackInfo": {
                "profileClk": {
                    "method": "GET",
                    "protocol": "https",
                    "domain": "www.houzz.com",
                    "path": "/hsc/aetrk/k=HBkcFQYVGhbymPf5DBgKMTQzNTc1MjY1MigkYmYyZDljYjEtY2MyMy00NGU0LWJhN2UtM2FiMjBkY2I2M2JkEhgPMTI0LjE2Ny4xNDYuMjI0GAMvQ04ZCBUAaAMxMDFYBTY0OTA0FQQVBBUCOF9odHRwczovL3d3dy5ob3V6ei5jb20vcHJvZmVzc2lvbmFscy9raXRjaGVuLWFuZC1iYXRoLWRlc2lnbmVycy9kcnVyeS1kZXNpZ24tcGZ2d3VzLXBmfjc4ODYyNzA0NAhgP2MyLXRocmlmdC1tYWluLWdwcm9kdWN0aW9uMjAyNTAxMzExMjAzNDJkZTcxMjU5LTU3ZDc5YzdjZGYyOWYyZxgkMDJmNjdhOTMtYjY5Yy00NzY5LTlhY2YtNGM0Mzk3MTk5ZDg1wgAAAA"
                }
            },
            "mostRecentReview": {
                "body": "Ten years after  they completed my ktichen-bath remodel, the Drury team helped me resolve some minor maintenance issues promptly and courteously! Within a week, their finishing specialist, Dave Honquest ,was repairing the finish on a kitchen cabinet. Rick stopped by the house to  pull out a referigerator that over time travelled too far back in its cabinet. None of the local appliance dealers would help with a task so small. Basia Kozub, designer, kept the communication flowing. It's timely communication, attention to detail, and quick action that make Drury Design the best firm to use for your design/installation project!",
                "user": {
                    "userName": "webuser_192562756",
                    "displayName": "Cynthia Heidorn"
                }
            },
            "hasVerifiedLicense": false,
            "hasVerifiedKyc": false,
            "isInactivePro": false,
            "numReviews": 87,
            "reviewRating": 49,
            "featuredReview": {
                "text": "We used Drury Design for a kitchen & powder room remodel with 5 star results.",
                "rawReview": {
                    "user": {
                        "userName": "karenaperville",
                        "displayName": "karenaperville"
                    }
                }
            },
            "proSkuId": 37
        }
    },
    ...
]
```

### Related Actors

- 🏠 [Houzz Products Scraper](https://apify.com/easyapi/houzz-products-scraper) - Extract product listings from Houzz.com including prices, descriptions, reviews, and images.
- 🏠 [Houzz Product Reviews Scraper](https://apify.com/easyapi/houzz-product-reviews-scraper) - Scrape product reviews from Houzz.com with detailed review data and user information.
- 🏠 [Realtor.com Scraper](https://apify.com/easyapi/realtor-com-scraper) - Extract comprehensive real estate listings data from Realtor.com.
- 🏠 [Realtor.com Agent Scraper](https://apify.com/easyapi/realtor-com-agent-scraper) - Scrape real estate agent profiles with contact details and performance metrics.
- 🏠 [Rightmove Property Search Scraper](https://apify.com/easyapi/rightmove-property-search-scraper) - Extract detailed property listings from UK's leading property website.
- 🏠 [Funda.nl Scraper](https://apify.com/easyapi/funda-nl-scraper) - Scrape property listings with detailed real estate data from Netherlands.
- 🏠 [Trulia Property Scraper](https://apify.com/easyapi/trulia-property-scraper) - Extract real estate listings with property details and agent information.
- 🏠 [99acres.com Scraper](https://apify.com/easyapi/99acres-com-scraper) - Scrape property listings from India's leading real estate portal.
- 🏠 [Housing.com Scraper](https://apify.com/easyapi/housing-com-scraper) - Extract detailed property information from Housing.com.
- 🏠 [VRBO Property Listing Scraper](https://apify.com/easyapi/vrbo-property-listing-scraper) - Scrape vacation rental listings with detailed property information.
- 🛍️ [Wayfair Product Scraper](https://apify.com/easyapi/wayfair-product-scraper) - Extract detailed product data from Wayfair's home furniture marketplace.
- 👨‍⚕️ [WebMD Doctor Scraper](https://apify.com/easyapi/webmd-doctor-scraper) - Scrape detailed professional profiles with ratings and reviews.
- 🏥 [Practo Doctor Scraper](https://apify.com/easyapi/practo-doctor-scraper) - Extract comprehensive doctor profiles with qualifications and services.
- 🔍 [BBB Business Directory Scraper](https://apify.com/easyapi/bbb-business-directory-scraper) - Scrape business listings with ratings and accreditation status.
- 📊 [URL Metadata Crawler](https://apify.com/easyapi/url-metadata-crawler) - Extract comprehensive metadata from business web pages.

# Actor input Schema

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

List of Houzz professional search URLs to scrape

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

Maximum number of professionals to scrape

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

Proxy settings for the scraper

## Actor input object example

```json
{
  "searchUrls": [
    "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"
  ],
  "maxItems": 30,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# 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.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"
    ],
    "maxItems": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("easyapi/houzz-professional-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.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"],
    "maxItems": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("easyapi/houzz-professional-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 '{
  "searchUrls": [
    "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"
  ],
  "maxItems": 30
}' |
apify call easyapi/houzz-professional-scraper --silent --output-dataset

```

## MCP server setup

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