# Houzz Product Scraper

Scrape product titles, prices, ratings, etc from Houzz by product URLs.

- Template page: [https://www.octoparse.com/template/houzz-product-scraper](https://www.octoparse.com/template/houzz-product-scraper)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from detail pages.

## Output

The current workflow extracts 19 fields, including `Assembly_required`, `Category`, `Collection`, `MPN`, `Manufacturer`, `Materials`, `Number_of_reviews`, `Original_price`, `Page_URL`, `Price`, `Product_ID`, `Product_description`, `Rating`, `Returns`, `Shipping_information`, `Size_Weight`, `Sold_By`, `Style`, `Title`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete Product URL (up to 1,000 per run) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Product URL (up to 1,000 per run)

Required. Enter the product URLs ie. https://www.houzz.com/product/124056556-antique-farmhouse-full-length-leaner-mirror-black-farmhouse-floor-mirrors Constraints: minItems=1; maxItems=1000; items.minLength=0; items.maxLength=10000.

## How to Use

# Houzz Product Scraper – Usage Guide

Visits submitted Houzz product pages and extracts product, price, rating, shipping, seller, manufacturer, specifications, materials, return, and category information.

**Pricing:** Free (no per-line fee; Octoparse plan/resource limits may apply).

## Input

- **Product URL** (Required) – Enter up to 1,000 product detail page URLs per run.  
  Example: `https://www.houzz.com/product/124056556-antique-farmhouse-full-length-leaner-mirror-black-farmhouse-floor-mirrors`

## Output Fields

| Field | Description |
|-------|-------------|
| `Title` | Product name |
| `Number_of_reviews` | Review count |
| `Price` | Current price |
| `Original_price` | Original/list price |
| `Shipping_information` | Shipping details |
| `Rating` | Star rating (e.g., "5 out of 5 stars") |
| `Product_description` | Full description |
| `MPN` | Manufacturer part number |
| `Product_ID` | Houzz product ID |
| `Manufacturer` | Brand/manufacturer |
| `Sold_By` | Seller name |
| `Size_Weight` | Dimensions and weight |
| `Materials` | Material composition |
| `Assembly_required` | "Yes" or "No" |
| `Category` | Product category |
| `Style` | Style designation |
| `Collection` | Collection name |
| `Returns` | Return policy text |
| `Page_URL` | URL of the scraped page |

Example output JSON:

```json
{
  "Title": "40\" Industrial Black Rectangle Mirror",
  "Number_of_reviews": "3",
  "Price": "$145",
  "Original_price": "$174",
  "Shipping_information": null,
  "Rating": "5 out of 5 stars",
  "Product_description": "This thin frame...",
  "MPN": "W00546",
  "Product_ID": "185166672",
  "Manufacturer": "FIND",
  "Sold_By": "Houzz",
  "Size_Weight": "W 20\" / D 1.22\" / H 40\" / 12.41 lb.",
  "Materials": "PS MOULDING,MIRROR,MDF,PAPER",
  "Assembly_required": "No",
  "Category": "Bathroom Mirrors",
  "Style": "Transitional",
  "Collection": "2022 Spring",
  "Returns": "Houzz offers a 30-day standard return policy...",
  "Page_URL": "https://www.houzz.com/products/40-industrial-black-rectangle-mirror-prvw-vr~185166672"
}
```

## How to Use

1. Open **Houzz Product Scraper** and click **Try it!**.
2. Fill in the **Product URL** field (up to 1,000 entries).
3. Choose a local or cloud run in Octoparse and start the task.
4. Review the extracted fields, then export (CSV, JSON, Excel, etc.).

## Tips

- Test one URL first before submitting a large batch.
- Keep `Page_URL` in your export to trace each row back to its source page.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Houzz Professional Scraper](https://www.octoparse.com/template/houzz-professional-scraper)
- [Houzz URL List Scraper](https://www.octoparse.com/template/houzz-url-list-scraper)
- [Amazon Japan Product Scraper](https://www.octoparse.com/template/amazon-japan-product-scraper)
- [Etsy Product Scraper (by URL)](https://www.octoparse.com/template/etsy-product-scraper-by-url)
- [MercadoLibre Product Details Scraper](https://www.octoparse.com/template/mercadolibre-detalles-scraper)

## Input Schema

```json
{
  "title": "Houzz Product Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "product_URL": {
      "title": "Product URL (up to 1,000 per run)",
      "description": "Enter the product URLs ie. https://www.houzz.com/product/124056556-antique-farmhouse-full-length-leaner-mirror-black-farmhouse-floor-mirrors",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 0,
        "maxLength": 10000
      },
      "minItems": 1,
      "maxItems": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "product_URL"
  ]
}
```

## Input JSON Example

No verified real input/output examples are currently available.


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "Assembly_required": {
      "type": "string",
      "description": ""
    },
    "Category": {
      "type": "string",
      "description": ""
    },
    "Collection": {
      "type": "string",
      "description": ""
    },
    "MPN": {
      "type": "string",
      "description": ""
    },
    "Manufacturer": {
      "type": "string",
      "description": ""
    },
    "Materials": {
      "type": "string",
      "description": ""
    },
    "Number_of_reviews": {
      "type": "string",
      "description": ""
    },
    "Original_price": {
      "type": "string",
      "description": ""
    },
    "Page_URL": {
      "type": "string",
      "description": ""
    },
    "Price": {
      "type": "string",
      "description": ""
    },
    "Product_ID": {
      "type": "string",
      "description": ""
    },
    "Product_description": {
      "type": "string",
      "description": ""
    },
    "Rating": {
      "type": "string",
      "description": ""
    },
    "Returns": {
      "type": "string",
      "description": ""
    },
    "Shipping_information": {
      "type": "string",
      "description": ""
    },
    "Size_Weight": {
      "type": "string",
      "description": ""
    },
    "Sold_By": {
      "type": "string",
      "description": ""
    },
    "Style": {
      "type": "string",
      "description": ""
    },
    "Title": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Houzz Product Scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

No verified real input/output examples are currently available.

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

No verified real input/output examples are currently available.

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `houzz-product-scraper`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/houzz-product-scraper.json)
- [Manifest](https://www.octoparse.com/templates/houzz-product-scraper-manifest.json)
