# Sneakers — 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 sneaker products across categories and brands, view detailed product information, and discover current flash sales and trending searches from sneakers.com. Get instant access to sneaker listings, pricing, and real-time sale events to find exactly what you're looking for.

**Category:** E-commerce | **Website:** [sneakers.com/](https://sneakers.com/) | **Docs:** [parse.bot/marketplace/3ca0313e-19b2-4b2d-b1e2-3ad8aa2cde6d/sneakers-com-api](https://parse.bot/marketplace/3ca0313e-19b2-4b2d-b1e2-3ad8aa2cde6d/sneakers-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-sneakers-com-api-3ca0313e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_flash_sale_sneakers

Retrieve the currently active flash sale deal group. Returns deal metadata (title, start/end times, status) and inventory items with discounted pricing. The sale may have zero items if between deal windows.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sneakers-com-api-3ca0313e/get_flash_sale_sneakers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_product_details

Retrieve full details for a single sneaker product by its slug. Returns comprehensive product information including pricing per size (buy bar), offer data, images, materials, colorway, SKU, and release date. The slug is available from any listing endpoint's items[*].slug field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Product slug from search or listing results (e.g. 'air-jordan-1-mid-legend-blue-fz2142-114'). Available in search_sneakers, get_sneakers_by_category, or get_sneakers_by_brand results items[*].slug. |

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

### get_sneakers_by_brand

Retrieve sneaker listings for a specific brand. Returns paginated product summaries with available color filters and total result count. Brand slugs are lowercase hyphenated names.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand slug (e.g. 'nike', 'adidas', 'air-jordan', 'new-balance', 'asics', 'puma', 'reebok'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sneakers-com-api-3ca0313e/get_sneakers_by_brand \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>"}'
```

### get_sneakers_by_category

Retrieve sneaker listings filtered by activity category. Returns paginated product summaries for the given category with available brand and color filters. Categories correspond to activity types on the site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Category slug. Accepted values: 'running', 'basketball', 'casual', 'hiking', 'boot', 'training'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sneakers-com-api-3ca0313e/get_sneakers_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>"}'
```

### get_trending_searches

Retrieve currently trending search terms on sneakers.com. Returns a list of popular search queries that reflect current user interest.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sneakers-com-api-3ca0313e/get_trending_searches \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_sneakers

Full-text search over all sneaker listings by keyword. Returns paginated product summaries with available brand and color filters plus total result count. The query is matched against product titles and attributes. Each item includes pricing, stock status, and a slug for drill-down via get_product_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum results per page. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | Yes | Search keyword (e.g. 'jordan', 'nike dunk', 'yeezy'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-sneakers-com-api-3ca0313e/search_sneakers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","page":"<integer>","query":"<string>"}'
```