# Kixify — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 compare sneaker listings across Kixify.com to find the best prices, condition ratings, and seller options for specific models and sizes. Filter by brand, condition, and availability to view detailed product information, seller profiles, and complete size-price matrices all in one place.

**Category:** Marketplaces | **Website:** [kixify.com/](https://kixify.com/) | **Docs:** [parse.bot/marketplace/9d70a838-0d70-40c6-ba1d-d630ee052d8f/kixify-com-api](https://parse.bot/marketplace/9d70a838-0d70-40c6-ba1d-d630ee052d8f/kixify-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/`
**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

### Filter listings by condition

Search and filter sneaker listings by condition (Brand New or Pre-Owned). Optionally filter by keyword.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `condition` | string | No | Condition filter: 'Brand New' or 'Pre-Owned'. |
| `keyword` | string | No | Search keyword to combine with condition filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/filter-listings-by-condition \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"condition":"<string>","keyword":"<string>"}'
```

### Get brands list

Get the full list of available brands and their sub-categories from the Kixify navigation.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-brands-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get category listings

Get all listings for a specific brand or sub-category. Returns paginated results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | Yes | Brand slug (e.g. 'air-jordan', 'nike', 'new-balance'). Use get_brands_list to discover valid slugs. |
| `page` | integer | No | Page number (0-indexed). |
| `subcategory` | string | No | Sub-category slug (e.g. 'air-jordan-11', 'nike-sb'). Use get_brands_list to discover valid slugs. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-category-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","page":"<integer>","subcategory":"<string>"}'
```

### Get filter options

Get available filter options for the Kixify marketplace search including sort orders, gender categories, shoe sizes, and shipping regions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-filter-options \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get homepage featured

Get the top featured sneaker releases from the Kixify marketplace homepage. Returns the first page of popular releases with pricing and availability.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-homepage-featured \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get other sellers for model

Get other sellers offering a specific sneaker model by style code. Returns a list of sellers with their prices and listing URLs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `style_code` | string | Yes | Style code / SKU of the sneaker model (e.g. 'CT8012-047'). Found in product listing details. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-other-sellers-for-model \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"style_code":"<string>"}'
```

### Get product listing detail

Get full details for a specific individual product listing from a single seller, including condition, style code, colorway, seller info, and tags.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `listing_slug` | string | Yes | Product listing slug (e.g. 'air-jordan-11-gamma-1'). Found in listing URLs from search or category results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-product-listing-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"listing_slug":"<string>"}'
```

### Get seller profile

Get a seller's public profile including verification status, join date, sales stats, feedback score, and their active product listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `username` | string | Yes | Seller username (e.g. 'sole_city'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-seller-profile \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"username":"<string>"}'
```

### Get size price matrix

Get the size-to-price mapping for a sneaker model. Returns prices for the default server-rendered size category along with the list of available categories (e.g. Men, Youth, Women).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sneaker_slug` | string | Yes | Sneaker model slug (e.g. 'air-jordan-11-gamma'). Found in listing slugs from search or homepage results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-size-price-matrix \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"sneaker_slug":"<string>"}'
```

### Get sneaker model detail

Get detailed information for a sneaker model including brand, colorway, style code, image gallery, and the available size-price grid. The size matrix shows prices for the server-side rendered tab (typically Youth or Men).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sneaker_slug` | string | Yes | Sneaker model slug (e.g. 'air-jordan-11-gamma', 'air-jordan-4-black-cat-2025'). Found in listing slugs from search or homepage results. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/get-sneaker-model-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"sneaker_slug":"<string>"}'
```

### Search listings

Search sneaker releases by keyword. Returns paginated results from the Kixify catalog with lowest prices, release dates, and availability info. Supports filtering by size, gender, and shipping region. Results are ordered by the chosen sort method.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `gender` | string | No | Gender filter. |
| `keyword` | string | Yes | Search keyword (e.g. 'jordan', 'nike dunk', 'yeezy'). |
| `page` | integer | No | Page number (1-indexed). |
| `shipping` | string | No | Shipping region filter. |
| `size` | string | No | Shoe size filter (e.g. '10', '8.5'). |
| `sort` | string | No | Sort order. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/kixify/search-listings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"gender":"<string>","keyword":"<string>","page":"<integer>","shipping":"<string>","size":"<string>","sort":"<string>"}'
```

## Next steps

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