# The North Face — 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 The North Face's full product catalog by category, then access detailed information including specifications, pricing, and real-time inventory levels for any item. Find exactly what you're looking for with powerful product search and get complete product details in one place.

**Category:** E-commerce | **Website:** [thenorthface.com/](https://thenorthface.com/) | **Docs:** [parse.bot/marketplace/6ef95064-c449-441c-aca5-03788cf0857a/thenorthface-com-api](https://parse.bot/marketplace/6ef95064-c449-441c-aca5-03788cf0857a/thenorthface-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-thenorthface-com-api-6ef95064/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_category_listing

Get the global category navigation structure (mega menu). Returns hierarchical category tree with names, URLs, and category IDs for Men's, Women's, Kids, Bags & Gear, and more. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### get_category_products

Get products within a specific category by category ID. The category ID is a numeric identifier (extracted from the trailing digits of the category slug). Returns paginated product listings. The upstream API requires a minimum count of 5.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Category ID or slug with trailing numeric ID (e.g. 'mens-jackets-and-vests-211702' or '211702'). The numeric portion is extracted and used as the category filter. |
| `count` | integer | No | Number of results per page (minimum 5) |
| `start` | integer | No | Offset for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thenorthface-com-api-6ef95064/get_category_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id":"<string>","count":"<integer>","start":"<integer>"}'
```

### get_product_detail

Get comprehensive product details including description, features, variants with stock and pricing, gallery images, color/size attributes, and ratings. Returns a single product's full specification.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `color` | string | No | Optional color code to filter variants (e.g. 'DIW', '4H0') |
| `style_id` | string | Yes | Product style ID (e.g. 'NF0A3C8D', 'NF0A7UQJ') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thenorthface-com-api-6ef95064/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"color":"<string>","style_id":"<string>"}'
```

### get_product_inventory

Get real-time inventory and availability for all variants of a product. Returns stock status (InStock/OutOfStock), maximum available quantity, and pricing per size/color/fit combination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `style_id` | string | Yes | Product style ID (e.g. 'NF0A3C8D', 'NF0A7UQJ') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thenorthface-com-api-6ef95064/get_product_inventory \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"style_id":"<string>"}'
```

### search_products

Full-text search over The North Face product catalog. Returns paginated product listings with pricing, ratings, and color swatches. Supports sorting and filter strings. The upstream API requires a minimum count of 5.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `count` | integer | No | Number of results per page (minimum 5) |
| `filters` | string | No | Filter string using pipe-separated field:value pairs (e.g. 'colorFamily:Black') |
| `query` | string | Yes | Search keyword (e.g. 'jacket', 'fleece', 'backpack') |
| `sort` | string | No | Sort option for results. |
| `start` | integer | No | Offset for pagination |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-thenorthface-com-api-6ef95064/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count":"<integer>","filters":"<string>","query":"<string>","sort":"<string>","start":"<integer>"}'
```