# Supremenewyork — 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 Supreme product previews, news articles, lookbooks, store locations, and live shop status. Retrieve seasonal collections with variant and inventory details, browse editorial content, and check webstore availability in real time.

**Category:** E-commerce | **Website:** [supremenewyork.com/](https://supremenewyork.com/) | **Docs:** [parse.bot/marketplace/350c539d-ebe4-487c-a337-eb63df19fd88/supremenewyork-com-api](https://parse.bot/marketplace/350c539d-ebe4-487c-a337-eb63df19fd88/supremenewyork-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-supremenewyork-com-api-350c539d/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_lookbook

Fetch lookbook images and associated product links for a given lookbook. Each look contains one or more high-resolution images and links to featured products.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lookbook_id` | string | No | Lookbook ID, a sequential integer identifier (e.g. '43', '44', '45'). |

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

### get_news_article

Fetch full details of a specific news article including body content (Sanity portable text blocks) and images. The slug identifier is obtained from get_news_list results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Article slug identifier obtained from get_news_list (e.g. '1025', '1020'). |

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

### get_news_list

Fetch all news articles from Supreme. Returns the full list of article summaries in reverse chronological order. Each article carries its slug for drill-down via get_news_article.

**Estimated cost:** Metered

_No parameters required._

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

### get_season_preview

Fetch products from a season preview collection. Returns product details including variants, images, and descriptions. Products are grouped by category; use the category filter to narrow results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Preview category filter. Accepted values: 'all', 'jackets', 'shirts', 'tops-sweaters', 'pants', 'shorts', 'sweatshirts', 'hats', 'bags', 'accessories', 'skate'. |
| `season` | string | No | Season slug identifier (e.g. 'springsummer2026', 'fallwinter2025'). |

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

### get_shop_status

Check if the Supreme webstore is currently open or closed, and retrieve any announcement text. Returns the final redirect URL which indicates the regional store.

**Estimated cost:** Metered

_No parameters required._

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

### get_stores

Fetch global Supreme store locations with addresses, phone numbers, opening hours, map links, and geographic coordinates.

**Estimated cost:** Metered

_No parameters required._

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