# Houzz Lead Extractor (Cheapest Extractor) (`ahmed_jasarevic/houzz-professionals-scraper`) Actor
Fast Houzz scraper that extracts professional profiles by parsing embedded JSON (ProfessionalStore) from search pages. Handles pagination, proxy rotation, and anti-bot protections.
- **URL**: https://apify.com/ahmed\_jasarevic/houzz-professionals-scraper.md
- **Developed by:** [Ahmed Jasarevic](https://apify.com/ahmed_jasarevic) (community)
- **Categories:** Lead generation, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $2.50 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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
---
## Houzz Professionals Scraper (JSON Extractor)
🚀 High-performance Houzz scraper that extracts professional profiles directly from embedded JSON data (ProfessionalStore), bypassing heavy frontend rendering.
Designed for **lead generation, market research, and automation workflows**.
---
### ✨ Features
- ⚡ Fast scraping via internal JSON (no heavy DOM parsing)
- 🔄 Automatic pagination support
- 🛡️ Anti-block handling (session rotation + proxy support)
- 🌍 Works with search URLs across locations & categories
- 📦 Clean structured output (ready for CSV / CRM / outreach)
---
### 📥 Input
Provide one or more Houzz search URLs.
#### Example input:
```json
{
"startUrls": [
"https://www.houzz.com/professionals/home-builders/c/Los-Angeles--CA"
],
"maxItems": 50,
"maxConcurrency": 3
}
````
#### Input fields
| Field | Type | Description |
| ---------------- | ------ | --------------------------------------------------- |
| `startUrls` | Array | List of Houzz search URLs |
| `maxItems` | Number | Maximum number of professionals to scrape |
| `maxConcurrency` | Number | Parallel requests (recommended: 2–5) |
| `proxy` | Object | Proxy configuration (Apify Residential recommended) |
***
### 📤 Output
The Actor returns a dataset of scraped professionals.
#### Example output item:
```json
{
"searchUrl": "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398",
"scrapedAt": "2026-05-01T08:59:47.587Z",
"professional": {
"userId": 2331,
"professionalId": 2520,
"formattedAddress": "945 Elm St.
Winnetka, IL 60093",
"formattedPhone": "(773) 345-9503",
"aboutMe": "Inspired Interiors is a full-service interior design and architecture firm based in Winnetka, on Chicago’s North Shore. Led by award-winning designer Emily Mackie, we specialize in designing, building, and furnishing custom spaces that are both functional and beautiful.\r\n\r\nAt Inspired Interiors, we believe in “the art of living”—creating immersive environments that elevate everyday life. Our holistic approach blends architecture, interiors, and curated furnishings to bring each client’s unique vision to life.\r\n\r\nSince 2020, we’ve embraced a refined virtual design process, ensuring a seamless, high-touch experience no matter where you are. Whether working locally or remotely, our dedicated team delivers creative, customized solutions with precision and expertise.\r\n\r\nOur work has been featured in Entrepreneur, Forbes, The Chicago Tribune, Modern Luxury Interiors, Crain’s Chicago Business, and more, solidifying our reputation as a leader in luxury design.\r\n\r\nWelcome to Inspired Interiors—where every space tells a story, and design, build, furnish come together to create something extraordinary.",
"proTypeDisplayName": "Design-Build Firms",
"location": "Winnetka, IL",
"proType": 11,
"address": "945 Elm St. ",
"city": "Winnetka",
"state": "IL",
"zip": "60093",
"country": "US",
"seoHint": {
"paths": {
"ViewProfessional": {
"command": "professionals",
"extraSlugs": "design-build-firms",
"titleSlug": "inspired-interiors-design-build-furnish",
"seoPageType": "pfvwus",
"indexing": true
}
}
},
"latitude": 42.1054,
"longitude": -87.7535,
"highlightBadges": {
"meritProfileBadges": [
{
"id": 4000,
"title": "Hired on Houzz",
"shortTitle": "Hired on Houzz",
"titleWithValue": "4 Hires on Houzz",
"description": "The number of homeowners who contacted a pro through Houzz and then hired that pro for a project.",
"selfDescription": "The number of homeowners who contacted a pro through Houzz and then hired that pro for a project.",
"type": 11,
"cta": "",
"modified": "2026-02-13 21:36:24",
"awardedOnDate": "1771047384",
"imageNames": [
"handshake"
],
"value": 4
},
{
"id": 4004,
"title": "Responds Quickly",
"shortTitle": "Responds Quickly",
"titleWithValue": "Responds Quickly",
"description": "Show pros who typically respond in the same day",
"selfDescription": "Show pros who typically respond in the same day",
"type": 11,
"cta": "",
"modified": "2026-02-28 12:07:19",
"awardedOnDate": "1772309239",
"imageNames": [
"timer"
]
}
],
"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": "2025-02-14 05:43:25",
"awardedOnDate": "1739540605",
"imageNames": [
"badge1"
]
},
{
"id": 1016,
"title": "High-end",
"shortTitle": "High-end",
"titleWithValue": "High-end",
"description": "This business has self-identified as specializing in luxury craftsmanship.",
"selfDescription": "This business has self-identified as specializing in luxury craftsmanship.",
"type": 16,
"cta": "",
"modified": "2025-02-14 05:43:26",
"awardedOnDate": "1739540606",
"imageNames": [
"diamond"
],
"value": 0
},
{
"id": 1121,
"title": "21 years in business",
"shortTitle": "21 years in business",
"titleWithValue": "21 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": "2025-02-14 05:43:27",
"awardedOnDate": "1739540607",
"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": "2025-02-14 05:43:25",
"awardedOnDate": "1739540605",
"imageNames": [
"badge1"
]
}
},
"isSponsoredResult": false,
"distance": 15.891670347951258,
"localProjectCount": 29,
"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=HBkcFQYVGhaCrqOfDRgKMTg0MjM1MjE4MygkMjYyN2Y0OTQtMDI3OC00Y2RiLWI0NWMtMDg0ZjI5MWQ5YjYxEhgOMTgxLjEyMy4xOC4yMjcYEi9QWS8xLy9Db25jZXBjacOzbhkIFQBoAzEwMVgEMjMzMRUEFQQVAjhyaHR0cHM6Ly93d3cuaG91enouY29tL3Byb2Zlc3Npb25hbHMvZGVzaWduLWJ1aWxkLWZpcm1zL2luc3BpcmVkLWludGVyaW9ycy1kZXNpZ24tYnVpbGQtZnVybmlzaC1wZnZ3dXMtcGZ-MTUxMDg5NDU1CGA_YzItdGhyaWZ0LW1haW4tMnBrZ3JlbGVhc2UyMDI2MDQyOTIzMzUwOTQwZDU5ZWUtNjU2NDRiOWY1OHY2cGJxGCQwNWUyYzMyMy0xNjFlLTRlZjctOWYwNi1lNTkxMWRiNWUzZWbCAAAA"
}
},
"mostRecentReview": {
"body": "Emily and her team at Inspired Interiors were great. Her team was professional, punctual, thoughtful, responsive, respectful about budget, and remarkably creative. We re-did our mud room, foyer, sitting room, and dining room and they all look wonderful. It was a double win: we now have functional rooms that still look nice enough to be in a magazine.\n\nHer team was great not only during the high points, but even when things were not perfect for events that were out of their control. If there was a delivery delay by a vendor, we knew immediately once the problem came up with a detailed plan to work around that delay. Every step of the way, Emily and her team kept us informed and we never had to worry about the quality of the work or of the furniture we bought. She stood behind all of it and it shows in the final product.\n\nWe would happily recommend her to others and would not hesitate to hire her again.",
"user": {
"userName": "ncamp780",
"displayName": "ncamp780"
}
},
"hasVerifiedLicense": false,
"isProVerificationEnabled": false,
"isProVerified": false,
"hasVerifiedKyc": false,
"isInactivePro": false,
"aiDescription": "",
"offersGreenSkyFinancing": false,
"offersFigureFinancing": false,
"numReviews": 48,
"reviewRating": 49,
"featuredReview": {
"text": "Emily and her team at Inspired Interiors are nothing short of visionary Sherpas for your home. So many designers out there have great style and taste, but are largely tethered to a particular interpretation",
"rawReview": {
"user": {
"userName": "webuser_423741310",
"displayName": "Megan and Adam Butler"
}
}
},
"proSkuId": 5,
"profileUrl": "https://www.houzz.com/professionals/design-build-firms/inspired-interiors-design-build-furnish-pfvwus"
}
}
```
### 🧠 How It Works
Instead of scraping visible HTML, this Actor:
1. Loads the Houzz search page
2. Finds embedded JavaScript containing `ProfessionalStore`
3. Extracts structured JSON data
4. Parses and normalizes professional profiles
👉 This makes it **faster, more stable, and harder to block** than traditional scrapers.
***
### ⚙️ Use Cases
- 🏗️ Lead generation for contractors & agencies
- 📊 Market research by location/category
- 📬 Outreach & sales pipelines
- 🤖 Data pipelines & automation workflows
***
### 🚀 Performance Tips
- Use **Residential proxies** for best success rate
- Keep `maxConcurrency` between **2–5**
- Avoid extremely high `maxItems` without proxy rotation
- If blocked, the scraper auto-rotates sessions
***
### ⚠️ Notes
- Some fields (phone, website) may not always be available
- Houzz may change internal structure → scraper may need updates
- Respect Houzz terms of service when using data
***
### 📌 Summary
This Actor gives you **fast, scalable access to Houzz professionals data** without dealing with complex frontend scraping.
Perfect for turning Houzz into a **lead generation machine** 💰
````
---
# Actor input Schema
## `startUrls` (type: `array`):
Houzz search URLs (e.g., https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398).
## `maxItems` (type: `integer`):
Maximum number of professionals to collect. Set to 0 for unlimited.
## `proxy` (type: `object`):
Residential proxies are highly recommended for Houzz to avoid 403 errors.
## Actor input object example
```json
{
"startUrls": [
{
"url": "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"
}
],
"maxItems": 30,
"proxy": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
````
# Actor output Schema
## `dataset` (type: `string`):
Link to the dataset containing scraped professionals.
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"startUrls": [
{
"url": "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"
}
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("ahmed_jasarevic/houzz-professionals-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "startUrls": [{ "url": "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398" }] }
# Run the Actor and wait for it to finish
run = client.actor("ahmed_jasarevic/houzz-professionals-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 '{
"startUrls": [
{
"url": "https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398"
}
]
}' |
apify call ahmed_jasarevic/houzz-professionals-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=ahmed_jasarevic/houzz-professionals-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Houzz Lead Extractor (Cheapest Extractor)",
"description": "Fast Houzz scraper that extracts professional profiles by parsing embedded JSON (ProfessionalStore) from search pages. Handles pagination, proxy rotation, and anti-bot protections.",
"version": "1.0",
"x-build-id": "3nH3lE4X2tracG8f6"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/ahmed_jasarevic~houzz-professionals-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-ahmed_jasarevic-houzz-professionals-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/ahmed_jasarevic~houzz-professionals-scraper/runs": {
"post": {
"operationId": "runs-sync-ahmed_jasarevic-houzz-professionals-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/ahmed_jasarevic~houzz-professionals-scraper/run-sync": {
"post": {
"operationId": "run-sync-ahmed_jasarevic-houzz-professionals-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",
"required": [
"startUrls"
],
"properties": {
"startUrls": {
"title": "Search URLs",
"type": "array",
"description": "Houzz search URLs (e.g., https://www.houzz.com/professionals/kitchen-and-bath/chicago-il-us-probr0-bo~t_11790~r_4887398).",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"maxItems": {
"title": "Max Professionals to Scrape",
"minimum": 0,
"type": "integer",
"description": "Maximum number of professionals to collect. Set to 0 for unlimited.",
"default": 30
},
"proxy": {
"title": "Proxy configuration",
"type": "object",
"description": "Residential proxies are highly recommended for Houzz to avoid 403 errors.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```