# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/supremenewyork/`
**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 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/credits/supremenewyork/get-lookbook \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/supremenewyork/get-news-article \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/supremenewyork/get-news-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/supremenewyork/get-season-preview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/supremenewyork/get-shop-status \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/supremenewyork/get-stores \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## Next steps

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