# Hvacdirect — 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 HVAC equipment from HVACDirect's catalog, viewing detailed product specifications, pricing, images, and compatible accessories all in one place. Find exactly what you need by searching product names, model numbers, or browsing by category.

**Category:** E-commerce | **Website:** [hvacdirect.com/](https://hvacdirect.com/) | **Docs:** [parse.bot/marketplace/12c806fd-0d24-4678-a5b0-591f0dd5d8bc/hvacdirect-com-api](https://parse.bot/marketplace/12c806fd-0d24-4678-a5b0-591f0dd5d8bc/hvacdirect-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-hvacdirect-com-api-12c806fd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_category

Browse products within a specific category by URL slug. Returns paginated product listings parsed from the category page HTML. Use slugs from the get_categories endpoint subcategory URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category URL slug without .html extension (e.g. 'air-conditioner-condensers', 'furnaces') |
| `page` | integer | No | Page number for pagination |

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

### get_categories

Retrieve the site's top-level category navigation structure including main categories and their subcategories with URLs. Useful for discovering valid category slugs to pass to browse_category.

**Estimated cost:** Metered

_No parameters required._

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

### get_product_accessories

Get recommended accessories and related products for a specific item. Returns accessories found on the product page including cross-sell and upsell items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL or path |

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

### get_product_details

Retrieve full details for a product including specifications, description, images, stock status, and pricing. This is the canonical point-lookup for a single product by its URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL or path (e.g. 'https://hvacdirect.com/aciq-12-000-btu-ptac-heat-pump-air-conditioner-unit-with-3-5kw-electric-heater.html') |

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

### get_product_images

Get all available images for a product. Returns an object containing an array of image URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL or path |

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

### get_product_pricing

Get the current and original pricing for a product along with its SKU. Lightweight alternative to get_product_details when only price information is needed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL or path |

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

### get_product_specifications

Retrieve technical specifications for a product as key-value pairs wrapped in a specifications object.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full product URL or path |

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

### search_by_model_number

Search for a product by its model number or SKU. Returns exact matches from the autocomplete API, falling back to full text search when no autocomplete results are found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Model number or SKU to search for (e.g. 'STN855W', 'TH6320WF2003') |

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

### search_products

Full-text search over the product catalog via FastSimon. Returns matching products sorted by relevance or price. For common search terms that map to categories, results come from the autocomplete API with a category_url field. All results are returned in a single page; upstream does not reliably support multi-page traversal.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword (e.g. 'thermostat wifi', 'heat pump') |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hvacdirect-com-api-12c806fd/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>","sort":"<string>"}'
```