# Boat Lifestyle — 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.

> Browse and search boAt Lifestyle’s product catalog, and fetch detailed product information (pricing and variants) by product handle.

**Category:** E-commerce | **Website:** [boat-lifestyle.com/](https://boat-lifestyle.com/) | **Docs:** [parse.bot/marketplace/0d9c858e-43ae-408f-b578-d4bf36667430/boat-lifestyle-com-api](https://parse.bot/marketplace/0d9c858e-43ae-408f-b578-d4bf36667430/boat-lifestyle-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-boat-lifestyle-com-api-0d9c858e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_all_products

Auto-paginate through the boAt catalog and return a combined product list. Fetches multiple pages sequentially, stopping at max_pages or max_items. Returns a summary with total count, pages fetched, and whether more data is available. For precise page control, use list_products with manual cursor advancement.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `delay_s` | number | No | Delay between page fetches in seconds (0-2). |
| `max_items` | integer | No | Maximum number of items to return before stopping. |
| `max_pages` | integer | No | Maximum number of pages to fetch before stopping. |
| `page_size` | integer | No | Products per page to fetch (1-250). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boat-lifestyle-com-api-0d9c858e/get_all_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"delay_s":"<number>","max_items":"<integer>","max_pages":"<integer>","page_size":"<integer>"}'
```

### get_product_by_handle

Fetch a single product by its handle (the URL slug from boat-lifestyle.com/products/<handle>). Returns full product details including description, tags, product type, vendor, and up to 100 variants with their individual prices and option selections. Returns input_not_found if the handle does not match any product.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handle` | string | Yes | Product handle — the last path segment of the product URL (e.g. 'nirvana-uno' from https://www.boat-lifestyle.com/products/nirvana-uno). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boat-lifestyle-com-api-0d9c858e/get_product_by_handle \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"handle":"<string>"}'
```

### list_products

List products from the boAt catalog with cursor-based pagination. Each page returns up to 250 products with name, price range, buy link, and availability. Use end_cursor to advance to the next page. Products are ordered by internal catalog position.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response's end_cursor. Omit to start from the beginning. |
| `limit` | integer | No | Number of products to return per page (1-250). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-boat-lifestyle-com-api-0d9c858e/list_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cursor":"<string>","limit":"<integer>"}'
```

### search_products

Full-text search over the boAt product catalog using Shopify Storefront search syntax. Simple keywords match title and body; prefix with 'title:' to restrict to product titles only. Returns matching products with cursor-based pagination. An empty result set means no products matched the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cursor` | string | No | Pagination cursor from a previous response's end_cursor. |
| `limit` | integer | No | Number of results to return (1-250). |
| `query` | string | Yes | Search query (e.g. 'earbuds', 'title:airdopes', 'bluetooth speaker'). |

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