# Scuffers — 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 data from scuffers.com.

**Category:** E-commerce | **Website:** [scuffers.com/](https://scuffers.com/) | **Docs:** [parse.bot/marketplace/8e269c97-9d9f-4725-af74-1b6ad137bd21/scuffers-com-api](https://parse.bot/marketplace/8e269c97-9d9f-4725-af74-1b6ad137bd21/scuffers-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-scuffers-com-api-8e269c97/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_categories

Retrieve the complete list of product collections/categories. Returns all non-geosort collections available on the store. Makes multiple paginated requests to enumerate the full set (typically ~239 collections). Each collection can be used as category_id in get_category_products.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scuffers-com-api-8e269c97/get_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_category_products

Get paginated products from a specific collection/category. Returns up to 30 products per page. Use the collection handle as category_id (available from get_categories results). An unknown handle returns an empty products array (upstream behavior).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_id` | string | Yes | Collection handle identifying the category (e.g. 'accessories', 'new', 'all-sales', 'footwear'). Obtained from get_categories endpoint's handle field. |
| `page` | integer | No | Page number for pagination. Each page returns up to 30 products. |

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

### get_new_arrivals

Get the latest new arrival products. Returns up to 30 products per page from the store's 'New Arrivals' collection, ordered by recency.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Each page returns up to 30 products. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scuffers-com-api-8e269c97/get_new_arrivals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_product

Get full product details by handle or URL. Returns complete information including description, all variant sizes/colors/SKUs, pricing, all images, and product options. Accepts either a product handle (e.g. 'japan-shirt') or full product URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | Product handle (e.g. 'japan-shirt') or full product URL (e.g. 'https://scuffers.com/products/japan-shirt'). Available from search_products, get_category_products, get_new_arrivals, or get_sale_items results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scuffers-com-api-8e269c97/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_sale_items

Get discounted/sale products. Returns up to 30 products per page from the 'All Sales' collection. Each product includes a computed discount_percent showing the percentage off from the original compare_at_price.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Each page returns up to 30 products. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scuffers-com-api-8e269c97/get_sale_items \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### search_products

Search products by keyword with optional category filter. Returns up to 10 matching products per query. Results come from the site's search suggest engine and are ranked by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Optional product type filter to narrow results (e.g. 'Man Shirt Longsleeved'). Matches the product_type field. |
| `page` | integer | No | Page number for pagination (currently limited to 10 results per query by the upstream search suggest API). |
| `query` | string | Yes | Search query text (e.g. 'shirt', 'hoodie', 'sneakers'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scuffers-com-api-8e269c97/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","page":"<integer>","query":"<string>"}'
```