# Boot Barn — 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 Boot Barn's catalog of western wear and cowboy boots by keyword with customizable filters, view detailed product information, and discover related items through search suggestions. Find exactly what you're looking for with autocomplete recommendations while browsing Boot Barn's full selection of authentic western apparel and footwear.

**Category:** E-commerce | **Website:** [www.bootbarn.com/](https://www.bootbarn.com/) | **Docs:** [parse.bot/marketplace/2f2146f7-d491-4432-bb95-fd96a8db83ef/bootbarn-com-api](https://parse.bot/marketplace/2f2146f7-d491-4432-bb95-fd96a8db83ef/bootbarn-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-bootbarn-com-api-2f2146f7/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product_details

Retrieve full product details including description, images, available colors, price, and rating. Accepts either a product_url (from search results, most reliable) or a product_id (performs a search lookup which may not find all products). Returns a single product's complete information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | No | Alphanumeric product ID (e.g., '038A96', '2000401240'). Either product_url or product_id is required. Uses search lookup which may not find all products. |
| `product_url` | string | No | Full product URL from search results (e.g., 'https://www.bootbarn.com/roper-mens-faux-ostrich-cowboy-boots---broad-square-toe/038A96.html?dwvar_038A96_color=7049'). Either product_url or product_id is required. |

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

### get_search_suggestions

Autocomplete endpoint returning keyword suggestions and optionally suggested products for a partial query. Useful for building search-as-you-type interfaces. Returns up to 5 keyword suggestions; product suggestions may be empty depending on the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Partial search query for suggestions (e.g., 'cow', 'boot') |

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

### search_products

Full-text search over Boot Barn's product catalog. Returns paginated results (24 per page) with product summaries including price, brand, rating, and discount info. Supports filtering by brand and gender, and sorting by various criteria. Pagination via page number; total_results may be null when the site omits the count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Filter by brand name (e.g., 'Ariat', 'Cody James', 'Wrangler') |
| `gender` | string | No | Filter by gender (e.g., "Men's", "Women's", "Boys'", "Girls'") |
| `page` | integer | No | Page number (1-based) |
| `query` | string | Yes | Search keyword (e.g., 'cowboy boots', 'western hat', 'jeans') |
| `sort` | string | No | Sort order for results |

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