# Backcountry — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/backcountry/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/backcountry/get-category-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/backcountry/get-product-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/backcountry/list-all-brands \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/backcountry/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","limit":"<integer>","query":"<string>","sort":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.