# Backcountry — 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.

> Backcountry provides 4 callable API endpoints through the Parse marketplace.

**Category:** E-commerce | **Website:** [backcountry.com/](https://backcountry.com/) | **Docs:** [parse.bot/marketplace/c756a20c-bde5-434b-ad5c-c056a71f3842/backcountry-com-api](https://parse.bot/marketplace/c756a20c-bde5-434b-ad5c-c056a71f3842/backcountry-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-backcountry-com-api-c756a20c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_products

Browse products by category ID slug. Returns paginated product listings for the specified category with the same product shape as search. Category IDs are slugs like 'bc-mens-clothing', 'bc-womens-clothing', 'bc-hike-camp', 'bc-ski', 'bc-climb', 'bc-kids', 'bc-snowboard', 'bc-bike'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Pagination cursor from page_info.pages[].cursor in a previous response. Pass to fetch the corresponding page. |
| `category` | string | Yes | Category ID slug (e.g. 'bc-mens-clothing', 'bc-hike-camp', 'bc-ski', 'bc-womens-clothing', 'bc-climb', 'bc-kids', 'bc-snowboard', 'bc-bike'). |
| `limit` | integer | No | Max results to return per page. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-backcountry-com-api-c756a20c/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","category":"<string>","limit":"<integer>","sort":"<string>"}'
```

### get_product_details

Get product details for a specific product by its URL slug. Returns product info including pricing aggregates, available colors, ratings, stock status, and flags. The slug is the URL path segment (e.g. from the url field in search results, without the leading slash).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product URL slug (e.g. 'patagonia-nano-puff-insulated-jacket-mens', 'the-north-face-1996-retro-nuptse-jacket-mens'). |

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

### list_all_brands

Get a list of top brands sold on Backcountry.com with approximate product counts. Brands are aggregated from multiple product category searches and sorted by product count descending. Returns hundreds of brands covering the full outdoor gear ecosystem.

**Estimated cost:** Metered

_No parameters required._

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

### search_products

Full-text search over Backcountry.com product catalog. Returns paginated product listings matching the query keyword, with pricing aggregates, ratings, available colors, and stock status. Paginates via cursor-based pages; each page returns up to `limit` results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Pagination cursor from page_info.pages[].cursor in a previous response. Pass to fetch the corresponding page. |
| `limit` | integer | No | Max results to return per page. |
| `query` | string | Yes | Search keyword (e.g. 'jacket', 'backpack', 'hiking shoes'). |
| `sort` | string | No | Sort order for results. |

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