# Houzz Professionals Directory (`mambalabs/houzz-professionals`) Actor

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.

- **URL**: https://apify.com/mambalabs/houzz-professionals.md
- **Developed by:** [Mamba Labs](https://apify.com/mambalabs) (community)
- **Categories:** Lead generation, Real estate, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.70 / 1,000 professional rows

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?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Houzz Professionals Directory

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`; turn `include_sponsored` off 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 `dedupe` off.
- 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:

```json
{
  "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_location` on 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 `rank` is 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 `dedupe` on, 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

| Actor | Actor ID |
|---|---|
| [Account Hiring Watch](https://apify.com/mambalabs/account-hiring-watch?fpr=mamba) | `gRAZA5WBi1r6L0gy7` |
| [Agent Accessibility Auditor](https://apify.com/mambalabs/agent-accessibility-auditor?fpr=mamba) | `anxbRv0lKrpQ1pnua` |
| [Agent to Brokerage Resolver](https://apify.com/mambalabs/agent-brokerage-resolver?fpr=mamba) | `ePRRGLxOGyaVHO4dI` |
| [AI Answer Visibility Tracker](https://apify.com/mambalabs/ai-answer-visibility-tracker?fpr=mamba) | `RJZvzKniYK4nswcMg` |
| [AI List Extractor for Any Website](https://apify.com/mambalabs/ai-list-extractor-any-website?fpr=mamba) | `D5hOdIez45M0NX5jD` |
| [AI Tooling Detector](https://apify.com/mambalabs/ai-tooling-detector?fpr=mamba) | `EwkHhmqiuJgRoVEbE` |
| [Amazon Product, Price, and Stock Tracker](https://apify.com/mambalabs/amazon-product-price-stock-tracker?fpr=mamba) | `MtJPZoyjJ3IeqTFyo` |
| [Amazon Top Reviews Scraper](https://apify.com/mambalabs/amazon-top-reviews-scraper?fpr=mamba) | `wh6Mq6G6BlW1CRPwx` |
| [API Deprecation and Breaking Change Monitor](https://apify.com/mambalabs/api-change-monitor?fpr=mamba) | `pHsbS3xXUK8Jqutz5` |
| [App Store and Google Play Review Monitor](https://apify.com/mambalabs/app-store-google-play-review-monitor?fpr=mamba) | `MaCMEhGrbchxQZ92G` |
| [B2B Reddit Conversation Monitor](https://apify.com/mambalabs/b2b-reddit-conversation-monitor?fpr=mamba) | `SoDryzzsjmY3SsiyG` |
| [B2B Social Video Transcripts](https://apify.com/mambalabs/b2b-social-video-transcripts?fpr=mamba) | `dG2UYVKE2e4zfDucK` |
| [Bluesky Brand Presence Mapper](https://apify.com/mambalabs/bluesky-brand-presence-mapper?fpr=mamba) | `eLpxzP4IuXznlFVND` |
| [Bluesky Posts Scraper](https://apify.com/mambalabs/bluesky-posts-scraper?fpr=mamba) | `KldSjS7wjoeZ7vQGm` |
| [Brand Sponsor Finder](https://apify.com/mambalabs/brand-sponsor-finder?fpr=mamba) | `PPgK6xrgOmvL7Nrys` |
| [Brazil CNPJ Company Data](https://apify.com/mambalabs/brazil-cnpj-company-data?fpr=mamba) | `cTVqsjG6A56xtLkBA` |
| [Bulk WHOIS and RDAP Domain Age Lookup](https://apify.com/mambalabs/whois-domain-lookup?fpr=mamba) | `MTrkG5FLU6SjqLdJY` |
| [Business PDF Field Extractor](https://apify.com/mambalabs/business-pdf-field-extractor?fpr=mamba) | `vM7JCk0CMAx5W0oJh` |
| [Career Change Signal Engine](https://apify.com/mambalabs/career-change-signal-engine?fpr=mamba) | `vX2Yga1a6wGaXaP14` |
| [Company Careers Page Jobs, 17 ATS Boards](https://apify.com/mambalabs/ats-jobs-feed?fpr=mamba) | `izP0rfIgf5YaRZfIh` |
| [Company Change Event Feed](https://apify.com/mambalabs/company-change-event-feed?fpr=mamba) | `oX44rS0fkEJ3rXLWe` |
| [Company Discovery List Builder](https://apify.com/mambalabs/company-discovery-list-builder?fpr=mamba) | `jch0HdaZnpbMqlcGS` |
| [Company Firmographic Enricher](https://apify.com/mambalabs/company-firmographic-enricher?fpr=mamba) | `YlUtLWjfPpqykmB8g` |
| [Company Funding Record](https://apify.com/mambalabs/funding-investor-record?fpr=mamba) | `OFS4Mt1gyYNtGfUbE` |
| [Company Headcount Estimator](https://apify.com/mambalabs/company-headcount-estimator?fpr=mamba) | `aHC4GROnNt6kfZe5r` |
| [Company Identity Resolver](https://apify.com/mambalabs/company-identity-resolver?fpr=mamba) | `lr8fTRAmZCBZmuwwh` |
| [Company Role Email, Phone and Address Finder](https://apify.com/mambalabs/company-contact-details-extractor?fpr=mamba) | `4mMncKaJykiq94grz` |
| [Company Social Presence Mapper](https://apify.com/mambalabs/company-social-presence-mapper?fpr=mamba) | `4k6CCemkgBDz18m2h` |
| [Competitor Price, Stock, and Changelog Monitor](https://apify.com/mambalabs/competitor-price-stock-changelog-monitor?fpr=mamba) | `yxdgCbUQ4PYQWwRNU` |
| [Contact Classifier](https://apify.com/mambalabs/contact-classifier?fpr=mamba) | `0lGSeYJmniXhGANnO` |
| [Contractor License Search, CA, TX, WA, OR, LA](https://apify.com/mambalabs/contractor-license-lookup?fpr=mamba) | `WBYK3CPI2kdeq4bP1` |
| [CRM Contact Job Change Checker](https://apify.com/mambalabs/job-change-tracker?fpr=mamba) | `L8UbEmMJC1XYPSZOb` |
| [Domain Deliverability Checker](https://apify.com/mambalabs/domain-deliverability-checker?fpr=mamba) | `0tVgxI7A6o9jMlxmc` |
| [Domain to LinkedIn URL Resolver](https://apify.com/mambalabs/domain-to-linkedin-url-resolver?fpr=mamba) | `3HtnSaqPHOg1Qg5gx` |
| [Ecommerce Platform Profiler](https://apify.com/mambalabs/ecommerce-platform-profiler?fpr=mamba) | `5G2NeYjBbQTjaTn9L` |
| [Ecommerce Store Discovery](https://apify.com/mambalabs/ecommerce-store-discovery?fpr=mamba) | `PeHu4sLyFvQHXUUrX` |
| [Email List Verifier, Bring Your Own Key](https://apify.com/mambalabs/email-verifier?fpr=mamba) | `CzVJ4NlaCKk80xpgE` |
| [Event Presence Index](https://apify.com/mambalabs/event-presence-index?fpr=mamba) | `WLhMy8fMDgsxdYxv5` |
| [Eventbrite Events Scraper](https://apify.com/mambalabs/eventbrite-events-scraper?fpr=mamba) | `sgc6znyrbjOy5Yk9f` |
| [Expert Witness Finder, US and Australia](https://apify.com/mambalabs/expert-witness-directory?fpr=mamba) | `LIpwlgfE3LaQBaXd4` |
| [Facebook Posts Scraper](https://apify.com/mambalabs/facebook-posts-scraper?fpr=mamba) | `T6jxIeq4ua0SLXnqG` |
| [Facebook Reels Scraper](https://apify.com/mambalabs/facebook-reels-scraper?fpr=mamba) | `AkOg4iNPHwYZD7Q5E` |
| [Funding and Press Signal Scanner](https://apify.com/mambalabs/funding-press-signal-scanner?fpr=mamba) | `FS13X6dhQVgX3XOM6` |
| [GDPR Cookie Banner and Consent Checker](https://apify.com/mambalabs/cookie-consent-audit?fpr=mamba) | `TrKyOS0KBoGC35nbr` |
| [GitHub Followers and Following Export](https://apify.com/mambalabs/github-followers-following-export?fpr=mamba) | `SGNxDmFb9v3tRDaFI` |
| [GitHub Organization Signal Scanner](https://apify.com/mambalabs/github-organization-signal-scanner?fpr=mamba) | `ahF8RRpv5mzPao5CN` |
| [Google Ads Transparency Center Scraper by Domain](https://apify.com/mambalabs/google-ads-transparency-monitor?fpr=mamba) | `1eOwxhBVxzvOXAm4s` |
| [Google Flights Fares](https://apify.com/mambalabs/google-flights-fares?fpr=mamba) | `oVCatSfzcXbkFfcav` |
| [Google Hotels Prices](https://apify.com/mambalabs/google-hotels-prices?fpr=mamba) | `ua9mDci66setpfd0B` |
| [Google Maps Places Scraper](https://apify.com/mambalabs/google-maps-places-scraper?fpr=mamba) | `SuvHCNJ7pIuw6gn54` |
| [Google Sheets Import and Export](https://apify.com/mambalabs/google-sheets-import-export?fpr=mamba) | `0VT1IaI5S3lIllONL` |
| [Google Trends Scraper](https://apify.com/mambalabs/google-trends-scraper?fpr=mamba) | `OeDzaACKmBYJXzHZk` |
| [GTM Hiring Signal Scraper](https://apify.com/mambalabs/gtm-hiring-signal-scraper?fpr=mamba) | `D7O1SA2EqwHGsGr1P` |
| [GTM Signals Aggregator](https://apify.com/mambalabs/b2b-buying-signals-hiring-tech-stack-intent-for-clay?fpr=mamba) | `xKdRfnfFNkdMpFuNs` |
| [Healthcare Provider NPI Enricher](https://apify.com/mambalabs/healthcare-provider-npi-enricher?fpr=mamba) | `MrgbHzcpDq3mOv9Df` |
| [Houzz Professionals Directory](https://apify.com/mambalabs/houzz-professionals?fpr=mamba) | `gv0DatXK2mOidqKLe` |
| [ICP Fit Scorer](https://apify.com/mambalabs/icp-account-lead-scoring-fit-scorer-0-100-for-clay?fpr=mamba) | `W161DT8W4kW55dMFh` |
| [Influencer Change Monitor](https://apify.com/mambalabs/creator-change-monitor?fpr=mamba) | `d2VVgahNL6UmcLkhg` |
| [Influencer Lead List Builder](https://apify.com/mambalabs/creator-lead-list-all-in-one?fpr=mamba) | `KnmByszcv135yM30G` |
| [Influencer Profile Scraper](https://apify.com/mambalabs/creator-profile-reader?fpr=mamba) | `EqEnklDVMIcB1V499` |
| [Influencer Search Across TikTok, Instagram and YouTube](https://apify.com/mambalabs/creator-finder?fpr=mamba) | `tpkedmloIIWtXx6sg` |
| [Influencer Talent Agency Lookup](https://apify.com/mambalabs/talent-agency-lookup?fpr=mamba) | `zCuX4Mgyg6JvXgGzd` |
| [Instagram Facebook Brand Presence Mapper](https://apify.com/mambalabs/meta-brand-presence-mapper?fpr=mamba) | `HXh65I0JBjPsunbY8` |
| [Integration and Marketplace Presence Mapper](https://apify.com/mambalabs/integration-marketplace-presence-mapper?fpr=mamba) | `V0guNuvM85Q61f2gj` |
| [Job Board Keyword Signal Scanner](https://apify.com/mambalabs/job-board-keyword-signal-scanner?fpr=mamba) | `4DvqpvhMR74NLcDDY` |
| [Job Posting Liveness Checker](https://apify.com/mambalabs/job-posting-liveness-checker?fpr=mamba) | `qRI0ohsnkCwLeDKtw` |
| [Job Posting Monitor](https://apify.com/mambalabs/gtm-job-discovery?fpr=mamba) | `QCfICD9kOPiOdj5iI` |
| [Journalist and Media List Builder](https://apify.com/mambalabs/journalist-media-list-builder?fpr=mamba) | `mAfizsZC8qRoR0ecS` |
| [Kick Channels, Streams, and Clips](https://apify.com/mambalabs/kick-channels-streams?fpr=mamba) | `REl7yEdagIx2YvoQU` |
| [Launch Directory List Builder](https://apify.com/mambalabs/launch-directory-list-builder?fpr=mamba) | `cRq3bmvEZxZtioQ7U` |
| [Lead File Import Checker](https://apify.com/mambalabs/lead-file-import-checker?fpr=mamba) | `RwlGVXTf46LqZdUgt` |
| [Legal Entity Resolver](https://apify.com/mambalabs/legal-entity-resolver?fpr=mamba) | `KHFyPCDIx7CyqULYm` |
| [Link in Bio Scraper and Newsletter Detector](https://apify.com/mambalabs/link-in-bio-newsletter-checker?fpr=mamba) | `OorucdheTIgu7RFzK` |
| [LinkedIn Company Page Details](https://apify.com/mambalabs/linkedin-company-page-details?fpr=mamba) | `N9rfy1Cj2FRTOawvx` |
| [LinkedIn Company Page Mapper](https://apify.com/mambalabs/linkedin-company-presence-mapper?fpr=mamba) | `zOPm6A9JEhUGcIdFW` |
| [LinkedIn Jobs Feed](https://apify.com/mambalabs/linkedin-jobs-feed?fpr=mamba) | `SH6N0d8cz46BhCC8B` |
| [LinkedIn Post Tracker](https://apify.com/mambalabs/linkedin-post-engager-capture?fpr=mamba) | `oiGLNPuaf5BRaz9K5` |
| [Local Business Lead Builder](https://apify.com/mambalabs/local-business-lead-builder?fpr=mamba) | `qMN97aoHhsAS5bznV` |
| [Local Rank and Map Pack Tracker](https://apify.com/mambalabs/local-rank-map-pack-tracker?fpr=mamba) | `gv0kyHGDIg8XscclB` |
| [Lookalike Companies from Seed Domains](https://apify.com/mambalabs/lookalike-company-finder?fpr=mamba) | `e2O426WBAbLLQL4Z2` |
| [Manufacturer and Supplier Finder](https://apify.com/mambalabs/manufacturer-supplier-finder?fpr=mamba) | `Qcsdmd0lUfPzVkonh` |
| [MCP Server Change and Health Monitor](https://apify.com/mambalabs/mcp-server-change-health-monitor?fpr=mamba) | `IeqjWF9U0BdDQFY08` |
| [Media URL Transcriber](https://apify.com/mambalabs/media-url-transcriber?fpr=mamba) | `Syfr7Ya3EsHgWfrB6` |
| [Medium Articles Scraper](https://apify.com/mambalabs/medium-articles-scraper?fpr=mamba) | `vw3X3RXnB353CXdxC` |
| [Meta Ad Library Ads by Company, Graph API](https://apify.com/mambalabs/meta-ad-library-monitor?fpr=mamba) | `J1GWlSXfSGU3u8Wng` |
| [Mobile Phone Waterfall](https://apify.com/mambalabs/mobile-phone-waterfall-orchestrator?fpr=mamba) | `6OOgPktf7RIa5XCOP` |
| [Multi Platform Social Posts and Comments](https://apify.com/mambalabs/multi-platform-social-posts-comments?fpr=mamba) | `icFuHR1EzDvUcfCQ5` |
| [Netherlands Rental Listings](https://apify.com/mambalabs/dutch-rental-listings?fpr=mamba) | `sGKGsbwoX18lFb6dR` |
| [New Hire Finder](https://apify.com/mambalabs/new-hire-finder?fpr=mamba) | `cKuc38p4nYHNF3IW8` |
| [Newly Registered Companies, UK, Norway, Finland, France](https://apify.com/mambalabs/new-company-registrations-feed?fpr=mamba) | `g2WfZhWvCtc57g2Jo` |
| [News and Media Mention Monitor](https://apify.com/mambalabs/news-media-mention-monitor?fpr=mamba) | `gol1PPUKrsIk4QLBd` |
| [News Site Article Archive](https://apify.com/mambalabs/news-site-article-archive?fpr=mamba) | `NjcF3UD8791raFNHh` |
| [Newsletter Sponsor Tracker](https://apify.com/mambalabs/newsletter-sponsor-tracker?fpr=mamba) | `qSwpqxD1TiPZpLQHv` |
| [Open Tender and RFP Finder](https://apify.com/mambalabs/open-tender-rfp-finder?fpr=mamba) | `kPTGz6t6TFoUUyfaO` |
| [Outbound Stack Detector](https://apify.com/mambalabs/outbound-infrastructure-fingerprint?fpr=mamba) | `v43UJC8r7qW7cBSTG` |
| [Page Finder and Extractor](https://apify.com/mambalabs/page-finder-extractor?fpr=mamba) | `TpurgcOZbVnknlaiC` |
| [Partner and Member Directory Extractor](https://apify.com/mambalabs/partner-member-directory-extractor?fpr=mamba) | `ZX0XJPPUvnFJxeC1a` |
| [People Finder & Email Verifier](https://apify.com/mambalabs/people-finder?fpr=mamba) | `LEgloG7tWgQl4o6TD` |
| [Perplexity Answer Reader](https://apify.com/mambalabs/perplexity-answer-reader?fpr=mamba) | `FUbX5uEE2C2jOl2xC` |
| [Person LinkedIn URL Resolver](https://apify.com/mambalabs/person-linkedin-url-resolver?fpr=mamba) | `ssuyPV8LnEsL8qbnb` |
| [Person Social Footprint Mapper](https://apify.com/mambalabs/person-social-footprint-mapper?fpr=mamba) | `jfQXa2zW9FHCJot9K` |
| [Personal Email to Company Resolver](https://apify.com/mambalabs/personal-email-to-company-resolver?fpr=mamba) | `AefT5Ye6YNPFQwJBf` |
| [Pinterest Brand Presence Mapper](https://apify.com/mambalabs/pinterest-brand-presence-mapper?fpr=mamba) | `d1HvjZfKhgvWsoEwn` |
| [Podcast Guest and Host Finder](https://apify.com/mambalabs/podcast-guest-host-finder?fpr=mamba) | `o2MGSvgbSLeeXOsIo` |
| [Private Company Funding History](https://apify.com/mambalabs/private-company-funding-history?fpr=mamba) | `H02K3rQIVOYpnLYc3` |
| [Product Hunt Daily Launches with Maker Domains](https://apify.com/mambalabs/product-hunt-launches-feed?fpr=mamba) | `O4VX63drWK9Y9x641` |
| [Property Owner Records](https://apify.com/mambalabs/property-owner-records?fpr=mamba) | `0J7ovG1iaZpQD1P0T` |
| [Prospect Engine](https://apify.com/mambalabs/b2b-prospect-engine?fpr=mamba) | `q9rT6v64nUJdPexOQ` |
| [Public Feature Board and Roadmap Monitor](https://apify.com/mambalabs/public-feature-board-roadmap-monitor?fpr=mamba) | `rcHF5gj5r2Vqnry35` |
| [Publishing Frequency Tracker](https://apify.com/mambalabs/blog-publishing-frequency?fpr=mamba) | `TbLwaUUATdYb6wp4N` |
| [Recent Funding Rounds Feed](https://apify.com/mambalabs/recent-funding-rounds-feed?fpr=mamba) | `KueVp9MOz7iOoAgDp` |
| [Reddit Brand Presence Mapper](https://apify.com/mambalabs/reddit-brand-presence-mapper?fpr=mamba) | `pKQZmDaT70SEb54bZ` |
| [Reddit Search and Thread Scraper](https://apify.com/mambalabs/reddit-search-thread-scraper?fpr=mamba) | `4Gsth5cP2Xt9V2xDN` |
| [Reporting Window Finder](https://apify.com/mambalabs/public-company-reporting-window-finder?fpr=mamba) | `uINxR7a1IW8qUTRUX` |
| [Research Topic Institutions and Authors](https://apify.com/mambalabs/research-topic-institutions-authors?fpr=mamba) | `OH8ANqt7bCKbo72Gk` |
| [Semrush Domain Metrics](https://apify.com/mambalabs/semrush-domain-metrics?fpr=mamba) | `3dqa0abJrpssHtrYL` |
| [Sequencer Event Poller](https://apify.com/mambalabs/sequencer-event-poller?fpr=mamba) | `S6s8Rjd61tGdrMRk4` |
| [Sequencer Lead Push](https://apify.com/mambalabs/clay-to-instantly-smartlead-push?fpr=mamba) | `0Jv27VeWM5tSZQs9x` |
| [Shopify App Store and Chrome Web Store Listings](https://apify.com/mambalabs/shopify-app-store-chrome-web-store-listings?fpr=mamba) | `gaY0BzkLyN77mD3wI` |
| [Site Crawler for Links and Tables](https://apify.com/mambalabs/site-crawler-links-tables?fpr=mamba) | `lLLJ6JxZ4XqN8ULz0` |
| [Sports Scores and Fixtures](https://apify.com/mambalabs/sports-scores-fixtures?fpr=mamba) | `yLoRnLcvqptp08cvX` |
| [Streaming Subscription Prices by Country](https://apify.com/mambalabs/streaming-subscription-prices-by-country?fpr=mamba) | `tbMroS2Zyn57bW17E` |
| [Substack Newsletter and Posts Scraper](https://apify.com/mambalabs/substack-scraper?fpr=mamba) | `UEFsdwiPLmPNVy9xd` |
| [Team Page People Extractor](https://apify.com/mambalabs/team-page-people-extractor?fpr=mamba) | `j8a9zX0k4mNbvDbWK` |
| [Tech Stack Signal Detector](https://apify.com/mambalabs/gtm-tech-stack-signal-scraper?fpr=mamba) | `qyd7nNyqFPelQViBx` |
| [Tennis Match Data](https://apify.com/mambalabs/tennis-match-data?fpr=mamba) | `v3OX6zxXHZOf2yurO` |
| [Threads Posts by Keyword, Exact Match](https://apify.com/mambalabs/threads-keyword-search?fpr=mamba) | `2OT8K8RiEEWtaj2MW` |
| [Threads Profile and Posts](https://apify.com/mambalabs/threads-profile-posts?fpr=mamba) | `MbwVXjHdBt01kr2aF` |
| [Ticketmaster Event Prices](https://apify.com/mambalabs/ticketmaster-event-prices?fpr=mamba) | `CrvPX4IwLXQX9bls1` |
| [TikTok Brand Presence Mapper](https://apify.com/mambalabs/tiktok-brand-presence-mapper?fpr=mamba) | `fco8FvoJcSafbeyd1` |
| [TikTok Video Stats](https://apify.com/mambalabs/tiktok-video-stats?fpr=mamba) | `uz9Q3cEycRgA6NfqA` |
| [Trustpilot Reputation Enricher](https://apify.com/mambalabs/review-platform-reputation-enricher?fpr=mamba) | `3lIqfCt61j4hqE1xz` |
| [US and UK Contract Award Winners by Company](https://apify.com/mambalabs/public-award-monitor?fpr=mamba) | `zhEtllASykOcx9hJ8` |
| [US Import Records Buyer Finder](https://apify.com/mambalabs/us-import-records-buyer-finder?fpr=mamba) | `VIMafpKF5ggOw0COU` |
| [VC and Accelerator Portfolio List Builder](https://apify.com/mambalabs/vc-accelerator-portfolio-list-builder?fpr=mamba) | `chH8hrfuoqqolW06m` |
| [Website Accessibility Checker, WCAG 2.2 AA](https://apify.com/mambalabs/wcag-accessibility-audit?fpr=mamba) | `P3jBj3FRghKEhX52z` |
| [Website Phrase and Business Model Classifier](https://apify.com/mambalabs/website-phrase-business-model-classifier?fpr=mamba) | `CBuZ9k7sRwBeiKiCS` |
| [Website Screenshot Capture](https://apify.com/mambalabs/website-screenshot-capture?fpr=mamba) | `nWd9M6qngY0sFiM8N` |
| [Website Traffic Rank Estimator](https://apify.com/mambalabs/website-traffic-rank-estimator?fpr=mamba) | `GnOFUzlNVIoXgeJjH` |
| [Work Email Waterfall](https://apify.com/mambalabs/email-waterfall-orchestrator?fpr=mamba) | `OT6xqTFThC0Rjf7Zj` |
| [Workplace Program Detector](https://apify.com/mambalabs/workplace-program-detector?fpr=mamba) | `Li6pPDhqbdzFz3h7G` |
| [X Brand Presence Mapper](https://apify.com/mambalabs/x-brand-presence-mapper?fpr=mamba) | `oLOgadhHUkNAyDA3w` |
| [YouTube Channel and Video List Scraper](https://apify.com/mambalabs/youtube-video-channel-scraper?fpr=mamba) | `txaAjeBqgj5MStFE4` |
| [YouTube Channel Email Finder](https://apify.com/mambalabs/youtube-channel-email-finder?fpr=mamba) | `IDgKZcmeeuunUbccN` |
| [YouTube Channel from Company Domain](https://apify.com/mambalabs/youtube-channel-transcript-extractor?fpr=mamba) | `6hSpD3kd2s2IQ4VSs` |
| [YouTube Shorts Scraper](https://apify.com/mambalabs/youtube-shorts-scraper?fpr=mamba) | `jUTHnhThr8jaI5ZQS` |
| [Zillow Listing Details](https://apify.com/mambalabs/zillow-listing-details?fpr=mamba) | `yG4zM0Enfsw2NefJ1` |

Built by [Mamba Labs](https://apify.com/mambalabs).

# Actor input Schema

## `categories` (type: `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` (type: `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` (type: `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` (type: `string`):

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` (type: `string`):

yes (default) returns the paid placements Houzz mixes into the results, labeled sponsored and without a rank. no returns organic results only.

## `dedupe` (type: `string`):

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` (type: `string`):

Optional. The run stops before a charge that would pass this amount. Summary rows are always returned.

## `source_tag` (type: `string`):

Internal attribution tag. Leave empty.

## Actor input object example

```json
{
  "categories": [
    "general contractor"
  ],
  "locations": [
    "Denver, CO"
  ],
  "max_results_per_search": "30",
  "include_sponsored": "yes",
  "dedupe": "yes"
}
```

# Actor output Schema

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

No description

## `run_summary` (type: `string`):

No description

# 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 = {
    "categories": [
        "general contractor"
    ],
    "locations": [
        "Denver, CO"
    ],
    "max_results_per_search": "30"
};

// Run the Actor and wait for it to finish
const run = await client.actor("mambalabs/houzz-professionals").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 = {
    "categories": ["general contractor"],
    "locations": ["Denver, CO"],
    "max_results_per_search": "30",
}

# Run the Actor and wait for it to finish
run = client.actor("mambalabs/houzz-professionals").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 '{
  "categories": [
    "general contractor"
  ],
  "locations": [
    "Denver, CO"
  ],
  "max_results_per_search": "30"
}' |
apify call mambalabs/houzz-professionals --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,mambalabs/houzz-professionals"
        }
    }
}
```

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/gv0DatXK2mOidqKLe/builds/e7UGDrLlX18ujdhGS/openapi.json
