# Kixify — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/filter_listings_by_condition \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_brands_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_category_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_filter_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_homepage_featured \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_other_sellers_for_model \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_product_listing_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_seller_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_size_price_matrix \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/get_sneaker_model_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-kixify-com-api-9d70a838/search_listings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"gender":"<string>","keyword":"<string>","page":"<integer>","shipping":"<string>","size":"<string>","sort":"<string>"}'
```