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

> Discover and explore professional interior designers and architects by searching their profiles, viewing their completed projects, reading client reviews, and browsing design inspiration photos from Homify's curated collection. Access room design categories, magazine articles, DIY guides, and detailed project information to find inspiration and connect with design professionals.

**Category:** Business Directories | **Website:** [homify.com/](https://homify.com/) | **Docs:** [parse.bot/marketplace/deebe501-b363-47b0-b842-aff06770d8c2/homify-com-api](https://parse.bot/marketplace/deebe501-b363-47b0-b842-aff06770d8c2/homify-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-homify-com-api-deebe501/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_diy_guides

List DIY guides with step-by-step instructions, difficulty levels, and cost estimates. Returns paginated project results with full details including steps, materials, and author information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | string | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/get_diy_guides \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<string>"}'
```

### get_magazine_article_detail

Get full content of a magazine article including title and content sections (text paragraphs and photos). The url_path is obtainable from get_magazine_articles results via the url field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | Article URL path (e.g. /ideabooks/9929571/la-camera-da-letto-perfetta-per-un-gamer). Obtainable from get_magazine_articles results via url field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/get_magazine_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_path":"<string>"}'
```

### get_magazine_articles

List magazine articles with title, excerpt, author, date, and image. Returns paginated results ordered by recency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | string | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/get_magazine_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<string>"}'
```

### get_professional_profile

Get the full profile page data of a professional, including JSON-LD structured data and professional info extracted from the page. The url_path is obtainable from search_professionals results via the resourcePath field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | Professional URL path (e.g. /professionals/7150862/jb-movers-los-angeles). Obtainable from search_professionals results via resourcePath field. |

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

### get_professional_projects

Get the list of projects for a specific professional. Returns project titles, URLs, and thumbnail images. The /projects suffix is appended automatically to the url_path.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | Professional URL path (e.g. /professionals/7150862/jb-movers-los-angeles). The /projects suffix is appended automatically. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/get_professional_projects \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_path":"<string>"}'
```

### get_professional_reviews

Get reviews for a specific professional. Returns an array of reviews with author, body, rating, and date. Returns an empty array if the professional has no reviews.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | Professional URL path (e.g. /professionals/7150862/jb-movers-los-angeles). The /reviews suffix is appended automatically. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/get_professional_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_path":"<string>"}'
```

### get_project_details

Get full details of a project including photos, description, style, and metadata. Project URLs are available from get_professional_projects results via the url field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url_path` | string | Yes | Project URL path (e.g. /projects/657639/jb-movers-los-angeles). Obtainable from get_professional_projects results via url field. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/get_project_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url_path":"<string>"}'
```

### get_room_categories

Get room and style categories for browsing photos. Returns hierarchical room categories (some with sub-items) and style categories, each with IDs usable in search_rooms_photos.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/get_room_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_professional_categories

List all available professional categories grouped by type (e.g. Filter by Type, Handyman, Products for the Home, Construction & Renovation). Each category includes an ID usable in search_professionals.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/list_professional_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_professionals

Search for professionals on homify.com with optional query, category, and country filters. Returns paginated results including professional details such as name, city, category, review stats, and sample photos. Use list_professional_categories to discover valid category_id values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | No | Professional category ID to filter by (from list_professional_categories). |
| `country` | string | No | Country code for filtering professionals (e.g. US, DE, GB). |
| `page` | string | No | Page number for pagination. |
| `query` | string | No | Search query keyword to filter professionals. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/search_professionals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","country":"<string>","page":"<string>","query":"<string>"}'
```

### search_rooms_photos

Search for rooms and inspiration photos on homify.com. Returns paginated photo results with image URLs and metadata. Use get_room_categories to discover valid room_id and style_id values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | string | No | Page number for pagination. |
| `query` | string | No | Search query keyword. |
| `room_id` | string | No | Room category ID (from get_room_categories). |
| `style_id` | string | No | Style category ID (from get_room_categories). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/search_rooms_photos \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<string>","query":"<string>","room_id":"<string>","style_id":"<string>"}'
```

### search_site

Search across professionals and rooms simultaneously. Combines results from both the professionals and rooms APIs into a single response for a unified search experience.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-homify-com-api-deebe501/search_site \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```