Use Houzz Scraper to collect public content from supplied URLs or IDs. This independent integration guide contains Python, JavaScript and cURL examples, not the hosted scraper implementation.
- Read photo-category results as structured records.
- Combine known photo URLs in one bounded run.
- Export saved data to CSV without another run.
Excerpt from a real photo record; complete records are in sample JSON and a selected-column CSV. Source results can change.
{
"recordType": "photo",
"id": "82999621",
"title": "Stylish Storage",
"url": "https://www.houzz.com/photos/stylish-storage-traditional-kitchen-philadelphia-phvw-vp~82999621",
"imageUrl": "https://st.hzcdn.com/simgs/2f215d7c087eebd3_9-7903/home-design.jpg"
}Open the Actor, paste URLs into Houzz URLs, set Maximum results, then click Start. Inspect the Dataset and summary before exporting JSON or CSV. See the walkthrough.
Apify's Free plan includes $5 in monthly prepaid usage with no credit card required. Unused credits expire each billing cycle. This is a limited credit allowance, not unlimited free runs. Check current plan terms.
Use Python 3.11 or newer. Install the client:
pip install -r examples/python/requirements.txt
export APIFY_API_TOKEN="your-token"
python examples/python/request.pyOn PowerShell, set $env:APIFY_API_TOKEN = "your-token" before running Python. Keep real tokens out of files and version control. The live examples cap result-event spending at $0.01 per run and run time at 300 seconds; check current platform billing separately.
{
"houzzUrls": [
"https://www.houzz.com/photos/kitchen-ideas-and-designs-phbr0-bp~t_709"
],
"photoTopics": [],
"photoIds": [],
"professionalIds": [],
"professionalUsernames": [],
"productIds": [],
"questionIds": [],
"galleryIds": [],
"includeProfessionalProjects": true,
"includeProjectDetails": false,
"includeProductReviews": true,
"includeAnswers": true,
"includeComments": false,
"maxPhotosPerTopic": 5,
"maxProjectsPerProfessional": 5,
"maxItems": 10
}The input reference covers all supported fields.
- Python single run
- Python photo batch
- Python CSV export
- cURL
- JavaScript: run
npm install --prefix examples/javascript, set APIFY_API_TOKEN and runnode examples/javascript/request.mjs.
| Field | Meaning |
|---|---|
| recordType | Entity type; do not mix unlike records in analysis |
| id | Identity within that type |
| title | Public content title when available |
| url | Source page |
| imageUrl | Image link when available |
See the output reference and complete JSON sample.
Compare design inspiration, organize public project portfolios or prepare spreadsheet reports. See workflow ideas.
Run python examples/python/export_csv.py --output houzz-results.csv to export the included sample. Supply --input your-results.json for an existing Dataset export. Existing destination files are never overwritten.
Run python examples/python/batch_photos.py. Edit its two URLs to select different supported photos and adjust the result cap deliberately. Batching does not make result events free.
See answers about scope, credentials and partial results. No contractor search by city, email discovery or exhaustive review coverage is promised.
Pay per event: each unique public content record delivered is one result event, including related entities. Free tier: $0.001 per event ($1.00 per 1,000); Bronze: $0.0009 ($0.90 per 1,000); Silver: $0.0008 ($0.80 per 1,000); Gold, Platinum and Diamond: $0.00075 ($0.75 per 1,000). See current Actor pricing.
maxItems accepts up to 5,000 records and counts related entities too; this is an input ceiling, not a guarantee of available data. Public content availability varies. Check the summary for partial outcomes. Photo category filters beyond the category itself are not reproduced.
Run Houzz Scraper on Apify to use web input, API execution and Dataset exports. Some links contain an affiliate referral parameter.
Respect applicable terms, privacy obligations and content rights. Image URLs do not transfer image ownership. This project is not affiliated with Houzz. Never commit credentials.
For examples, open an issue. For hosted runs use the Actor's support options and include a run ID, never a token.
MIT applies to this repository's documentation and examples, not third-party source content or the hosted Actor implementation.