Houzz Pro Directory Finder by City & Category

Find Houzz contractors, architects, and designers by city and category across 16 countries, with ratings, reviews, hires, services, license status, and location for each professional.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`mode`	string	optional	What to scrape. `search` builds a directory from country + city + profession; `byUrls` reads directory URLs; `profiles` reads profile URLs; `reviews` emits review rows; `photos` browses photo inspiration.
`country`	string	optional	Houzz market used for search and profile URLs.
`city`	string	optional	City or city + state to search, e.g. `Los Angeles, CA`, `London`, `Berlin`. Used with profession or categorySlug in search mode.

Show all input fields

Field	Type	Required	Description
`mode`	string	optional	What to scrape. `search` builds a directory from country + city + profession; `byUrls` reads directory URLs; `profiles` reads profile URLs; `reviews` emits review rows; `photos` browses photo inspiration.
`country`	string	optional	Houzz market used for search and profile URLs.
`city`	string	optional	City or city + state to search, e.g. `Los Angeles, CA`, `London`, `Berlin`. Used with profession or categorySlug in search mode.
`profession`	string	optional	Universal profession mapped to the selected market's Houzz category. Used in search mode.
`categorySlug`	string	optional	Exact Houzz category slug, used instead of the mapped profession, e.g. `general-contractor`, `architekten`, `architectes`. Use a direct directory URL if you are unsure.
`keyword`	string	optional	Optional keyword filter for professional search, or the search term for photo mode.
`sortBy`	string	optional	Server-side order for professional directory results.
`minRating`	number	optional	Drop professionals below this star rating. Set 0 to keep all.
`minReviewCount`	integer	optional	Drop professionals with fewer reviews. Set 0 to keep all.
`directoryUrls`	array	optional	Houzz professional directory, category or search-result URLs. All live markets and localised paths are accepted.
`profileUrls`	array	optional	Direct Houzz professional profile URLs, including localised paths such as /experten/, /professionnels/ and /profesionales/.
`photoUrls`	array	optional	Direct Houzz photo detail URLs. Use mode=photos.
`photoCategory`	string	optional	Room category for photo inspiration browsing. Use keyword to search instead.
`photoStyle`	string	optional	Optional design style filter for photo inspiration.
`includeReviews`	boolean	optional	Attach review history to each professional record.
`maxReviewsPerPro`	integer	optional	Review cap per professional. Set 0 to fetch the full history (up to 1,024).
`fetchDetails`	boolean	optional	Open each professional profile for services, awards, socials, counts and licensing. Turn off for directory-card-only records.
`fetchPhotoDetails`	boolean	optional	Open each photo for full image sizes, owner, location and question count.
`enrichEmails`	boolean	optional	Best-effort email lookup on each professional's own website. Adds requests and is optional.
`maxItems`	integer	optional	Hard cap on emitted records.
`maxPages`	integer	optional	Optional page cap. Set 0 to use the source ceiling: 100 directory pages, 30 keyword pages, 250 photo pages or 10 photo keyword pages.

Download the published input schema

View complete JSON

{
  "description": "Scrape Houzz professionals by market, city, profession or keyword, enrich profiles with reviews and contact details, or browse photo inspiration by room and style.",
  "properties": {
    "categorySlug": {
      "default": "",
      "description": "Exact Houzz category slug, used instead of the mapped profession, e.g. `general-contractor`, `architekten`, `architectes`. Use a direct directory URL if you are unsure.",
      "editor": "textfield",
      "prefill": "",
      "title": "Category slug override",
      "type": "string"
    },
    "city": {
      "default": "Los Angeles, CA",
      "description": "City or city + state to search, e.g. `Los Angeles, CA`, `London`, `Berlin`. Used with profession or categorySlug in search mode.",
      "editor": "textfield",
      "prefill": "Los Angeles, CA",
      "title": "City",
      "type": "string"
    },
    "country": {
      "default": "us",
      "description": "Houzz market used for search and profile URLs.",
      "editor": "select",
      "enum": [
        "us",
        "ca",
        "uk",
        "ie",
        "au",
        "nz",
        "de",
        "fr",
        "it",
        "es",
        "in",
        "sg",
        "jp",
        "dk",
        "se",
        "ru"
      ],
      "enumTitles": [
        "United States (houzz.com)",
        "Canada (houzz.com)",
        "United Kingdom (houzz.co.uk)",
        "Ireland (houzz.ie)",
        "Australia (houzz.com.au)",
        "New Zealand (houzz.co.nz)",
        "Germany (houzz.de)",
        "France (houzz.fr)",
        "Italy (houzz.it)",
        "Spain (houzz.es)",
        "India (houzz.in)",
        "Singapore (houzz.com.sg)",
        "Japan (houzz.jp)",
        "Denmark (houzz.dk)",
        "Sweden (houzz.se)",
        "Russia (legacy, site unavailable)"
      ],
      "prefill": "us",
      "title": "Country",
      "type": "string"
    },
    "directoryUrls": {
      "default": [],
      "description": "Houzz professional directory, category or search-result URLs. All live markets and localised paths are accepted.",
      "editor": "stringList",
      "prefill": [],
      "title": "Directory URLs",
      "type": "array"
    },
    "enrichEmails": {
      "default": false,
      "description": "Best-effort email lookup on each professional's own website. Adds requests and is optional.",
      "prefill": false,
      "title": "Enrich contact emails",
      "type": "boolean"
    },
    "fetchDetails": {
      "default": true,
      "description": "Open each professional profile for services, awards, socials, counts and licensing. Turn off for directory-card-only records.",
      "prefill": true,
      "title": "Fetch full profiles",
      "type": "boolean"
    },
    "fetchPhotoDetails": {
      "default": false,
      "description": "Open each photo for full image sizes, owner, location and question count.",
      "prefill": false,
      "title": "Fetch photo details",
      "type": "boolean"
    },
    "includeReviews": {
      "default": false,
      "description": "Attach review history to each professional record.",
      "prefill": false,
      "title": "Include reviews",
      "type": "boolean"
    },
    "keyword": {
      "default": "",
      "description": "Optional keyword filter for professional search, or the search term for photo mode.",
      "editor": "textfield",
      "prefill": "",
      "title": "Keyword",
      "type": "string"
    },
    "maxItems": {
      "default": 25,
      "description": "Hard cap on emitted records.",
      "maximum": 5000,
      "minimum": 1,
      "prefill": 1,
      "title": "Max items",
      "type": "integer"
    },
    "maxPages": {
      "default": 0,
      "description": "Optional page cap. Set 0 to use the source ceiling: 100 directory pages, 30 keyword pages, 250 photo pages or 10 photo keyword pages.",
      "maximum": 500,
      "minimum": 0,
      "prefill": 0,
      "title": "Max pages",
      "type": "integer"
    },
    "maxReviewsPerPro": {
      "default": 20,
      "description": "Review cap per professional. Set 0 to fetch the full history (up to 1,024).",
      "maximum": 1024,
      "minimum": 0,
      "prefill": 20,
      "title": "Max reviews per professional",
      "type": "integer"
    },
    "minRating": {
      "default": 0,
      "description": "Drop professionals below this star rating. Set 0 to keep all.",
      "maximum": 5,
      "minimum": 0,
      "prefill": 0,
      "title": "Minimum rating",
      "type": "number"
    },
    "minReviewCount": {
      "default": 0,
      "description": "Drop professionals with fewer reviews. Set 0 to keep all.",
      "maximum": 100000,
      "minimum": 0,
      "prefill": 0,
      "title": "Minimum review count",
      "type": "integer"
    },
    "mode": {
      "default": "search",
      "description": "What to scrape. `search` builds a directory from country + city + profession; `byUrls` reads directory URLs; `profiles` reads profile URLs; `reviews` emits review rows; `photos` browses photo inspiration.",
      "editor": "select",
      "enum": [
        "search",
        "byUrls",
        "profiles",
        "reviews",
        "photos"
      ],
      "enumTitles": [
        "Search by city and profession",
        "Directory URLs",
        "Professional profile URLs",
        "Reviews",
        "Photo inspiration"
      ],
      "prefill": "search",
      "title": "Mode",
      "type": "string"
    },
    "photoCategory": {
      "default": "kitchen",
      "description": "Room category for photo inspiration browsing. Use keyword to search instead.",
      "editor": "select",
      "enum": [
        "kitchen",
        "bathroom",
        "bedroom",
        "living-room",
        "dining-room",
        "outdoor",
        "baby-kids",
        "home-office",
        "storage-closet",
        "exterior",
        "basement",
        "entry",
        "garage-shed",
        "gym",
        "home-bar",
        "hallway",
        "laundry",
        "staircase",
        "wine-cellar",
        "all-rooms"
      ],
      "enumTitles": [
        "Kitchen",
        "Bathroom",
        "Bedroom",
        "Living room",
        "Dining room",
        "Outdoor",
        "Baby & kids",
        "Home office",
        "Storage & closet",
        "Exterior",
        "Basement",
        "Entryway",
        "Garage & shed",
        "Home gym",
        "Home bar",
        "Hallway",
        "Laundry",
        "Staircase",
        "Wine cellar",
        "All rooms"
      ],
      "prefill": "kitchen",
      "title": "Photo room",
      "type": "string"
    },
    "photoStyle": {
      "default": "",
      "description": "Optional design style filter for photo inspiration.",
      "editor": "select",
      "enum": [
        "",
        "asian",
        "contemporary",
        "eclectic",
        "modern",
        "traditional",
        "tropical",
        "mediterranean",
        "coastal",
        "rustic",
        "transitional",
        "industrial",
        "farmhouse",
        "mid-century-modern",
        "craftsman",
        "southwestern",
        "shabby-chic-style",
        "scandinavian",
        "victorian",
        "french-country"
      ],
      "enumTitles": [
        "Any style",
        "Asian",
        "Contemporary",
        "Eclectic",
        "Modern",
        "Traditional",
        "Tropical",
        "Mediterranean",
        "Coastal",
        "Rustic",
        "Transitional",
        "Industrial",
        "Farmhouse",
        "Mid-Century Modern",
        "Craftsman",
        "Southwestern",
        "Shabby-Chic Style",
        "Scandinavian",
        "Victorian",
        "French Country"
      ],
      "prefill": "",
      "title": "Photo style",
      "type": "string"
    },
    "photoUrls": {
      "default": [],
      "description": "Direct Houzz photo detail URLs. Use mode=photos.",
      "editor": "stringList",
      "prefill": [],
      "title": "Photo URLs",
      "type": "array"
    },
    "profession": {
      "default": "general-contractor",
      "description": "Universal profession mapped to the selected market's Houzz category. Used in search mode.",
      "editor": "select",
      "enum": [
        "general-contractor",
        "architect",
        "interior-designer",
        "kitchen-bath",
        "home-builder",
        "design-build",
        "landscape",
        "painter",
        "roofer",
        "flooring",
        "tile-stone",
        "cabinet-maker",
        "carpenter",
        "pool-spa",
        "windows-doors",
        "home-stager"
      ],
      "enumTitles": [
        "General contractor",
        "Architect",
        "Interior designer",
        "Kitchen & bath specialist",
        "Home builder",
        "Design-build firm",
        "Landscape contractor",
        "Painter",
        "Roofer",
        "Flooring specialist",
        "Tile & stone specialist",
        "Cabinet maker",
        "Carpenter",
        "Pool & spa builder",
        "Windows & doors specialist",
        "Home stager"
      ],
      "prefill": "general-contractor",
      "title": "Profession",
      "type": "string"
    },
    "profileUrls": {
      "default": [],
      "description": "Direct Houzz professional profile URLs, including localised paths such as /experten/, /professionnels/ and /profesionales/.",
      "editor": "stringList",
      "prefill": [],
      "title": "Profile URLs",
      "type": "array"
    },
    "sortBy": {
      "default": "relevance",
      "description": "Server-side order for professional directory results.",
      "editor": "select",
      "enum": [
        "relevance",
        "reviews",
        "rating",
        "distance"
      ],
      "enumTitles": [
        "Relevance",
        "Most reviewed",
        "Highest rated",
        "Nearest"
      ],
      "prefill": "relevance",
      "title": "Sort professionals by",
      "type": "string"
    }
  },
  "schemaVersion": 1,
  "title": "Houzz Scraper Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`professionals`	string	optional	Dataset containing Houzz professional records with contact, service, award, social and review data.
`reviews`	string	optional	Dataset containing Houzz review rows with reviewer, project and owner-response detail.
`photos`	string	optional	Dataset containing Houzz photo inspiration records with room, style, owner and image detail.

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "Houzz professional profiles with contacts, services, awards, socials and reviews, review rows, and photo inspiration records.",
  "properties": {
    "photos": {
      "description": "Dataset containing Houzz photo inspiration records with room, style, owner and image detail.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Houzz photos",
      "type": "string"
    },
    "professionals": {
      "description": "Dataset containing Houzz professional records with contact, service, award, social and review data.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Houzz professionals",
      "type": "string"
    },
    "reviews": {
      "description": "Dataset containing Houzz review rows with reviewer, project and owner-response detail.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Houzz reviews",
      "type": "string"
    }
  },
  "title": "Houzz Professionals, Reviews & Photos Scraper Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "views": {
    "photos": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Photos",
      "transformation": {
        "fields": [
          "title",
          "category",
          "style",
          "ownerName",
          "metroArea",
          "canonicalUrl"
        ]
      }
    },
    "professionals": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Professionals",
      "transformation": {
        "fields": [
          "title",
          "category",
          "phoneNumber",
          "ratingValue",
          "reviewCount",
          "city",
          "state"
        ]
      }
    },
    "reviews": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Reviews",
      "transformation": {
        "fields": [
          "proName",
          "rating",
          "reviewerName",
          "projectDate",
          "relationship",
          "profileUrl"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Houzz Professionals, Reviews & Photos Scraper

Scrape Houzz professional directories across 15 country sites, open each pro's profile for contact, service, award, social and licensing detail, pull their full review history, and browse the photo inspiration library by room, style or keyword. Everything is public and cookieless: no Houzz account, browser, API key or proxy setup is needed.

What this actor does

Five modes: search, byUrls, profiles, reviews, photos
Every live market: US, Canada, UK, Ireland, Australia, New Zealand, Germany, France, Italy, Spain, India, Singapore, Japan, Denmark and Sweden, with localised profile paths
Search by city + profession or keyword, with rating and review-count filters and server-side sort
Deep directory pagination: up to 100 pages per category and 30 pages for keyword-filtered searches
Rich profiles: business name, contact person, phone, website, full address, services, awards, badges, credentials, social links, licence status, project/photo/follower counts and review aspect scores
Full reviews: reviewer, rating, body, project date and price, review photos and the professional's reply
Photo inspiration: room category, keyword, 19 design styles, optional detail enrichment for full image sets, owner and location
Optional email enrichment from each professional's own website
Empty fields are omitted from every record instead of being returned as null

Output per professional

title, businessName, description
phoneNumber, websiteUrl, contactName, contactEmail, emails[], emailSourceUrl
licenseNumber, licenseType, licenseVerifiedDate, licenseIssuedBy, verifiedLicense
ratingValue, reviewCount, hiresOnHouzz, followersCount, projectCount, photoCount, galleryCount
isProVerified, isPaidPro, reviewAspectRatings{workQuality, communication, onTime, value}
servicesProvided[], awards[], badges[], credentials[], faq[]
socialLinks{facebook, instagram, twitter, pinterest, youtube, linkedin, tiktok}
proId, userId, userName, category, categories[]
streetAddress, city, state, postalCode, country, countryCode, fullAddress
latitude, longitude, areaServed[], imageUrl
reviews[], reviewsFetched, reviewsTotalAvailable when reviews are requested
sourceUrl, profileUrl, canonicalUrl, slug
siteName, recordType: "professional", recordSource, scrapedAt

Output per review

reviewId, proId, proName, profileUrl
rating, body, relationship, projectDate, projectPrice
reviewerName, reviewerUserName, reviewerProfileUrl, reviewerIsPro
createdAt, numberOfLikes, photos[]
proResponse, proResponseAt
recordType: "review", scrapedAt

Output per photo

photoId, title, description, url, canonicalUrl
imageUrl, heroImageUrl, images[], imageWidth, imageHeight
categoryId, category, styleId, style
ownerId, ownerName, ownerProfileUrl, ownerIsPro
projectId, questionCount, comments, recentBuzz
metroArea, city, state, countryCode
isFeatured, isGated, sourceUrl
recordType: "photo", scrapedAt

Input

Field	Type	Default	Description
`mode`	string	`search`	`search` / `byUrls` / `profiles` / `reviews` / `photos`
`country`	string	`us`	Houzz market: `us`, `ca`, `uk`, `ie`, `au`, `nz`, `de`, `fr`, `it`, `es`, `in`, `sg`, `jp`, `dk`, `se`; legacy `ru` is accepted for saved tasks but Houzz Russia is offline
`city`	string	`Los Angeles, CA`	City or city + state for search mode
`profession`	string	`general-contractor`	16 universal professions mapped to each market
`categorySlug`	string	–	Exact Houzz category slug override
`keyword`	string	–	Professional keyword filter or photo search term
`sortBy`	string	`relevance`	`relevance` / `reviews` / `rating` / `distance`
`minRating`	number	`0`	Drop professionals below this rating
`minReviewCount`	integer	`0`	Drop professionals below this review count
`directoryUrls`	array	`[]`	Houzz directory, category or search-result URLs
`profileUrls`	array	`[]`	Direct Houzz professional profile URLs
`photoUrls`	array	`[]`	Direct Houzz photo detail URLs
`photoCategory`	string	`kitchen`	Room category for photo browsing
`photoStyle`	string	–	Optional design style filter
`includeReviews`	boolean	`false`	Attach review history to professional records
`maxReviewsPerPro`	integer	`20`	Review cap per professional; `0` means all
`fetchDetails`	boolean	`true`	Open each professional profile
`fetchPhotoDetails`	boolean	`false`	Open each photo for full image and owner detail
`enrichEmails`	boolean	`false`	Best-effort email lookup on the pro's own website
`maxItems`	integer	`25`	Hard record cap (1–5,000)
`maxPages`	integer	`0`	Optional page cap; `0` uses the source ceiling

Example: contractors in Los Angeles

{
  "mode": "search",
  "country": "us",
  "city": "Los Angeles, CA",
  "profession": "general-contractor",
  "minRating": 4.5,
  "minReviewCount": 10,
  "maxItems": 100
}

Example: London interior designers with reviews

{
  "mode": "search",
  "country": "uk",
  "city": "London",
  "profession": "interior-designer",
  "includeReviews": true,
  "maxReviewsPerPro": 50,
  "maxItems": 40
}

Example: specific profiles and directory URLs

{
  "mode": "byUrls",
  "directoryUrls": [
    "https://www.houzz.de/professionals/architekten/berlin-16-de-probr0-bo~t_11973~r_2950159"
  ],
  "profileUrls": [
    "https://www.houzz.com/professionals/general-contractors/goldenline-remodeling-pfvwus-pf~28977151"
  ],
  "fetchDetails": true,
  "maxItems": 30
}

Example: kitchen photo inspiration

{
  "mode": "photos",
  "photoCategory": "kitchen",
  "photoStyle": "scandinavian",
  "fetchPhotoDetails": true,
  "maxItems": 60
}

Use cases

Contractor lead generation — build a city list with phone, website, address, licence and review proof
Competitive benchmarking — compare services, awards and review scores across firms in one category
Market expansion research — compare the same profession across 15 Houzz country sites
Vendor due diligence — check credentials, licence status, project volume and owner replies
Review intelligence — export reviewer sentiment, project budgets and response behaviour
Design trend research — collect photo records by room, style and metro area for moodboards or analysis

FAQ

Is this affiliated with Houzz? No. This is an independent third-party actor that reads publicly visible Houzz pages. It is not operated by or affiliated with Houzz.

Do I need a Houzz account, cookies or an API key? No. Every supported mode works anonymously on public pages. There is no login step.

Do I need to configure a proxy? No. The actor makes direct requests and does not require proxy setup. Just choose a mode and run it.

Why does Houzz Japan sometimes return no professionals? Houzz Japan intermittently blocks datacenter IPs or serves 404 profile pages. The actor reports the failed fetch and keeps any directory cards it already parsed instead of inventing rows. Other 14 markets run directly.

Why do some records have fewer fields than others? Professionals publish different amounts of information, and some categories show fewer badges or services. Fields with no value on the source page are omitted, never returned as null.

How many professionals can one search return? A category or city directory serves up to 100 pages, and a keyword-filtered search stops at 30 pages. Coverage also depends on how many professionals are actually active in that city and profession.

Why is phoneNumber sometimes a toll-free number? Houzz may display a business tracking number on the profile while the directory card shows a local number. The actor prefers the local directory number when both are available.

Why do photo keyword searches stop before a room browse does? Houzz caps photo keyword results at 200 items (10 pages), while room browsing goes much deeper. The actor reports the ceiling instead of silently returning fewer photos.

Why is there no product mode? Shop Houzz closed in 2026. The product pages now show "No Longer Available" or return 404, so there is no live product data to scrape. Professional and photo data are unaffected.

Can I combine several inputs in one run? Yes. Directory URLs and profile URLs can be mixed, and search accepts a city plus profession while also honouring any direct URLs you add.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build TRlqaqbv6wYcl6cdj. Documentation is regenerated from the default published build; private drafts are not included.