Skip to content

About

Houzz data integration examples: collect photos, products and professional profiles with Python, JavaScript or cURL, then export JSON and CSV.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Houzz scraper Python examples and CSV export

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.

What this repository helps you do

  • Read photo-category results as structured records.
  • Combine known photo URLs in one bounded run.
  • Export saved data to CSV without another run.

Example result

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"
}

Run without code

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.

Try it with Apify's free plan

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.

Quick start for developers

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

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

Input example

{
  "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.

Request examples

Output fields

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.

Common use cases

Compare design inspiration, organize public project portfolios or prepare spreadsheet reports. See workflow ideas.

Export Houzz photos to CSV with Python

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.

Collect several Houzz photo URLs in one run

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.

FAQ

See answers about scope, credentials and partial results. No contractor search by city, email discovery or exhaustive review coverage is promised.

Limits and pricing

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.

Hosted version

Run Houzz Scraper on Apify to use web input, API execution and Dataset exports. Some links contain an affiliate referral parameter.

Responsible use

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.

Support

For examples, open an issue. For hosted runs use the Actor's support options and include a run ID, never a token.

License

MIT applies to this repository's documentation and examples, not third-party source content or the hosted Actor implementation.

About

Houzz data integration examples: collect photos, products and professional profiles with Python, JavaScript or cURL, then export JSON and CSV.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors