# Houzz — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for home decor and furniture products, view detailed information and customer reviews, find professional designers and contractors with their ratings, and browse design inspiration photos all in one place. Build your ideal home by accessing comprehensive product catalogs, professional portfolios, and curated design ideas from the Houzz marketplace.

**Category:** Marketplaces | **Website:** [houzz.com/](https://houzz.com/) | **Docs:** [parse.bot/marketplace/993d0ec1-5bf8-4702-be99-ed6be361071a/houzz-com-api](https://parse.bot/marketplace/993d0ec1-5bf8-4702-be99-ed6be361071a/houzz-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Get detailed product information from ShopHouzz using Constructor.io search. Returns product data including pricing, images, materials, style, and variations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug from the product URL, including the prvw-vr-{id} suffix (e.g. 'milan-3-seat-sofa-prvw-vr-200753227'). Obtainable from search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/get_product_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_product_reviews

Get customer reviews for a product using the Yotpo API. Returns review data including ratings, pagination info, and product social links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number |
| `product_id` | string | Yes | Product ID from search_products results (product_id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/get_product_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","product_id":"<string>"}'
```

### get_professional_profile

Get full professional profile data including contact info, badges, awards, service areas, and project counts. Extracts structured data from the profile page's SSR context.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full professional profile URL from search_professionals results (e.g. 'https://www.houzz.com/professionals/plumbers/public-plumbing-pfvwus-pf~1040192656') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/get_professional_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_professional_reviews

Get paginated reviews for a specific professional using the AJAX reviews endpoint. Returns review text, ratings, dates, and reviewer names. Requires user_id and pro_id from search_professionals or get_professional_profile results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of reviews per page |
| `offset` | integer | No | Pagination offset (number of reviews to skip) |
| `pro_id` | string | Yes | Professional ID (from search_professionals results pro_id field) |
| `profile_url` | string | No | Profile URL for obtaining CSRF token. If omitted, token is obtained from main site. |
| `user_id` | string | Yes | User ID of the professional (from search_professionals results user_id field) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/get_professional_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","offset":"<integer>","pro_id":"<string>","profile_url":"<string>","user_id":"<string>"}'
```

### search_ideas_photos

Search for design inspiration photos by query, room type, or style. Returns a list of photo metadata (dimensions, IDs) for home design photos from Houzz's photo gallery. At least one of query, room, or style should be provided for meaningful results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `offset` | integer | No | Pagination offset |
| `query` | string | No | Search query (e.g. 'modern kitchen', 'small bathroom') |
| `room` | string | No | Room type (e.g. 'kitchen', 'bathroom', 'bedroom', 'living-room') |
| `style` | string | No | Design style (e.g. 'modern', 'traditional', 'contemporary', 'farmhouse') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/search_ideas_photos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"offset":"<integer>","query":"<string>","room":"<string>","style":"<string>"}'
```

### search_products

Search for products on ShopHouzz using Constructor.io. Returns paginated product listings with pricing, images, and ratings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Results per page |
| `page` | integer | No | Page number |
| `query` | string | Yes | Search keyword (e.g. 'chairs', 'modern sofa') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```

### search_professionals

Search for home professionals (contractors, designers, plumbers, etc.) by category and location slug. Returns a paginated list of professionals with contact info, ratings, and profile URLs. Data is extracted from SSR page content. Pagination uses offset parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Professional category slug (e.g. 'plumbing-contractors', 'architects-and-building-designers', 'interior-designers', 'general-contractors', 'landscape-architects-and-landscape-designers') |
| `location` | string | No | Location slug from Houzz URL structure (e.g. 'toronto-on-ca-probr0-bo~t_11817~r_6167865', 'new-york-metro-area-probr0-bo~r_4702389') |
| `offset` | integer | No | Pagination offset (number of results to skip) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-houzz-com-api-993d0ec1/search_professionals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","location":"<string>","offset":"<integer>"}'
```