# Chairish — 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 and browse vintage furniture and decor listings on Chairish, view detailed product information with pricing and availability, and research sellers through their profiles and customer reviews. Explore product categories and discover shop recommendations to find exactly what you're looking for.

**Category:** Marketplaces | **Website:** [chairish.com/](https://chairish.com/) | **Docs:** [parse.bot/marketplace/0dba2ab5-3873-4dd0-9304-41c58f2a68e2/chairish-com-api](https://parse.bot/marketplace/0dba2ab5-3873-4dd0-9304-41c58f2a68e2/chairish-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-chairish-com-api-0dba2ab5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Retrieve full details for a single product including price, availability, brand, category, images, and seller information. Requires both the numeric product ID and the URL slug (both available from search or category listing results).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Numeric product ID (e.g. '35701720'). Available from search_products or list_category_products results. |
| `slug` | string | Yes | Product URL slug (e.g. 'vintage-cane-back-florals-chairs-a-pair'). Available from the URL path in search results. |

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

### get_seller_profile

Retrieve a seller profile including their name, description, location, and active product listings. The shop_id is the slug from the shop URL (available from get_product_details seller.id or search_shops results).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shop_id` | string | Yes | Shop slug identifier (e.g. 'stark-studio-rugs'). Available from get_product_details seller.id or search_shops results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chairish-com-api-0dba2ab5/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shop_id":"<string>"}'
```

### get_seller_reviews

Retrieve verified buyer reviews for a shop. Requires the short alphanumeric dealer GUID (not the shop slug). Returns reviews with rating, content, author, date, and purchased item info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `shop_id` | string | Yes | Short alphanumeric dealer GUID (e.g. '2dfzah'). Available from search_products or list_category_products results[*].dealer_guid. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chairish-com-api-0dba2ab5/get_seller_reviews \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","shop_id":"<string>"}'
```

### list_category_products

Browse products within a specific Chairish category. Returns paginated product listings in the same shape as search. Category slugs correspond to top-level site navigation (furniture, art, rugs, lighting, etc.).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug (e.g. 'furniture', 'art', 'rugs', 'lighting'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-chairish-com-api-0dba2ab5/list_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>"}'
```

### search_products

Full-text search over Chairish product listings. Returns paginated results with basic product info including title, price, category taxonomy, and seller GUID. Pagination via page number; total_count may be null if the site does not surface it for the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'chair', 'modern rugs'). |

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

### search_shops

Search for shops and dealers by keyword. Returns a list of matching shop names with their slugs and URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Shop name or keyword to search for. |

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

### search_suggestions

Get search autocomplete suggestions for a partial query. Returns keyword and shop suggestions with display text and URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search term to get suggestions for. |

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