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

> Access real-time Supreme shop status, browse current and upcoming product listings with previews, and explore collections by category. Discover Supreme news, lookbooks, seasonal releases, and find store locations worldwide.

**Category:** E-commerce | **Website:** [supreme.com/](https://supreme.com/) | **Docs:** [parse.bot/marketplace/7906e447-05f7-4573-bfb1-d5764400a79c/supreme-com-api](https://parse.bot/marketplace/7906e447-05f7-4573-bfb1-d5764400a79c/supreme-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-supreme-com-api-7906e447/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_about

Get Supreme 'About' page content including the brand history text. Returns structured body blocks and extracted plain text paragraphs.

**Estimated cost:** Metered

_No parameters required._

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

### get_categories

Get list of product categories for a given season. Each category has a title and URL path within the season preview.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Season slug (e.g. 'springsummer2026', 'fallwinter2025') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-supreme-com-api-7906e447/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>"}'
```

### get_lookbook

Get lookbook for a specific season by ID. Returns looks with images and linked products. Each look contains one or more editorial images and references to the products shown.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lookbook_id` | string | No | Lookbook ID (e.g. '45' for Spring/Summer 2026, '44' for Fall/Winter 2025, '43' for Spring/Summer 2025) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-supreme-com-api-7906e447/get_lookbook \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"lookbook_id":"<string>"}'
```

### get_lookbook_list

Get list of available lookbooks with their IDs and titles. Includes both the current season lookbook from site configuration and known historical lookbooks.

**Estimated cost:** Metered

_No parameters required._

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

### get_news_article

Get full content of a news article by ID or slug. Searches the news list for a matching article. Returns the article with structured body blocks, images, and publication datetime.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_id` | string | Yes | Article _id (UUID) or slug (numeric string like '1025'). Obtain from get_news_list results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-supreme-com-api-7906e447/get_news_article \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"article_id":"<string>"}'
```

### get_news_list

Get latest news articles with full content including body text and images. Returns all available news articles sorted by publication date descending.

**Estimated cost:** Metered

_No parameters required._

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

### get_product_detail

Get full details for a specific product by handle (product ID or slug). Searches within the specified season's preview data. Returns stale_input if the product is not found in the given season. The detail view includes all variant colorways with full image sets.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_handle` | string | Yes | Product slug (e.g. 'reversible-faux-fur-hooded-work-jacket') or _id UUID. Obtain from get_product_listings or get_products_by_category results. |
| `season` | string | No | Season slug (e.g. 'springsummer2026', 'fallwinter2025') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-supreme-com-api-7906e447/get_product_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_handle":"<string>","season":"<string>"}'
```

### get_product_listings

Get all product listings from the current season preview catalog. Returns the full list of products for the default season. Each product includes title, slug, category, variants with color images, and description text.

**Estimated cost:** Metered

_No parameters required._

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

### get_products_by_category

Get products belonging to a specific category slug within a season. Filters the full season catalog to only products matching the given category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug from get_categories results (e.g. 'jackets', 'shirts', 'tops-sweaters', 'sweatshirts', 'pants', 'shorts', 't-shirts', 'hats', 'bags', 'accessories', 'skate') |
| `season` | string | No | Season slug (e.g. 'springsummer2026', 'fallwinter2025') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-supreme-com-api-7906e447/get_products_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>","season":"<string>"}'
```

### get_season_preview

Get full season preview catalog with all products for a given season. Returns every product across all categories for that season. Identical to get_product_listings but accepts an explicit season parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | Season slug (e.g. 'springsummer2026', 'fallwinter2025') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-supreme-com-api-7906e447/get_season_preview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>"}'
```

### get_shop_status

Get current shop status including region info, active season, shop URL, and lookbook links. Returns global configuration drawn from all regional settings.

**Estimated cost:** Metered

_No parameters required._

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

### get_store_detail

Get details for a specific store by slug. Returns address, hours, phone, and location coordinates. Searches the stores list for a matching slug.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `store_slug` | string | Yes | Store slug identifier. Valid values: 'new-york', 'brooklyn', 'san-francisco', 'los-angeles', 'london', 'paris', 'milan', 'tokyo-harajuku', 'tokyo-shibuya', 'tokyo-daikanyama', 'nagoya', 'osaka', 'fukuoka', 'shanghai', 'beijing' |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-supreme-com-api-7906e447/get_store_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store_slug":"<string>"}'
```

### get_stores

Get list of all Supreme retail stores worldwide with addresses, hours, and locations. Returns complete store data including coordinates for mapping.

**Estimated cost:** Metered

_No parameters required._

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