# Holts — 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 Holts Cigar Co.'s complete product catalog across all brands, and access customer and staff reviews to help guide your cigar purchases. Get detailed product information, brand listings, and paginated review data all in one place.

**Category:** E-commerce | **Website:** [holts.com/](https://holts.com/) | **Docs:** [parse.bot/marketplace/ce8bd6d2-0b7d-4708-a4a1-397f9d084cc2/holts-com-api](https://parse.bot/marketplace/ce8bd6d2-0b7d-4708-a4a1-397f9d084cc2/holts-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-holts-com-api-ce8bd6d2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_brands

Retrieve the complete list of all cigar brands on Holts.com. Returns brand names and their page URLs. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### get_brand_products

Get product list and metadata for a specific brand page. Extracts category_id (for get_product_reviews) and product_line_id (for get_staff_review). Products include name, price, and optionally size dimensions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the brand page (e.g. 'https://www.holts.com/cigars/all-cigar-brands/montecristo-white.html'). Obtain from search_cigars or get_all_brands results. |

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

### get_product_reviews

Paginated customer reviews for a category/product line. Returns up to 10 reviews per page with reviewer info, rating, and text. Requires category_id from get_brand_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID extracted from get_brand_products.category_id. |
| `direction` | string | No | Sort direction. |
| `page` | integer | No | Page number for pagination (1-based). |
| `sort` | string | No | Field to sort reviews by. |

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

### get_staff_review

Retrieve the editorial staff review for a product line. Returns full review text (HTML), score out of 100, publication date, and author details. Requires product_line_id from get_brand_products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_line_id` | string | Yes | Product line ID extracted from get_brand_products.product_line_id. |

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

### search_cigars

Full-text keyword search across cigar product lines and accessories. Returns matching products with name, price range, rating, review count, and image. Results are not paginated; a single page of matches is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'montecristo', 'romeo', 'rocky patel'). |

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