Houzz Professionals Directory
Pricing
from $1.70 / 1,000 professional rows
Houzz Professionals Directory
Houzz home services professionals by category and city: one row per contractor, remodeler, designer, or other pro with name, phone, address, rating, review count, typical job cost, and Houzz profile link. No login.
Pricing
from $1.70 / 1,000 professional rows
Rating
0.0
(0)
Developer
Mamba Labs
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
17 minutes ago
Last modified
Categories
Features
Share
Give Houzz categories and US or Canadian cities, or Houzz directory URLs. The actor reads the Houzz professionals directory and returns one row per business: name, phone, address, rating, review count, typical job cost, project count, Houzz profile link, and the website and social links the professional listed. You pay per professional row. Repeats, empty searches, and summary rows are free.
Features
- One row per professional with name, phone, street, city, state, postal code, coordinates, rating, review count, project count, typical job cost, area served, professional type, verified license badge, and Houzz Pro membership.
- 64 Houzz categories, from general contractors, remodelers, and interior designers to plumbers, roofers, and pest control. Type the category the way you say it (plumber, roofer, kitchen remodelers) or use the Houzz slug.
- Several categories and places in one run. Each category is searched in each place.
- Organic results carry their rank. Sponsored listings that Houzz mixes into the results are labeled
sponsored; turninclude_sponsoredoff to skip them. - A professional found twice in one run, by two searches or as a sponsored card repeated on later pages, is returned and charged once, unless you turn
dedupeoff. - Each search ends with a free summary row with the number Houzz lists for the search and the number returned, so an empty search says why.
- Number and on or off inputs are text, so Clay can send them as they are.
How the data is read
The actor sends plain requests to the public Houzz directory pages (houzz.com/professionals/<category>/c/<City--ST>, 15 organic professionals a page) through the Apify proxy default pool. It reads the schema.org business data Houzz publishes on each card for search engines, plus the professional records embedded in the same page. No login, no browser, no API key, and no other developer's actor. A refused page or a browser check page ends that search in a free blocked row; the actor does not retry it on other addresses.
Input
| Field | Type | Default | What it does |
|---|---|---|---|
categories | array | Houzz professional categories, such as general contractor, plumber, roofer, interior designer, kitchen remodelers, or a Houzz category slug such as general-contractor. One search per category per place. Houzz has 64 categories; a name Houzz does not know returns a free summary row. | |
locations | array | US or Canadian cities as City, ST, for example Denver, CO or Toronto, ON. Put each place on its own line. A place Houzz does not recognize, or resolves to a different city, returns a free summary row. | |
start_urls | array | Optional. Houzz directory pages, for example https://www.houzz.com/professionals/general-contractor/c/Denver--CO. Profile pages are not read. | |
max_results_per_search | string | 15 | Professional rows to return for each category and place, or each URL, counting sponsored cards when they are included. Houzz lists 15 organic professionals a page. Default 15, maximum 1500. |
include_sponsored | string | yes | yes (default) returns the paid placements Houzz mixes into the results, labeled sponsored and without a rank. no returns organic results only. |
dedupe | string | yes | yes (default) returns each professional once per run, so a professional found by two searches, or shown again as a sponsored card on a later page, is charged once. no returns it again each time, charged each time. |
max_charge_usd | string | Optional. The run stops before a charge that would pass this amount. Summary rows are always returned. |
Example:
{"categories": ["general contractor", "plumber"],"locations": ["Denver, CO", "Austin, TX"],"max_results_per_search": "30","include_sponsored": "yes"}
That is 4 searches of up to 30 professionals each: each category in each place.
Output
| Field | Type | What it holds |
|---|---|---|
row_type | string | One of: professional, search_summary, run_summary. run_summary is the one free row written when the input is refused. |
input_category | string | The category from your input. Null for a row from a start URL. |
input_location | string | The place from your input. |
search_url | string | The Houzz directory page this row was read from. |
resolved_location | string | The place Houzz resolved the search to, from the page title. |
page | integer | Directory page number, 15 organic professionals a page. On a search summary row: the last page read. |
rank | integer | Position among the organic results of the search. Null for a sponsored card. |
listing_type | string | organic, or sponsored for a paid placement Houzz mixes into the results. |
name | string | Business name as listed on Houzz. |
pro_type | string | The professional's main Houzz category. |
houzz_url | string | Link to the professional's Houzz profile. |
houzz_id | string | The number after pf~ in the profile URL. |
houzz_user_id | string | Houzz user ID of the professional. Stable key for dedupe across runs. |
phone | string | Business phone as listed. |
street | string | Street address as listed. Some professionals list a city only. |
city | string | City of the business address. |
state | string | State or province code. |
postal_code | string | Postal code. |
country_code | string | Country code of the address. |
latitude | number | Latitude of the business address, when Houzz gives it. |
longitude | number | Longitude of the business address, when Houzz gives it. |
area_served | string | Service area note Houzz shows on the card. |
rating | number | Average review rating out of 5. |
review_count | integer | Number of Houzz reviews. |
project_count | integer | Number of projects (photo sets) on the profile. |
cost_estimate | string | Typical job cost range the professional states. |
verified_license | boolean | Whether Houzz shows a verified license badge. |
paid_pro | boolean | Whether the professional pays for a Houzz Pro plan. |
website | string | Website, only when the professional listed it in the links Houzz shows on the directory page. Null otherwise. |
facebook_url | string | Facebook link the professional listed. |
instagram_url | string | Instagram link the professional listed. |
linkedin_url | string | LinkedIn link the professional listed. |
x_url | string | X or Twitter link the professional listed. |
youtube_url | string | YouTube link the professional listed. |
pinterest_url | string | Pinterest link the professional listed. |
description | string | The professional's own description, up to 2,000 characters. |
image_url | string | Profile image URL. |
total_listed | integer | On a search summary row: how many professionals Houzz says it lists for the search. |
results_returned | integer | On a search summary row: professional rows returned for the search. |
row_status | string | ok, or why this row carries no data: no_results, no_change, partial, blocked, or error. |
error_reason | string | Why the row is not ok. A refused input reads input_invalid: followed by what to fix. |
billable_events_json | string | What this row was billed as, for example {"pro-row":1}. {} means free. |
scraped_at | string | When the row was written, UTC. |
Pricing
Pay per event. Summary rows, repeats, empty searches, and a refused input are free.
| Event | Free plan | Bronze | Silver | Gold |
|---|---|---|---|---|
pro-row, one professional | $0.002 | $0.0019 | $0.0018 | $0.0017 |
apify-actor-start, once per run (one per GB of memory; the default 256 MB is one) | $0.004 | $0.004 | $0.004 | $0.004 |
Per 1,000 rows of pro-row: $2.00 on the free plan, $1.70 on Gold.
Free plan cap: 1.50 USD of evaluation a month, about 750 rows. Any paid Apify plan removes the cap, and it resets on the 1st. The run stops before a charge that passes your maximum charge per run in Apify or your max_charge_usd input.
Mamba Labs pays the platform costs of your run, Apify proxy traffic included.
Usage examples
Clay. Number and on or off inputs are text fields, which is what Clay sends. A list input takes a JSON list, so put the column inside a one item list, for example a JSON list holding the city column for locations.
Contractor lead lists. Search one category across several cities, keep rows with a phone and a rating of 4.5 or more, and use houzz_user_id to dedupe across runs.
MCP. The Mamba Labs MCP server @mambalabsdev/mcp-houzz-professionals exposes this actor to Claude and other MCP clients.
Error handling
| Case | What you get |
|---|---|
| Missing or unreadable input | One free row, row_type run_summary, error_reason starting input_invalid: with what to fix. The run ends successfully and charges nothing but the run start |
| Categories without places, or places without categories | Refused the same way |
| A start URL that is not a Houzz directory page, or a profile page | Refused the same way, with the URL named |
| A category Houzz does not have | One free search_summary row with row_status no_results that names valid categories |
| A place Houzz does not recognize | One free search_summary row with row_status no_results. Houzz shows nationwide results for an unknown place; the actor does not return them |
| A place Houzz resolves to a different city or state | One free search_summary row with row_status no_results naming the place Houzz chose |
| The first 5 searches all return nothing | The run stops, so a list of wrong names costs only the run start |
| Houzz refuses a request or answers with a browser check | One free search_summary row with row_status blocked. Rows already read for that search are kept |
| The run is close to its timeout | The actor stops starting new work 90 seconds before the timeout and delivers what it has |
Limitations
- Places are US and Canadian cities on houzz.com. Write them as City, ST, for example Denver, CO. A city name with no state goes to the US city Houzz ranks first (London becomes London, OH);
resolved_locationon every row shows the place Houzz used. - Houzz lists 15 organic professionals a page and allows about 100 pages (1,500 professionals) per search. Houzz orders results by its own ranking, so
rankis the order on that run. - The directory page does not carry email addresses, and carries a website only when the professional added it to the links Houzz shows there. On a 30 row Denver page, 9 of 30 had a website. Profile pages are not read, so fields that only the profile shows (full service area list, license number, hours) are not returned.
- Sponsored cards are paid placements and repeat across pages; with
dedupeon, each is returned once. - Houzz's Terms of Use prohibit scraping and similar data gathering tools. robots.txt does not disallow the directory pages. Read the terms before you rely on this data.
Mamba Labs actor suite
Built by Mamba Labs.